القانوني / الشروط
سؤال قبول الشروط والأحكام يعرض بيانًا ويطلب من المستجيب القبول أو الرفض.
معرّف النوع: legal
الخصائص
| الخاصية | النوع | الوصف | الافتراضي |
|---|---|---|---|
buttonText | string | النص القانوني أو الشروط المعروضة. هذا نص الاتفاقية القانونية التي يقبلها المستجيب. | بدون |
السلوك
- يعرض النص القانوني من
buttonText. - ينقر المستجيب على "أقبل" أو "لا أقبل".
- يُستخدم عادة لسياسات الخصوصية وشروط الخدمة ونماذج الموافقة واتفاقيات معالجة البيانات.
التحقق
إذا كان required صحيحًا، يجب على المستجيب قبول الشروط للمتابعة. الرفض (تحديد "لا أقبل") عندما يكون السؤال مطلوبًا سيعرض خطأ تحقق.
معاملات القفز المنطقي
equals, not_equals, is_answered, is_not_answered
عند استخدام equals، قارن مع true (مقبول) أو false (مرفوض).
تنسيق الإجابة
تُخزن الإجابة كـ قيمة منطقية (true للقبول، false للرفض، أو null إذا لم تُجب).
تسجيل وضع الاختبار
القانوني نوع سؤال قابل للتسجيل:
- اختبار المعرفة: عيّن
correctAnswersبـ"true"أو"false". - تأهيل العملاء المحتملين: عيّن
choiceScoresبمفاتيح"true"و"false". - اختبار المطابقة: عيّن
choiceOutcomesبربط القبول/الرفض بشاشات النهاية.
نوع السؤال القانوني مشابه وظيفيًا لنعم/لا لكنه مصمم خصيصًا لسيناريوهات الشروط والأحكام. تعرض واجهة المستخدم أزرار "أقبل" / "لا أقبل" بدلًا من "نعم" / "لا".
الدفع
اجمع المدفوعات من المستجيبين كجزء من تدفق النموذج باستخدام تكامل Stripe. يدعم وضعي دفع وعملات قابلة للتكوين ومبالغ ثابتة أو متغيرة.
معرّف النوع: payment
أوضاع الدفع
| الوضع | الخطط | الوصف |
|---|---|---|
platform | جميع الخطط | يعالج NueForm المدفوعات ويحول الأموال إليك. رسوم 2.9% + $0.30 لكل معاملة. |
connect | Pro, Enterprise | تذهب المدفوعات مباشرة إلى حساب Stripe المتصل الخاص بك. بدون رسوم NueForm. |
الخصائص
| الخاصية | النوع | الوصف | الافتراضي |
|---|---|---|---|
price | number | مبلغ الدفع الثابت بالوحدات الرئيسية (مثل 29.99). اتركه فارغًا للمبالغ المتغيرة. | بدون |
currency | string | رمز العملة (مثل "USD" أو "EUR" أو "GBP"). | "usd" |
paymentMode | string | وضع الدفع: "platform" أو "connect". | "platform" |
paymentDescription | string | الوصف الذي يظهر على رسوم Stripe. | بدون |
paymentButtonText | string | نص مخصص لزر الدفع. | "Pay $X.XX" |
minAmount | number | الحد الأدنى للمبلغ المسموح للمدفوعات المتغيرة (وحدات رئيسية). | بدون |
maxAmount | number | الحد الأقصى للمبلغ المسموح للمدفوعات المتغيرة (وحدات رئيسية). | بدون |
stripeConnectionId | string | معرّف حساب Stripe المتصل للاستخدام. | بدون |
enableTracking | boolean | تتبع إجماليات الدفع التراكمية. | false |
paymentAccountId | string | معرّف حساب تتبع الدفع. | بدون |
accountTotalVariable | string | اسم المتغير لتخزين إجمالي الحساب الجاري. | بدون |
السلوك
- إذا عُيّن
price، يرى المستجيب المبلغ الثابت ويقدم تفاصيل البطاقة. - إذا لم يُعيّن
price، يدخل المستجيب مبلغه الخاص (وضع متغير/تبرع). - يُعرض Stripe Payment Element لجمع البطاقة بشكل آمن.
- عند نجاح الدفع، يتقدم النموذج تلقائيًا إلى السؤال التالي.
التحقق
إذا كان required صحيحًا، يجب على المستجيب إتمام الدفع للمتابعة.
معاملات القفز المنطقي
equals, not_equals, is_answered, is_not_answered
تنسيق الإجابة
تُخزن الإجابة ككائن PaymentResult:
{
"paymentIntentId": "pi_abc123",
"amount": 2999,
"currency": "usd",
"status": "succeeded"
}
لتعليمات الإعداد، راجع دليل جمع المدفوعات.
التاريخ
منتقي تاريخ يتيح للمستجيبين تحديد تاريخ. يدعم تنسيقات تاريخ قابلة للتكوين.
معرّف النوع: date
الخصائص
| الخاصية | النوع | الوصف | الافتراضي |
|---|---|---|---|
dateFormat | string | التنسيق الذي يُعرض ويُحلل به التاريخ (مثل "MM/DD/YYYY" أو "DD/MM/YYYY" أو "YYYY-MM-DD"). | افتراضي النظام |
السلوك
- يعرض واجهة منتقي تاريخ.
- يمكن للمستجيب كتابة تاريخ يدويًا أو الاختيار من أداة التقويم.
- يُخزن التاريخ بتنسيق ISO بغض النظر عن تنسيق العرض.
التحقق
إذا كان required صحيحًا، يجب على المستجيب تحديد تاريخ.
| القاعدة | الوصف |
|---|---|
min | الحد الأدنى للتاريخ المسموح. |
max | الحد الأقصى للتاريخ المسموح. |
customMessage | رسالة خطأ مخصصة للتحقق من التاريخ. |
معاملات القفز المنطقي
equals, not_equals, is_answered, is_not_answered
تنسيق الإجابة
تُخزن الإجابة كـ سلسلة نصية (قيمة التاريخ، عادة بتنسيق ISO أو dateFormat المكوّن).
Data Node
نوع سؤال غير مرئي يقوم بإجراء استدعاءات HTTP API أثناء تدفق النموذج. لا تُعرض Data Nodes للمستجيبين — تُنفذ تلقائيًا ويمكنها جلب البيانات أو التحقق من الإجابات أو تفعيل إجراءات خارجية.
معرّف النوع: data_node
الخصائص
| الخاصية | النوع | الوصف | الافتراضي |
|---|---|---|---|
dataNodeUrl | string | الرابط للاستدعاء. يدعم استيفاء {variable}. | بدون |
dataNodeMethod | string | طريقة HTTP: "GET" أو "POST" أو "PUT" أو "DELETE". | "GET" |
dataNodeHeaders | string | سلسلة JSON لرؤوس الطلب. يدعم استيفاء {variable}. | "{}" |
dataNodeBody | string | سلسلة JSON لجسم الطلب. يدعم استيفاء {variable}. | "" |
dataNodeResponseVariable | string | اسم المتغير لتخزين رد JSON الكامل. | بدون |
dataNodeTimeout | number | مهلة الطلب بالثواني. | 10 |
dataNodeSilent | boolean | وضع الإطلاق والنسيان — بدون شاشة تحميل. | false |
dataNodeDebug | boolean | عرض لوحة تصحيح مع تفاصيل الطلب/الرد. | false |
dataNodeLoadingText | string | نص تحميل مخصص يُعرض أثناء الطلب. | "Loading..." |
dataNodeValidation | boolean | الاستخدام كبوابة تحقق للسؤال السابق. | false |
السلوك
- يُنفذ تلقائيًا عند الوصول إليه في تدفق النموذج.
- تُستبدل جميع رموز
{variableName}في الرابط والرؤوس والجسم بقيم المتغيرات الحالية. - إذا عُيّن
dataNodeResponseVariable، يُخزن رد JSON الكامل كمتغير نموذج. - في الوضع الصامت، يُطلق الطلب في الخلفية بدون مؤشر تحميل.
- في وضع بوابة التحقق، الطلب الفاشل يمنع التقدم من السؤال السابق.
حالات الاستخدام
- جلب بيانات خارجية: البحث عن تفاصيل المنتج أو التسعير أو ملفات المستخدمين أثناء تدفق النموذج.
- التحقق من الإجابات: فحص بريد إلكتروني في قاعدة بياناتك أو التحقق من رمز قسيمة أو التحقق من عنوان.
- تفعيل إجراءات: إرسال بيانات إلى webhook أو إنشاء سجل في CRM أو بدء سير عمل.
Data Nodes غير مرئية للمستجيبين. تظهر في المُنشئ ومحرر سير العمل لكنها تُتخطى في النموذج المباشر — فقط استدعاء API يُنفذ. راجع دليل Data Nodes للأمثلة.
الميزات المتقدمة المشتركة
النص المنسق في العناوين والأوصاف
تدعم جميع أنواع الأسئلة المتقدمة النص المنسق في حقول العنوان والوصف. يُدخل النص المنسق عبر محرر مبني على Tiptap في مُنشئ النماذج ويدعم:
- غامق، مائل، تحته خط، و
يتوسطه خط - روابط (مع سمات
hrefوtargetوrel) - قوائم مرتبة وغير مرتبة
- كود مضمن
- نص مرتفع ومنخفض
- عائلات خطوط وألوان مخصصة عبر أنماط مضمنة
يُخزن النص المنسق كـ HTML ويُعقم قبل العرض باستخدام DOMPurify مع قائمة سماح صارمة للعلامات والسمات.
استبدال المتغيرات
تدعم جميع أنواع الأسئلة المتقدمة استبدال {variableName} في حقول العنوان والوصف. راجع دليل المتغيرات.
مرفقات الوسائط
تدعم جميع أنواع الأسئلة المتقدمة مرفقات الوسائط (صورة، فيديو، أيقونة، QR code) مع النطاق الكامل من خيارات التخطيط. راجع دليل إنشاء النماذج.