Przejdź do treści
Wszystkie artykuły

Integracje

Formularz HTML bez własnego backendu: jak zacząć z ZoraForms

Podłącz istniejący formularz HTML do ZoraForms i zachowaj własny wygląd strony.

Prosty formularz kontaktowy nie musi oznaczać budowy endpointu, walidacji serwera i osobnej skrzynki na zgłoszenia. ZoraForms odbiera POST z Twojej strony, zapisuje zgłoszenie w panelu i pozwala później dodać ochronę oraz integracje. Własny HTML i CSS pozostają po Twojej stronie.

Kiedy wystarczy atrybut action

Utwórz witrynę i formularz w panelu, a następnie w zakładce Integracja skopiuj publiczny adres formularza. Wstaw go jako action w istniejącym elemencie form i ustaw metodę POST. Każde pole, które ma znaleźć się w zgłoszeniu, potrzebuje nazwy name. To wygodne rozwiązanie dla statycznej strony, landing page'a lub prostego formularza osadzonego w CMS.

Zastąp w przykładzie TWOJ_PUBLIC_ID identyfikatorem z panelu. Nie używaj przykładowego adresu produkcyjnie i nie umieszczaj w HTML żadnego sekretu. Publiczny ID określa cel wysyłki; konfiguracja formularza, limity i dostępność są nadal sprawdzane przez usługę.

Podstawowa integracja HTML
<form action="https://forms.example.com/f/TWOJ_PUBLIC_ID" method="POST">
  <label>E-mail <input name="email" type="email" required /></label>
  <label>Wiadomość <textarea name="message" required></textarea></label>
  <button type="submit">Wyślij</button>
</form>

Dopasuj formularz do strony

W ustawieniach formularza dodaj dozwolony origin, z którego użytkownik wysyła dane. Origin zawiera protokół i host, na przykład https://example.com. Wariant z www to inny host niż wersja bez www. Dzięki temu przed publikacją łatwiej wykryć sytuację, w której kod trafił na niewłaściwą stronę.

Zrób jedno rzeczywiste zgłoszenie po wdrożeniu i sprawdź je w sekcji Zgłoszenia. Nazwy pól są widoczne w szczegółach, więc warto używać nazw takich jak email, message lub company, zamiast nieczytelnych skrótów. Jeśli potrzebujesz własnego komunikatu po wysłaniu albo interfejsu bez przeładowania strony, wybierz wygenerowany wariant fetch z zakładki Integracja.

  • Dodaj witrynę z właściwą domeną.
  • Utwórz formularz i skopiuj kod dla jego aktualnych ustawień.
  • Wpisz origin strony, na której formularz działa.
  • Wyślij test i sprawdź zapis w panelu.

Ochrona i limity nie są dodatkiem do action

Sam action wystarcza tylko dla konfiguracji bez CAPTCHA i bez minimalnego czasu wypełnienia. Gdy włączysz CAPTCHA, honeypot albo ograniczenie czasu, pobierz ponownie pełny kod z panelu. Zawiera pola i tokeny wymagane przez wybraną konfigurację. CAPTCHA jest opcjonalna dla każdego formularza, a jej weryfikacja odbywa się po stronie serwera; jest narzędziem ograniczającym automatyczne wysyłki, nie obietnicą całkowitego wyeliminowania spamu.

Plan Free pozwala uruchomić jedną witrynę i jeden formularz oraz przyjąć do 100 zgłoszeń miesięcznie. Przed przyjęciem zgłoszeń trzeba potwierdzić kontrolę nad publiczną domeną rekordem DNS TXT. Ten dowód nie jest wymagany przez płatne plany. W panelu widać bieżące użycie, dlatego warto zajrzeć tam przed kampanią o większym ruchu.

Gdy formularz jest już podłączony, możesz rozszerzać go bez wymiany backendu: włączyć dobrowolną CAPTCHA, dodać UTM lub skonfigurować webhook. Zacznij od działającego POST, a każdą zmianę ustawień potwierdź świeżym kodem integracji i krótkim testem na stronie.

Formularz HTML bez własnego backendu: jak zacząć z ZoraForms · ZoraForms Blog