أمر Lovable وBolt
الصقوا هذا الأمر في Lovable أو Bolt. يطلب نموذج تواصل يرسل إلى Formgong ويقول للأداة ألا تضيف قاعدة بيانات أو خدمة بريد.
ما الذي تنسخونه
هذا القالب موجّه لـ Lovable أو Bolt. تلصقونه في دردشة أداة البناء. وتكتب أداة البناء النموذج. ويتلقى Formgong الإرسال.
يسمي الموجّه نقطة النهاية، ومفتاح الوصول العام، و_lang، والمصيدة، وفحص النجاح. ويطلب من أداة البناء ألا تضيف جهة خلفية.
ويقول أيضًا ألا تُضاف Resend، ولا قاعدة بيانات، ولا edge function، ولا server action لهذا النموذج. وهذه تحويلات شائعة في التطبيقات المولَّدة.
الكتلة الإضافية هي HTML عادي يطابق الموجّه. استخدموها إذا فضلتم لصق الترميز على أن تطلبوا من أداة البناء كتابته.
توجد أصلًا أدلة أطول خاصة بـ Lovable وخاصة بـ Bolt. وهذه الصفحة هي الموجّه القصير. وتلك الصفحات تشرح النقرات حوله.
ما يُراجع في الفرق
ينبغي أن يرسل النموذج إلى /submit على أصل Formgong. وإذا رأيتم جدولًا جديدًا أو سرًا أو حزمة تطوير للبريد، فاطلبوا من أداة البناء إزالتها.
مفتاح الوصول في الموجّه هو fk_your_access_key إلى أن تنشئوا نموذجًا. استبدلوه، أو استخدموا الزر في هذه الصفحة وأنتم داخلون.
ينبغي أن تبقى أسماء الحقول name وemail وmessage، مع phone اختياريًا. ويطبع Telegram هذه الأسماء. والحقل المعاد تسميته أصعب في المسح.
يجب أن يكون botcheck موجودًا وفارغًا ومخفيًا. وإذا حذفته أداة البناء بوصفه غير مستخدم، فأعيدوه. إنه المصيدة.
ينبغي أن يرسل fetch الترويسة Accept: application/json. ويحتاج جسم JSON أيضًا إلى Content-Type: application/json. ولا ينبغي أن يضبط FormData هذه الترويسة.
يقول الموجّه بتخطي Turnstile ما لم تقدّموا مفتاح موقع. ولا تدعوا أداة البناء تخترع مفتاحًا.
يقول الموجّه بعدم تحميل خط من طرف ثالث للنموذج. وإذا كان للتطبيق خط أصلًا، فيمكن للنموذج أن يرثه.
بعد أن تنتهي أداة البناء
انشروا، أو استخدموا معاينة أداة البناء إذا كانت تصل إلى الإنترنت، وأرسلوا اختبارًا. ثم افتحوا صندوق وارد Formgong.
اربطوا Telegram في إعدادات النموذج للتسليم الفوري. وفي الخطة المجانية يكون البريد ملخصًا يوميًا.
تحتفظ الخطة المجانية بـ 300 طلب في الشهر مدة 30 يومًا، في الاتحاد الأوروبي. وتُخزَّن الرسائل غير المرغوب فيها ولا تُسلَّم، ولا تُحتسب.
تعيش الإعدادات مثل المستلمين وTelegram داخل Formgong. ويمكنكم تغييرها من دون أن تطلبوا من أداة البناء إعادة توليد النموذج.
Formgong هو المشغّل. وإذا أساء المنتج السلوك، فاكتبوا إلى support@formgong.com. وحساب أداة البناء مسار دعم منفصل.
معاينة
شيفرة النموذج
أضف نموذج تواصل إلى هذا المشروع. الطلبات تذهب إلى Formgong. لا تضف قاعدة بيانات ولا edge function ولا server action ولا خدمة بريد مثل Resend.
المواصفات:
- النموذج العادي يمكن أن يستخدم action="https://formgong.com/submit" و method="POST". مع JavaScript أرسل الحقول نفسها إلى https://formgong.com/submit عبر fetch.
- حقل مخفي name="access_key" value="fk_your_access_key". المفتاح عام. أبقه في الواجهة. لا تنقله إلى سر.
- حقل مخفي name="_lang" value="{lang}". يستخدمه Formgong لصفحة الشكر ونص الخطأ. في موقع متعدد اللغات ضع لغة الصفحة.
- الحقول: name و email مع type="email" و message. الثلاثة مطلوبة. phone اختياري. أبقِ هذه الأسماء. يطبع تيليغرام كل اسم بخط عريض فوق الإجابة.
- Honeypot: حقل type="text" name="botcheck" tabindex="-1" autocomplete="off" داخل غلاف فيه aria-hidden="true". أخفه بـ CSS: position:absolute; inset-inline-start:0; top:0; width:1px; height:1px; overflow:hidden; clip-path:inset(50%). لا تملأه.
- نجاح fetch: ترويسة Accept: application/json. لجسم JSON أرسل أيضًا Content-Type: application/json. لـ FormData لا تضع Content-Type. إذا كان success في JSON يساوي true فاعرض شكرًا قصيرًا وأفرغ النموذج. وإلا فاعرض رسالة الاستجابة.
- Turnstile فقط إذا وُجد مفتاح موقع: script src="https://challenges.cloudflare.com/turnstile/v0/api.js" و div فيه class="cf-turnstile" و data-sitekey. وإلا فلا تضفه.
- لا تحمّل خطًا من طرف ثالث. لا تضف رفع ملفات.
- أصل نقطة الإرسال هو https://formgong.com.HTML البسيط الذي يطلبه الأمر
<form action="https://formgong.com/submit" method="POST" style="position:relative"> <input type="hidden" name="access_key" value="fk_your_access_key"> <input type="hidden" name="_lang" value="ar"> <label>الاسم <input type="text" name="name" autocomplete="name" required></label> <label>البريد الإلكتروني <input type="email" name="email" autocomplete="email" required></label> <label>الهاتف <input type="tel" name="phone" autocomplete="tel"></label> <label>الرسالة <textarea name="message" 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>اترك هذا الحقل فارغًا <input type="text" name="botcheck" tabindex="-1" autocomplete="off"></label> </div> <!-- اختياري. فعّلوا Turnstile لهذا النموذج، ثم أزيلوا علامات التعليق والصقوا مفتاح الموقع. <script src="https://challenges.cloudflare.com/turnstile/v0/api.js" async defer></script> <div class="cf-turnstile" data-sitekey="YOUR_TURNSTILE_SITE_KEY" data-language="ar"></div> --> <button type="submit">إرسال</button> </form>
أسئلة وأجوبة
هل يعمل هذا الموجّه في Lovable وفي Bolt؟
نعم. هو لا يعتمد على تخطيط ملفات واحد. وإذا اختارت أداة البناء React أو Vue أو HTML عاديًا، فستبقى نقطة النهاية والحقول نفسها.
أضافت أداة البناء Supabase أو Resend. ماذا بعد؟
اطلبوا منها حذف تلك الشيفرة والإبقاء على الإرسال إلى Formgong فقط. وتصف أدلة Lovable وBolt المرتبطة التصحيح نفسه بمزيد من التفصيل.
هل مفتاح الوصول آمن داخل الموجّه؟
هو مفتاح عام. ويمكن لأي شخص إرسال طلب به. ولا يمكنهم به قراءة صندوق الوارد ولا تغيير وجهة البريد.
أين الأدلة الأطول؟
في صفحتي Lovable وBolt ضمن قسم «لـ»، والرابط إليهما من هذه الصفحة. وهذا القالب هو الموجّه نفسه، وليس بديلًا عن تلك الأدلة.