الرموز المختصرة ومنشئات الصفحات
تضمين النموذج في أي مكان
يمكن وضع نموذج Yaxii Smart Form على أي صفحة أو مقالة أو قالب — وليس فقط على صفحات منتجات WooCommerce. ثلاث طرق تكامل متاحة، وجميعها تشترك في نفس محرك العرض، مما يضمن أداءً ومظهرًا متطابقين بصرف النظر عن الطريقة المستخدمة.
الشورت كود
الصق في أي مقالة أو صفحة أو منطقة ودجت تدعم الشورت كود.
بدون معاملات، يكتشف الشورت كود المنتج تلقائيًا عند وضعه على صفحة منتج WooCommerce. على أي نوع صفحة آخر، يجب تحديد معرّف المنتج صراحةً.
المعاملات
| المعامل | القيم المقبولة | الافتراضي |
|---|---|---|
| id | معرّف المنتج، أو قائمة مفصولة بفواصل للحزم | اكتشاف تلقائي |
| layout | auto · 1col · 2col · multi | auto |
| theme | inherit · light · dark | inherit |
| primary_color | أي لون هيكساديسيمال، مثل #e11d48 | لون القالب الافتراضي |
| button_text | أي نص | إعداد الإضافة |
| show_progress | yes · no | إعداد الإضافة |
| enable_cart_buttons | yes · no | إعداد الإضافة |
| validation | on_submit · live · on_blur | on_submit |
| class | أي اسم فئة CSS | لا شيء |
أمثلة شائعة
منتج واحد على صفحة عادية:
تخطيط عمودين مع نص زر مخصص:
حزمة متعددة المنتجات (معرفات مفصولة بفواصل):
قالب داكن مع لون مخصص والتحقق الآني:
ودجت Elementor
إذا كان Elementor مفعّلًا، يظهر ودجت Yaxii Smart Form في قسم Yaxii بمكتبة بلوكات Elementor.
تبويب المحتوى
- وضع النموذج — اختر تلقائي (المنتج الحالي) ليكتشف الودجت المنتج من سياق الصفحة. اختر اختيار المنتج يدويًا لتحديد منتج بعينه من القائمة المنسدلة.
- المنتج — يظهر سيليكت المنتج فقط عندما يكون وضع النموذج مضبوطًا على يدوي.
- دعم منشئ القوالب — فعّل هذا الخيار عند وضع الودجت داخل قالب Theme Builder الخاص بـ Elementor لصفحات المنتجات في WooCommerce.
تبويب التصميم
- خلفية النموذج — تجاوز لون خلفية حاوية النموذج.
- الحشو الداخلي — تحكم في التباعد الداخلي بقيم متجاوبة (px أو em أو %).
السلوك في المحرر
في محرر Elementor، يعرض الودجت بطاقة معاينة تحمل اسم المنتج المختار داخل حد أزرق منقط — النموذج الكامل يُعرض فقط على الصفحة المنشورة. هذا تصميم مقصود لمنع تعارض السكريبتات داخل واجهة الإدارة.
[Screenshot: محرر Elementor يعرض بطاقة المعاينة مع اسم المنتج وحد أزرق منقط؛ لوحة تبويب المحتوى مرئية على اليمين مع وضع النموذج مضبوط على تلقائي]
بلوك Gutenberg
بلوك Yaxii Smart Form متاح في فئة Yaxii بمُدرج بلوكات Gutenberg. ابحث عن “Yaxii” للعثور عليه.
إعدادات البلوك (اللوحة الجانبية)
- معرّف المنتج — منتج WooCommerce المراد عرضه. اتركه فارغًا على صفحة منتج WooCommerce للاكتشاف التلقائي.
- التخطيط — يتحكم في عدد الأعمدة (تلقائي أو عمود واحد أو عمودان).
- اللون الرئيسي — لون هيكساديسيمال مخصص لنقطة التمييز في النموذج.
- إظهار شريط التقدم — تفعيل أو تعطيل مؤشر إتمام الخطوات.
- تفعيل أزرار السلة — تفعيل أو تعطيل مجموعة أزرار الإضافة إلى السلة.
- التحقق — اختر متى تُتحقق الحقول: on_submit أو live (آني) أو on_blur (عند مغادرة الحقل).
يدعم البلوك أيضًا عناصر التحكم في المحاذاة القياسية في Gutenberg (عرض كبير وعرض كامل)، ومعرفات المراسي، والفئات CSS المخصصة من شريط أدوات البلوك.
ما التالي؟
→ اقرأ: إرسال الطلبات إلى شركات الشحن