ضع نموذجًا على WordPress بالإضافة والرمز المختصر

ضع نموذجًا على WordPress دون لصق الشيفرة في كل صفحة: ارفع الإضافة المجانية ذات الملف الواحد مرة واحدة، ثم ضع الرمز المختصر في كتلة Shortcode ودعه يحتفظ بحقوله.

تُرجم هذا المقال آليًا. اقرأ النص الأصلي بالإنجليزية

A dark plate titled 'One shortcode. Current fields.' showing a WordPress page holding a [formflow] shortcode, an arrow to a FormFlow card, an arrow to a generated component, and a cache loop back.

صدر FormFlow v1.32.0 في 2026-10-04 وأضاف تبويب WordPress إلى «الحصول على الكود». إنه أقصر طريق من نموذج إلى صفحة WordPress: إضافة تُرفع مرة واحدة، ورمز مختصر يُلصق في كل صفحة، ويحتفظ النموذج بحقوله الحالية دون أن يلصق أحد الشيفرة مرة أخرى.

الإصدار مسجَّل في سجل التغييرات. يغطي هذا الدرس الخطوات الثلاث، والسمات التي تهم، والسلوك الذي تحصل عليه عندما يتعذّر الوصول إلى FormFlow.

ما هي الإضافة، وما ليست

التنزيل ملف PHP واحد، محزوم في formflow-wordpress.zip بمدخل واحد هو formflow/formflow.php. يسجّل رمزًا مختصرًا واحدًا، ويجري طلبًا واحدًا إلى FormFlow، ويخزّن الجواب خمس دقائق، ويطبع الشيفرة التي يتلقاها. وهو مجاني في كل الخطط.

هذه هي الإضافة كلها. لا تعيد بناء النموذج ولا تقرّر شيئًا: القبول وفحص البريد المزعج ووضع Strict وTurnstile والتسليم تبقى كلها على خادم FormFlow. إضافة مثبّتة على موقع عميل لا يمكن تعديلها لاحقًا، فإبقاء كل قرار على جانبنا خيار متعمّد.

ارفعها مرة واحدة

افتح النموذج، اضغط «الحصول على الكود» واختر تبويب WordPress.
اضغط «تنزيل إضافة WordPress». يستقبل موقعك formflow-wordpress.zip.
في WordPress، اذهب إلى الإضافات ← أضف جديدًا ← رفع إضافة، اختر الملف وثبّته.
نشّطها. تحتاج الإضافة إلى WordPress 5.8 أو أحدث وPHP 7.4 أو أحدث.

الرمز المختصر في التبويب نفسه. انسخه من الحقل الموجود تحت «نسخ إلى الحافظة»: يطبعه التبويب بالنمط وخيار العرض المباشر المحددين الآن في «الحصول على الكود»، فيطابق ما تلصقه المعاينة التي نظرت إليها للتو.

ضع الرمز المختصر

أضف كتلة Shortcode إلى الصفحة أو المقالة والصق السطر فيها.

[formflow form="FORMFLOW_TOKEN" style="minimal" live="1"]

ثلاث سمات تحمل الموضع.

form هو رمز النموذج. إنه الشيء الوحيد الذي ترسله الإضافة إلى FormFlow، ويُفحص قبل إجراء الطلب.
style هو النمط الذي اخترته في «الحصول على الكود»، مثل minimal أو bootstrap. تسجيله يعني أن تغييرًا لاحقًا في الافتراضي لن يعيد تنسيق صفحة وُضعت بالنمط القديم.
live يشغّل العرض المباشر بالقيمة 1. احذفه فتطبع الإضافة المكوّن المولَّد العادي، وهو الخيار الأفضل عندما لا تريد طلبًا ثانيًا من متصفح الزائر.

ما يحدث عندما يتعذّر الوصول إلى FormFlow

الإضافة طلب وتخزين مؤقت، لذا سلوكها عند الفشل هو الجزء الذي يستحق الفهم قبل الاعتماد عليها.

يُخزَّن الرد الجيد خمس دقائق، فلا تنادي صفحة مزدحمة FormFlow في كل مشاهدة.
تُحفظ آخر نسخة جيدة أيضًا في خيارات الموقع نفسه. وإذا انتهت مهلة الطلب أو جرى تقييده أو أعاد خطأ خادم، تطبع الصفحة تلك النسخة بدلًا منه.
وإذا لم توجد نسخة على الإطلاق، لا يرى الزائر شيئًا، ويرى المحرر المسجّل تنبيهًا قصيرًا يسمّي الرمز ورمز حالة HTTP.
وإذا كان النموذج مفقودًا أو مغلقًا، لا تطبع الإضافة شيئًا للزوار وتخبر المحررين بالسبب. تُحفظ النسخة المخزَّنة بدل محوها، فلا يمحوها جواب خاطئ واحد.

أين تتوقف

لا توجد كتلة Gutenberg. كتلة Shortcode هي المسار المدعوم، وهي تعمل في محرر الكتل.
لا توجد صفحة إعدادات في WordPress، ولا تحديث تلقائي للإضافة، ولا إدراج على wordpress.org. أنت ترفع الملف وتحدّثه بنفسك.
لا يكتب WordPress في FormFlow أبدًا. وضع نموذج لا يضيف الموقع إلى قائمة السماح للنموذج، ولا تستطيع الإضافة إنشاء نموذج أو تعديله.
الإضافة ليست تكاملًا مع الذكاء الاصطناعي. FormFlow غير متصل بشاشة AI Connectors في WordPress 7.0.

إلى أين بعد ذلك

إن لم تكن قد وضعت نموذجًا في أي مكان بعد، اقرأ مقال تضمين نموذج بالمكوّن المولَّد: الرمز المختصر يطبع الشيفرة نفسها، فالمسارَان ينتهيان إلى النقطة نفسها. وإن لم تكن الصفحة بالإنجليزية، فإن مقال v1.7 يشرح كيف تتبع لغة النموذج النموذجَ من الصفحة المستضافة إلى نسخة مضمَّنة. وللعقد الذي يقف خلف الطلب، راجع مرجع API.