تخطَّ إلى المحتوى
FormFlow

v1.75: احفظ وأكمل لاحقًا، وحقول UTM، وقواعد الدول

يتيح v1.75.0 للناس متابعة نموذج متعدد الخطوات خلال 7 أيام، ويضيف حقول UTM المخفية بإجراء واحد، ويُظهر دولة كل مُرسِل مع قواعد سماح وحظر، ويتيح لرمز واجهة الإدارة البرمجية تحديث الإرسالات. يشرح هذا المنشور كل بند وحدوده.

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

A dark plate titled 'v1.75: save and finish later, UTM fields and country rules', listing resuming a multi-step Form within 7 days, hidden UTM fields filled from the page address, the country shown per Submission with allow or block rules, and the Management API updating Submissions.

في FormFlow v1.75.0، الصادر في 27 أكتوبر 2026، أربعة بنود كلها إضافات. يشرح هذا المنشور كل بند وأين ينتهي؛ ويبقى v1.75.0 في سجل التغييرات هو السجل الرسمي للإصدار. أما v1.75.1 وv1.75.2 فإصداران ترقيعيان منفصلان لكلٍّ منهما بنده في سجل التغييرات، ولا يتناولهما هذا المنشور.

دع الناس يحفظون النموذج متعدد الخطوات ويكملونه لاحقًا

فعّل «حفظ الإجابات بين الخطوات» في تبويب «الحقول» بالنموذج. لا يظهر المفتاح إلا بعد أن يضم النموذج عدة خطوات، وهو متاح في كل الخطط المدفوعة.

  • يعمل في الصفحة التي تستضيفها FormFlow، أو في نموذج مضمَّن مع «العرض المباشر». وتُحفَظ الإجابات المكتوبة حتى الآن في كل مرة ينتقل فيها الشخص بين الخطوات.

  • يستطيع الشخص العودة من الجهاز نفسه خلال 7 أيام ومتابعة ما بدأه، أو اختيار «البدء من جديد».

  • لا تُحفَظ الملفات أبدًا. ويُعلم إشعارٌ الناسَ بأن إجاباتهم محفوظة: «تُحفظ إجاباتك أثناء الكتابة لتتمكن من إكمالها لاحقًا.»، باللغة التي يُقدَّم بها النموذج للمُرسِل.

  • تُخزَّن الإجابات المحفوظة مشفَّرة، دون عنوان IP أو موقع أو تفاصيل متصفح بجانبها.

  • وبعد ساعة دون حفظ يظهر الإدخال ضمن «غير مكتملة» في اللوحة، وفي ملخصك ضمن من بدأوا النموذج ولم يكملوه.

  • لا تُحتسَب الإدخالات غير المكتملة من استهلاكك ولا تُسلَّم ولا تُصدَّر. وتُحذف عند إكمال النموذج، أو بعد 30 يومًا كحد أقصى، أو قبل ذلك وفق مدة الاحتفاظ الخاصة بالنموذج؛ تشرح v1.18 مدة الاحتفاظ.

التقط معلمات UTM في نماذجك

اختر «إضافة حقول UTM» في المُنشئ لإضافة حقول مخفية لـ utm_source وutm_medium وutm_campaign وutm_term وutm_content. تملأ النماذج المضمَّنة ومكوّنات React وVue وHTML وBlade أي حقل مخفي فارغ من عنوان الصفحة، فيُظهر كل إرسال الحملة التي جاءت به. وهو متاح في كل الخطط.

  • يضيف المفاتيح التي لا يملكها النموذج بعد فقط؛ وإذا كانت الخمسة موجودة كلها يخبرك بذلك ولا يغيّر شيئًا.

  • هو تعديل عادي لقائمة الحقول: لا يُحفَظ شيء حتى تضغط «حفظ».

  • وفي النموذج متعدد الخطوات تذهب الحقول المخفية إلى الخطوة الأولى، لأن الحقل المخفي يجب أن يوجد فيها.

ويمكن أن تصل القيم المخفية أيضًا من رابط تكتبه بنفسك؛ انظر املأ نموذجًا مسبقًا من رابطه واحمل مصدر الحملة.

