نموذج تواصل لـ v0

Formgong team ·

الصق هذا في v0. الطلبات تذهب إلى Formgong. بلا قاعدة بيانات وبلا Resend.

250 طلب مجاني في الشهر

كيف تعمل النماذج في v0

v0 كود Next.js App Router باستخدام shadcn/ui و Tailwind. بالنسبة للنماذج، عادةً ما يكتب «إجراء خادم» (Server Action) أو مسار واجهة برمجة تطبيقات (API route) يرسل البريد الإلكتروني عبر مزود مثل Resend. وهذا يتطلب وقت تشغيل خادم ومفتاح واجهة برمجة تطبيقات (API key) في متغيرات بيئة Vercel الخاصة بك، وتقع مسؤولية صيانة الكود على عاتقك.

مع Formgong، يُعد النموذج مكونًا للعميل يستدعي fetch على https://formgong.com/submit. لا يتم تشغيل أي شيء على الخادم الخاص بك من أجل النموذج، لذا فإنه يعمل أيضًا عند تصدير التطبيق كملفات ثابتة.

الإعداد في v0

  1. أنشئ نموذجًا في Formgong وانسخ مفتاح الوصول.
  2. الصق الموجّه أدناه في v0. يمكنك أيضًا إضافة https://formgong.com/llms.txt إلى مصادر المشروع حتى تتعرف الدردشات اللاحقة على الحقول.
  3. تحقق من النتيجة: يبدأ المكون بـ "use client"، ويتم النشر إلى Formgong، ولا يوجد ملف جديد تحت app/api ولا يوجد إجراء خادم (Server Action) للنموذج.
  4. إذا كنت تستخدم نموذج shadcn مع react-hook-form، فاحتفظ به: ضع استدعاء fetch في معالج onSubmit.
  5. قم بالنشر على Vercel، وأرسل اختبارًا، وقم بربط Telegram في إعدادات النموذج.

دليل خطوة بخطوة في الوثائق

v0
أضف قسماً للتواصل. لا تستخدم Server Actions ولا Resend.

Formgong: POST https://formgong.com/submit والمفتاح fk_your_access_key.
الحقول name وemail وmessage وفخ botcheck.
fetch مع Content-Type application/json و Accept: application/json.
النجاح: result.success. بلا ملفات.

مكوّن React جاهز على GitHub: github.com/formgong/react-contact-form. ترخيص MIT: انقر على «Use this template» أو انسخ الملفات.

حزمة React: npm install @formgong/react (npm: @formgong/react)

Formgong أم إجراء الخادم؟

اكتب «إجراء الخادم» الخاص بك عندما يتعين على الطلب تغيير بياناتك الخاصة، على سبيل المثال إنشاء سجل في قاعدة البيانات الخاصة بك أو التحقق من مستخدم مسجل الدخول.

استخدم Formgong لنماذج الاتصال وعروض الأسعار والطلبات. يمكنك تجاوز مزود البريد الإلكتروني، وكلمات المرور السرية، ومعالجة الرسائل غير المرغوب فيها، والحصول على خدمة التسليم عبر Telegram وصندوق الوارد.

أسئلة وأجوبة

لماذا لا تدع v0 يكتب «إجراء خادم» يقوم بإعادة التوجيه إلى Formgong؟

سيأتي كل طلب بعد ذلك من عنوان IP الخاص بخادمك، مما يضعف حدود معدل الزيارات لكل زائر وإشارات البريد العشوائي. الإرسال من المتصفح أبسط ويعمل بشكل أفضل.

هل يعمل مع التصدير الثابت؟

نعم. لا يدعم التصدير الثابت في Next.js «إجراءات الخادم» (Server Actions)، لكن المكون الخاص بالعميل الذي يقوم بالإرسال إلى Formgong لا يحتاج إلى خادم.

أين يجب وضع مفتاح الوصول؟

مباشرةً في المكون أو في متغير بيئة NEXT_PUBLIC_. المفتاح عام، لذا لا ينتمي إلى سر مخصص للخادم فقط.

ابدأ مجانًا