Next.js iletişim formu

Formgong team ·

Bunu Next.js içine yapıştırın. Başvurular Formgong’a gider. Veritabanı yok, Resend yok.

250 aylık ücretsiz başvuru

Next.js ile formlar nasıl çalışır

App Router'da bir formu işlemenin yerleşik yolu, genellikle gizli anahtarla bir e-posta API'sini çağıran bir Server Action veya route handler'dır. Bu bir sunucu ortamı gerektirir ve siteyi output: 'export' ile dışa aktardığınızda Server Actions desteklenmez.

https://formgong.com/submit adresine gönderen bir client component bunların hiçbirine ihtiyaç duymaz. Vercel'de, herhangi bir Node hosting'inde ve statik export olarak çalışır; her başvuru e-postaya ve Telegram'a gider, bir kopyası da Formgong gelen kutusunda kalır.

Next.js ile kurulum

  1. Formgong'da bir form oluşturun ve erişim anahtarını kopyalayın.
  2. Aşağıdaki bileşeni ekleyin. Bir tarayıcı olayını işlediği için "use client" ile başlar.
  3. Anahtarı değiştirin ya da NEXT_PUBLIC_ önekli bir değişkenden okuyun; tarayıcı koduna yalnızca bunlar ulaşır.
  4. Bileşeni sayfanızda render edin, next dev çalıştırın ve bir deneme gönderin.
  5. Paket mi tercih edersiniz? @formgong/react hazır bir <ContactForm> sunar; GitHub'daki Next.js starter ise eksiksiz bir projedir.
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: "tr", ...fields, access_key: "fk_your_access_key" }),
    });
    const result = await response.json();
    setStatus(result.message || (result.success ? "Gönderildi. Teşekkürler!" : "Gönderilemedi. Lütfen tekrar deneyin."));
  }

  return (
    <form onSubmit={onSubmit}>
      <label>Ad <input name="name" placeholder="Adınız" required /></label>
      <label>E-posta <input name="email" type="email" placeholder="siz@ornek.com" required /></label>
      <label>Mesaj <textarea name="message" placeholder="Size nasıl yardımcı olabiliriz?" 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">Gönder</button>
      <p role="status">{status}</p>
    </form>
  );
}

GitHub'da hazır başlangıç şablonu: github.com/formgong/nextjs-starter. MIT lisansı: “Use this template” düğmesine tıklayın veya dosyaları kopyalayın.

Tek komutla yeni proje: npm create formgong@latest -- --template nextjs (npm: create-formgong)

Bileşen paketi: npm install @formgong/next (npm: @formgong/next)

Mevcut projeye ekleyin: npx formgong init (npm: formgong)

Formgong mu, Server Action mı?

Gönderim verilerinizi değiştirecek veya giriş yapmış bir kullanıcıyı kontrol edecekse bir Server Action yazın.

İletişim, teklif ve başvuru formları için Formgong'u kullanın: kod tabanınızda e-posta sağlayıcısı, gizli anahtar ve spam yönetimi olmaz.

Sorular ve yanıtlar

Anahtarı gizlemek için isteği bir Server Action üzerinden geçirebilir miyim?

Geçirebilirsiniz, ama gizlenecek bir şey yok: anahtar herkese açıktır. Proxy ayrıca her gönderimin sunucunuzun IP'sinden gelmesine yol açar; bu da hız sınırlarını ve spam sinyallerini zayıflatır.

Statik export ile çalışır mı?

Evet. Formgong'a gönderen bir client component sunucu gerektirmez; Server Actions ise statik export'ta desteklenmez.

Pages Router mı, App Router mı?

İkisi de. Pages Router'da "use client" satırını kaldırın; gerisi aynıdır.

Resend veya bir Server Action gerekir mi?

İletişim formu için hayır. Resend doğrulanmış bir alan adı ve DNS kayıtları ister. API anahtarı sunucuda kalır. Gönderim veritabanınızı değiştirecek veya oturum açmış kullanıcıyı kontrol edecekse bir Server Action yazın.

Next.js formunda spam nasıl durdurulur?

botcheck alanını boş bırakın. Formgong dolu bir honeypot'u spam sayar ve bunu e-postayla veya Telegram ile göndermez. Turnstile isteğe bağlıdır. Widget'ı yalnızca form ayarlarında açtıktan sonra ekleyin. Gizli anahtar Formgong'da kalır.

Ücretsiz başla