اعرف دولة كل مُرسِل، واسمح بدول أو احظرها

يُظهر كل إرسال الآن دولة المُرسِل في صندوق الوارد وفي ملفات التصدير وفي واجهة الإدارة البرمجية. يستنتجها FormFlow من عنوان IP على خوادمه ويحتفظ برمز الدولة المكوَّن من حرفين فقط، لا بالعنوان أبدًا. وتقرأ العملية ملف قاعدة بيانات للدول على خوادم FormFlow يُحدَّث شهريًا؛ ولا تُرسَل أي بيانات عن المُرسِلين إلى ناشرته DB-IP.

وفي إعدادات «الأمان» بالنموذج توجد «قاعدة الدولة»: «قبول كل الدول» افتراضيًا، أو «السماح بالدول التي أختارها فقط»، أو «حظر الدول التي أختارها». وهي متاحة في كل الخطط.

  • يُحفَظ الإرسال المرفوض ضمن «الإرسالات المرفوضة» لتتمكن من استعادته.

  • والإرسال الذي لا تُعرَف دولته يمرّ دائمًا.

حدّث الإرسالات عبر واجهة الإدارة البرمجية

يمكن لرمز API الآن تعليم الإرسال مُعالَجًا أو غير مُعالَج، وبريدًا مزعجًا أو لا، وإعادة محاولة تسليماته الفاشلة، كما تفعل في اللوحة. ويحتاج إلى صلاحية «submissions:write»، وهو متاح في كل الخطط المدفوعة.

  • التحديث: PATCH /api/v1/manage/submissions/{uuid} بالقيم المنطقية read وhandled وspam. والقيمة التي يملكها الإرسال أصلًا لا تغيّر شيئًا.

  • القراءة باتجاه واحد. إرسال read: false يُرفَض برمز HTTP 422 والخطأ read_cannot_be_unset.

  • إعادة المحاولة: POST /api/v1/manage/submissions/{uuid}/deliveries/retry، وهي إعادة المحاولة نفسها التي تستخدمها اللوحة، بحد أقصى 500 تسليم في الطلب الواحد.

  • ويمكن للرموز أيضًا تسجيل خطافات الويب الخاصة بها (REST hooks) عبر POST /api/v1/manage/hooks، حتى 10 لكل نموذج. ويحتاج إنشاء واحد إلى صلاحيتي «hooks:write» و«submissions:read»، لأن الخطّاف يُخرج الإجابات. ويُزال الخطّاف عند إلغاء رمزه أو انتهاء صلاحيته، ولا توجد نقطة نهاية تسردها.

وللقراءة بالرمز أولًا انظر اقرأ الإرسالات برمز واجهة إدارة محدّد النطاق.

ما لا يفعله هذا الإصدار

  • المتابعة تكون لكل جهاز ولكل نموذج ذي عدة خطوات، في خطة مدفوعة. فلا تحمل الملفات، ولا تتبع الشخص إلى جهاز آخر.

  • الإدخال غير المكتمل ليس إرسالًا: لا يُسلَّم ولا يُصدَّر ولا يُحتسب، فلا يصل شيء إلى خطافات الويب أو ملفات التصدير حتى يكتمل النموذج. ولا يذكره ملخصك إلا بوصفه من بدأوا ولم يكملوا.

  • «إضافة حقول UTM» تضيف المفاتيح الخمسة القياسية ولا شيء غيرها، وعنوان الصفحة لا يملأ إلا الحقول التي ما زالت فارغة.

  • تُحكم قاعدة الدولة بحسب عنوان IP الخاص بالمُرسِل. وحين يتعذّر استنتاج الدولة لا تُسجَّل دولة ويُقبَل الإرسال.

  • لا تستطيع واجهة الإدارة البرمجية تعليم إرسال بأنه غير مقروء، ولا يفعل الرمز هذه الأمور إلا بالصلاحيات التي منحتها له.

نص كل بند كاملًا في بند v1.75.0 في سجل التغييرات.