Formularz kontaktowy dla Astro

Formgong team ·

Wklej to do Astro. Zgłoszenia idą do Formgong. Bez bazy i bez Resend.

250 zgłoszeń miesięcznie za darmo

Jak działają formularze w Astro

Astro domyślnie buduje strony statyczne i nie wysyła JavaScriptu, dopóki nie dodasz wyspy. Astro Actions i endpointy API działają na serwerze, więc wymagają adaptera i renderowania na żądanie. Dla formularza kontaktowego na stronie statycznej to dużo konfiguracji.

Zwykły formularz HTML w komponencie .astro wysyła dane na https://formgong.com/submit i nie potrzebuje żadnej z tych rzeczy. Strona zostaje statyczna, formularz działa bez JavaScriptu, a odwiedzający trafia na stronę podziękowania w swoim języku albo na Twoją stronę z _redirect.

Konfiguracja w Astro

  1. Utwórz formularz w Formgong i skopiuj klucz dostępu.
  2. Wklej poniższy kod do komponentu .astro, podmień klucz i ustaw _lang zgodnie z językiem strony.
  3. Dodaj ukryte pole _redirect wskazujące na stronę podziękowania w Twojej witrynie, jeśli taką masz.
  4. Zbuduj projekt jak zwykle; output: 'static' jest w porządku. Wdróż i wyślij test z działającej strony.
  5. Opcjonalnie: umieść formularz w wyspie z komponentem frameworka, jeśli odpowiedź ma się pojawić bez opuszczania strony.
Astro
<form action="https://formgong.com/submit" method="POST">
  <input type="hidden" name="access_key" value="fk_your_access_key">
  <input type="hidden" name="_lang" value="pl">
  <label>Imię <input type="text" name="name" autocomplete="name" placeholder="Twoje imię" required></label>
  <label>E-mail <input type="email" name="email" autocomplete="email" placeholder="ty@example.com" required></label>
  <label>Wiadomość <textarea name="message" placeholder="W czym możemy pomóc?" required></textarea></label>
  <div aria-hidden="true" style="position:absolute;inset-inline-start:0;top:0;width:1px;height:1px;overflow:hidden;clip-path:inset(50%)">
  <label>Pozostaw to pole puste<input type="text" name="botcheck" tabindex="-1" autocomplete="off"></label>
</div>
  
  <button type="submit">Wyślij</button>
</form>

Gotowy starter na GitHubie: github.com/formgong/astro-starter. Licencja MIT: kliknij „Use this template” albo skopiuj pliki.

Nowy projekt jedną komendą: npm create formgong@latest -- --template astro (npm: create-formgong)

Pakiet z komponentem: npm install @formgong/astro (npm: @formgong/astro)

Dodaj do istniejącego projektu: npx formgong init (npm: formgong)

Formgong czy Astro Actions?

Astro Actions pasują, gdy strona już działa z adapterem serwerowym, a zgłoszenie musi trafić do Twojego kodu.

Na stronach statycznych i przy prostych formularzach kontaktowych lub leadowych wysyłka do Formgong zachowuje statyczny build i usuwa kod serwera.

Pytania i odpowiedzi

Czy potrzebuję adaptera?

Nie. Formularz wysyła dane do Formgong, więc wystarczy statyczny build.

Czy mogę pokazać wynik bez opuszczania strony?

Tak. Użyj małej wyspy z fetch albo opcjonalnego skryptu Formgong fg.js.

Czy jest gotowy projekt?

Tak. Starter Astro na GitHubie to działająca strona z tym formularzem, na licencji MIT.

Zacznij za darmo