Formularz kontaktowy dla Next.js

Formgong team ·

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

250 zgłoszeń miesięcznie za darmo

Jak działają formularze w Next.js

W App Router natywny sposób obsługi formularza to Server Action albo route handler, zwykle wywołujący API do maili z tajnym kluczem. To wymaga środowiska serwerowego, a Server Actions nie są obsługiwane przy eksporcie strony z output: 'export'.

Komponent kliencki wysyłający dane na https://formgong.com/submit nie potrzebuje niczego z tego. Działa na Vercel, na każdym hostingu Node i jako statyczny eksport, a każdy lead trafia na maila i Telegram z kopią w skrzynce Formgong.

Konfiguracja w Next.js

  1. Utwórz formularz w Formgong i skopiuj klucz dostępu.
  2. Dodaj poniższy komponent. Zaczyna się od "use client", bo obsługuje zdarzenie przeglądarki.
  3. Podmień klucz albo odczytaj go ze zmiennej NEXT_PUBLIC_; tylko takie trafiają do kodu w przeglądarce.
  4. Wyrenderuj komponent na stronie, uruchom next dev i wyślij test.
  5. Wolisz pakiet? @formgong/react daje gotowy <ContactForm>, a starter Next.js na GitHubie to kompletny projekt.
Next.js
"use client";
import { useState } from "react";

export function ContactForm() {
  const [status, setStatus] = useState("");
  async function onSubmit(event) {
    event.preventDefault();
    const fields = Object.fromEntries(new FormData(event.currentTarget));
    const response = await fetch("https://formgong.com/submit", {
      method: "POST",
      headers: { "Content-Type": "application/json", Accept: "application/json" },
      body: JSON.stringify({ _lang: "pl", ...fields, access_key: "fk_your_access_key" }),
    });
    const result = await response.json();
    setStatus(result.message || (result.success ? "Wysłano. Dziękujemy!" : "Nie udało się wysłać. Spróbuj ponownie."));
  }

  return (
    <form onSubmit={onSubmit}>
      <label>Imię <input name="name" placeholder="Twoje imię" required /></label>
      <label>E-mail <input name="email" type="email" placeholder="ty@example.com" required /></label>
      <label>Wiadomość <textarea name="message" placeholder="W czym możemy pomóc?" required /></label>
      <div aria-hidden="true" style={{ position: "absolute", insetInlineStart: 0, top: 0, width: 1, height: 1, overflow: "hidden", clipPath: "inset(50%)" }}>
        <input name="botcheck" tabIndex={-1} autoComplete="off" />
      </div>
      <button type="submit">Wyślij</button>
      <p role="status">{status}</p>
    </form>
  );
}

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

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

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

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

Formgong czy Server Action?

Napisz Server Action, gdy zgłoszenie ma zmienić Twoje dane albo sprawdzić zalogowanego użytkownika.

Wybierz Formgong dla formularzy kontaktowych, wycen i leadów: bez dostawcy maili, sekretów i obsługi spamu w kodzie.

Pytania i odpowiedzi

Czy mogę przepuścić żądanie przez Server Action, żeby ukryć klucz?

Możesz, ale nie ma czego ukrywać: klucz jest publiczny. Proxy sprawia też, że każde zgłoszenie przychodzi z IP Twojego serwera, co osłabia limity i sygnały antyspamowe.

Czy to działa ze statycznym eksportem?

Tak. Komponent kliencki wysyłający dane do Formgong nie potrzebuje serwera, a Server Actions w statycznym eksporcie nie są obsługiwane.

Pages Router czy App Router?

Oba. W Pages Router usuń linię "use client"; reszta jest taka sama.

Czy potrzebuję Resend albo Server Action?

Nie, do formularza kontaktowego. Resend wymaga zweryfikowanej domeny i rekordów DNS, a klucz API zostaje na serwerze. Server Action pisz, gdy zgłoszenie ma zmienić Twoją bazę albo sprawdzić zalogowaną osobę.

Jak zatrzymać spam w formularzu Next.js?

Zostaw pole botcheck puste. Formgong oznacza wypełniony honeypot jako spam i nie wysyła go mailem ani na Telegram. Turnstile jest opcjonalny. Widżet dodaj dopiero po włączeniu go w ustawieniach formularza. Sekret zostaje w Formgong.

Zacznij za darmo