نموذج اتصال Jekyll على GitHub Pages

Formgong team ·

نموذج اتصال Jekyll على GitHub Pages هو HTML عادي. يفعّل GitHub الوضع الآمن، لذلك لا تُبنى إضافة غير مدعومة. ضع النموذج في تضمين Liquid وأرسله إلى Formgong. تصل الطلبات بالبريد وفي Telegram ويبقى الموقع ثابتًا. لا تحتاج إلى إضافة. ادفع HTML فقط.

Jekyll
<form action="https://formgong.com/submit" method="POST">
  <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" placeholder="اسمك" required></label>
  <label>البريد الإلكتروني <input type="email" name="email" autocomplete="email" placeholder="you@example.com" required></label>
  <label>الرسالة <textarea name="message" placeholder="كيف يمكننا مساعدتك؟" 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>
  
  <button type="submit">إرسال</button>
</form>

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

يبني Jekyll Markdown وHTML في موقع ثابت. GitHub Pages هو الاستضافة المعتادة ويشغّل Jekyll عنك. لا يوجد خادم ينتظر POST النموذج.

يثبّت GitHub Pages القيمة safe: true في إعداد Jekyll. لا تعمل gem غير مدعومة أبدًا. نموذج في _includes/contact-form.html يكفي، لأن المتصفح يرسل HTML.

الإعداد في Jekyll

  1. أنشئ نموذجًا في Formgong وانسخ مفتاح الوصول.
  2. أضف التضمين. وجّه action إلى https://formgong.com/submit وضع access_key و_lang وbotcheck.
  3. في صفحة الاتصال أضف front matter و{% include contact-form.html %}. لموقع مشروع اجعل _redirect يساوي {{ site.url }}{{ site.baseurl }}/thanks/.
  4. لا تضف gem للنماذج. يبقي GitHub Pages على safe: true ولن يبني إضافة غير مدعومة.
  5. ادفع المستودع. يضبط GitHub قيمة JEKYLL_ENV على production. أرسل تجربة على عنوان github.io المنشور.

Formgong أم إضافة Jekyll؟

إضافة محلية تفيد إذا بنيت الموقع بنفسك واحتجت Ruby وقت البناء.

على GitHub Pages لا تعمل الإضافات غير المدعومة. HTML المرسل إلى Formgong يعمل بعد الدفع.

أسئلة وأجوبة

هل يعمل هذا على GitHub Pages؟

نعم. النموذج HTML. على GitHub Pages أن يقدّم الملف فقط. لا تلزم gem خاصة.

هل أبقي المفتاح في الإعداد؟

نعم. ضعه في _config.yml واطبعه في التضمين. المفتاح عام. لا تخزن هناك كلمة سر البريد.

لماذا يخطئ رابط الشكر في موقع المشروع؟

مواقع المشروع تعيش تحت مسار فرعي. ابن _redirect باستخدام site.baseurl وإلا فتح المتصفح صفحة ناقصة.

هل أحتاج gem المسماة github-pages على جهازي؟

فقط إذا أردت مجموعة الإضافات نفسها محليًا. النموذج نفسه لا يحتاجها. ادفع HTML وجرب العنوان المنشور.

ابدأ مجانًا