إنتقل إلى المحتوى الرئيسي

تكامل السلة والخروج

عندما يضيف العميل منتجًا مخصصًا إلى السلة، تحدث سلسلة من العمليات خلف الكواليس: الودجت يمرر الاختيارات إلى سلة عبر حقول مخفية (Hidden Inputs)، سلة تحدد المتغير المناسب، وتطبق السعر والمخزون. فهم هذه الآلية يساعدك في تشخيص المشاكل والتأكد من دقة الطلبات.

كيف تنتقل الاختيارات من الودجت إلى سلة​

المسار الكامل​

العميل يختار في الودجت
        ↓
الودجت يملأ حقول HTML مخفية (Hidden Inputs)
        ↓
سلة تقرأ الحقول المخفية عند الإضافة للسلة
        ↓
سلة تحدد المتغير المطابق
        ↓
تطبيق السعر + SKU + المخزون
        ↓
إضافة المنتج إلى السلة

الحقول المخفية (Hidden Inputs)​

الودجت يضيف حقول <input type="hidden"> إلى صفحة المنتج. هذه الحقول غير مرئية للعميل لكن سلة تقرأها:

<input type="hidden" name="options[لون البشرة]" value="داكن">
<input type="hidden" name="options[تسريحة الشعر]" value="طويل">

هذه هي الآلية القياسية في سلة لتمرير خيارات المنتج. الودجت يتكامل معها بشكل طبيعي.

📸 Screenshot Needed

Dashboard Section: أدوات المطورين (DevTools) > عناصر (Elements) > حقول مخفية UI State: متصفح كروم مع DevTools مفتوحًا على تبويب Elements. البحث عن "options" يظهر حقول <input type="hidden"> مع قيم الخيارات المختارة. What to Capture: شاشة DevTools مع الحقول المخفية ظاهرة. RTL Note: أسماء الخيارات عربية في قيم name. Size: 800×400px

ماذا يحدث في السلة​

للمنتجات المربوطة بسلة​

عندما يختار العميل خيارات مربوطه بسلة:

  1. الحقول المخفية تحتوي على أسماء وقيم خيارات سلة
  2. سلة تقرأ هذه القيم
  3. سلة تبحث عن المتغير الذي يطابق هذه التركيبة
  4. تطبق: السعر، SKU، المخزون من المتغير

النتيجة في السلة: المنتج يظهر مع السعر الصحيح والمتغير الصحيح. تمامًا كما لو اختار العميل الخيارات من واجهة سلة الأصلية.

للمنتجات بنمط ودجت فقط​

  1. الحقول المخفية تحتوي على بيانات التخصيص
  2. هذه البيانات لا تؤثر على تحديد المتغير أو السعر
  3. البيانات تُحفظ في:
    • ملاحظات الطلب (Order Notes) في سلة
    • قاعدة بيانات التطبيق
  4. تظهر في لوحة تحكم الطلبات في التطبيق

كيف ترى الاختيارات في السلة​

في سلة المشتريات​

  • المنتج المربوط: يظهر باسم المتغير — مثلاً: "كوب أفاتار — لون البشرة: داكن، تسريحة الشعر: طويل"
  • المنتج ودجت فقط: قد لا تظهر تفاصيل التخصيص في السلة مباشرة

علامات السلة المخصصة​

⚠️ قريبًا — تسميات السلة المخصصة قيد التطوير

ستتمكن من تخصيص كيف تظهر اختيارات العميل في السلة:

  • إظهار/إخفاء تفاصيل حقول معينة
  • تغيير التسميات في السلة
  • إظهار معاينة مصغرة في السلة

إخفاء تفاصيل الحقول في السلة​

لماذا قد ترغب في إخفاء بعض التفاصيل​

  • حقول طويلة: رسالة إهداء من ٢٠٠ حرف قد تزحم السلة
  • معلومات حساسة: قد لا ترغب في إظهار كل تفاصيل التخصيص
  • تبسيط السلة: إظهار المعلومات الأساسية فقط

كيفية التحكم​

⚠️ قريبًا — إعدادات إخفاء تفاصيل السلة قيد التطوير

التحقق باستخدام DevTools​

للتأكد من أن الودجت يمرر البيانات بشكل صحيح:

  1. افتح صفحة المنتج في Chrome
  2. افتح DevTools (F12 أو Cmd+Option+I)
  3. اذهب إلى تبويب Elements (Elements)
  4. ابحث (Ctrl+F) عن options[
  5. يجب أن ترى حقول <input type="hidden"> مع أسماء وقيم الخيارات

مثال على الحقول المخفية الصحيحة​

<!-- حقل مربوط بسلة -->
<input type="hidden" name="options[لون البشرة]" value="داكن">

<!-- حقل ودجت فقط -->
<input type="hidden" name="customization[الاسم على الكوب]" value="أحمد">

في صفحة الخروج​

  • المنتجات المربوطة: تظهر مع المتغير الصحيح والسعر
  • بيانات ودجت فقط: قد تظهر في ملاحظات الطلب
  • السعر النهائي = السعر الأساسي + إضافات المتغيرات

اعتبارات مهمة​

ترتيب تحميل الودجت​

الودجت يجب أن يحمّل قبل أن يتمكن العميل من إضافة المنتج للسلة:

  • إذا الودجت لم يحمّل بعد ← زر "أضف إلى السلة" معطل
  • إذا الودجت حمّل ← الزر ينشط (إذا الحقول المطلوبة مكتملة)

توافق النسق (Theme)​

الودجت يتكامل مع جميع نسق سلة. لكن قد تحتاج بعض النسق المخصصة إلى تعديلات. راجع استكشاف أخطاء عرض الودجت.

الروابط المباشرة​

إذا شارك العميل رابط المنتج مع خيارات محددة (عبر URL parameters)، الودجت سيحاول تطبيق هذه الخيارات تلقائيًا. هذه الميزة مفيدة للتسويق وحملات البريد.

نصائح وأفضل الممارسات​

  1. اختبر عملية الشراء كاملة: أضف للسلة ← اذهب للسلة ← تابع للخروج ← تأكد من كل شيء
  2. تحقق من DevTools: إذا كان هناك مشكلة، تفقد الحقول المخفية أولاً
  3. اختبر كل تركيبات الخيارات: ليس فقط الأكثر شيوعًا
  4. تأكد من ظهور بيانات ودجت فقط: في ملاحظات الطلب وفي لوحة التحكم
  5. اختبر على الجوال: عملية السلة على الجوال تختلف قليلاً

مقالات ذات صلة​

آخر تحديث: 2026-05-17

آخر تحديث في