ما الذي ينقص النموذج الثابت؟
تعرض HTML الحقول، لكنها وحدها لا تحفظ الرسائل أو ترسل البريد. يتولى Formgong هذه المهمة، بينما يبقى موقع الأعمال أو صفحة الخدمة على استضافة ثابتة.
إذا كان لديك خادم ومنطق خاص بالفعل، يمكنك استخدامهما. المثال هنا يوفر تشغيل خادم لمجرد استقبال رسائل نصية.
استخرج المفتاح الصحيح أولاً
أنشئ نموذجاً في Formgong، وأكد بريدك، وانسخ المفتاح من قسم ربط الموقع. استبدل fk_your_access_key به. يمكن وضع المفتاح العام في HTML؛ أما التنبيهات فقد تنتظر تأكيد البريد.
أضف النموذج إلى الصفحة
ضع المثال في قسم التواصل، ثم أضف أصناف CSS الخاصة بموقعك. يمكنك تغيير تسميات الحقول مع الحفاظ على أسمائها التقنية. هذا المثال يرسل نصوصاً ولا يتضمن رفع الملفات.
<form action="https://formgong.com/submit" method="POST"> <input type="hidden" name="access_key" value="fk_your_access_key"> <label>Name <input type="text" name="name" required></label> <label>Email <input type="email" name="email" required></label> <label>Message <textarea name="message" required></textarea></label> <div aria-hidden="true" style="position:absolute;left:-10000px;top:auto;width:1px;height:1px;overflow:hidden"> <label>Leave this field empty<input type="text" name="botcheck" tabindex="-1" autocomplete="off"></label> </div> <button type="submit">Send</button> </form>
الخصائص التي تتحكم في الإرسال
تحدد action الوجهة، وتحدد method="POST" طريقة الإرسال، ويحدد name اسم كل قيمة. وجود id وحده لا يكفي. لإضافة الهاتف مثلاً، استخدم name="phone".
حقل botcheck مصيدة للبوتات. اتركه مخفياً وفارغاً؛ ملؤه قد يجعل الرسالة تصنف كبريد مزعج دون إرسال تنبيه.
حدد ما يحدث بعد الإرسال
يفتح النموذج صفحة نتيجة Formgong افتراضياً. لاستخدام صفحة الشكر في موقعك، أدخل عنوان HTTPS الكامل في إعدادات التحويل. يمكن أيضاً إرسال _redirect؛ إذا كانت اللوحة تتجاهل عناوين التحويل من الكود، تكون الأولوية لإعداد اللوحة.
للبقاء في الصفحة نفسها، استخدم fetch مع حالات واضحة للانتظار والنجاح والخطأ. يوجد مثال في دليل التشخيص.
اختبر من النطاق المنشور
أرسل رسالة يمكن تمييزها وابحث عنها في النموذج المناسب وفي البريد، بما فيه مجلد الرسائل غير المرغوب فيها. على الهاتف، راجع الحقول والزر وصفحة الشكر.
يمكن إضافة تنبيهات تليجرام. تعديل المستلمين والتحويلات في Formgong لا يحتاج إلى إعادة نشر HTML.
لا تفعّل حماية دون تحديث النموذج
يتطلب Turnstile المكوّن المناسب وحقل cf-turnstile-response. مصيدة البوتات في المثال لا تحل محله؛ خذ الكود المحدث من لوحة التحكم.
إذا حددت نطاقات مسموحة، أضف نطاق الموقع الفعلي. قد تستخدم معاينة المحرر نطاقاً مختلفاً.
أسئلة شائعة
هل JavaScript ضروري؟
لا للإرسال العادي باستخدام POST. يرسل المتصفح الحقول وينتقل إلى صفحة النتيجة.
هل أحتاج إلى استضافة PHP؟
لا. يعالج Formgong الطلب، ويمكن إبقاء الموقع على استضافة ثابتة.
هل يمكن إضافة حقول؟
نعم، أضف حقولاً نصية لها name. المثال لا يشمل رفع ملفات.
هل المثال جاهز لـ Turnstile؟
يتضمن مصيدة للبوتات فقط. إذا كان Turnstile مفعلاً، أضف المكوّن وإرسال الرمز المطلوبين.
المصادر والتوثيق
مراجع رسمية لهذا الدليل: MDN: sending form data. توثيق Formgong, مكان تخزين البيانات.
اقرأ بصيغة Markdown