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

استكشاف أخطاء عرض الودجت

الودجت لا يظهر؟ حقول مفقودة؟ المعاينة لا تتحدث؟ هذا الدليل يغطي المشاكل الشائعة في عرض ودجت التخصيص على صفحة المنتج وحلولها.

الودجت لا يظهر على صفحة المنتج​

قائمة التحقق​

  1. ✅ هل المنتج مفعل في الاستوديو؟ (حالة "مفعل" وليس "مسودة")
  2. ✅ هل فتحت صفحة المنتج الصحيحة؟ (تأكد من معرف المنتج)
  3. ✅ هل التطبيق مثبت ومتصل بمتجرك؟ (حالة الاتصال "متصل")
  4. ✅ هل المتصفح يدعم JavaScript؟ (الودجت يتطلب JavaScript)
  5. ✅ هل هناك أخطاء في console المتصفح؟

الحلول​

المشكلةالحل
المنتج غير مفعلافتح الاستوديو ← تحقق ← فعل
التطبيق غير متصلاذهب للإعدادات ← أعد تفويض التطبيق
خطأ JavaScriptافتح DevTools (F12) ← تبويب Console ← ابحث عن أخطاء حمراء

تنظيف كاش الودجت​

أحيانًا يعلق كاش قديم. جرب:

  1. امسح ذاكرة التخزين المؤقت للمتصفح (Browser Cache)
  2. أعد تحميل الصفحة مع تجاهل الكاش: Ctrl+Shift+R (أو Cmd+Shift+R على Mac)
  3. جرب في وضع التصفح المخفي (Incognito)
  4. انتظر ٥ دقائق — بعض خوادم سلة تخزن مؤقتًا

الودجت يظهر لكن بعض الحقول مفقودة​

الأسباب المحتملة​

  1. قواعد الظهور: الحقل مخفي بشرط غير متحقق
  2. الحقل غير مضاف: تأكد من وجوده في الاستوديو
  3. خطأ في التفعيل: التفعيل لم يكتمل بشكل صحيح

الحلول​

خيارات سلة الأصلية ظاهرة بجانب الودجت​

المشكلة​

ترى خيارات سلة الأصلية (مثل قائمة منسدلة للون) بالإضافة إلى الودجت. هذا يسبب تشويشًا للعميل.

السبب​

المنتج في سلة لديه خيارات (Options) لم يتم إخفاؤها. الودجت لا يخفي خيارات سلة الأصلية تلقائيًا.

الحل​

  • الخيار الأمثل: لا تنشئ خيارات في سلة أصلاً إذا كنت تستخدم الودجت — دع الاستوديو يديرها عبر إنشاء وإدارة خيارات سلة
  • حل مؤقت: استخدم CSS مخصص لإخفاء خيارات سلة الأصلية (للتجار المتقدمين)
  • حل آمن: احذف الخيارات من لوحة تحكم سلة (إذا لم تكن مربوطة بمتغيرات مهمة)

المعاينة لا تتحدث عند تغيير الاختيارات​

الأسباب​

  1. الطبقة غير مربوطة بالحقل
  2. خطأ JavaScript في المتصفح
  3. مشكلة في تحميل الصور

الحلول​

  • في الاستوديو: تأكد من ربط الطبقات بالحقول
  • في المتصفح: افتح DevTools ← Console ← ابحث عن أخطاء
  • تأكد من تحميل الصور (لم تنتهِ صلاحية روابط الصور)

تخطيط RTL مكسور​

المشكلة​

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

الأسباب​

  • نسق المتجر لا يدعم RTL بشكل كامل
  • تعارض CSS بين الودجت والنسق

الحلول​

  • الودجت يفرض RTL على عناصره الداخلية — إذا كان النسق يتجاوز ذلك، استخدم CSS مخصص
  • جرب نسق سلة مختلف للتشخيص
  • تواصل مع الدعم — قد تحتاج إلى تعديل خاص للنسق

متى تتصل بالدعم​

اتصل بالدعم إذا:

  • جربت جميع الحلول أعلاه والمشكلة مستمرة
  • ظهرت أخطاء في Console لا تفهمها
  • المشكلة تؤثر على أكثر من منتج أو متجر
  • تحتاج إلى مساعدة في تخصيص CSS

معلومات مفيدة للدعم​

  • رابط المنتج على متجرك
  • لقطة شاشة للمشكلة
  • أخطاء Console (من DevTools)
  • نسق سلة الذي تستخدمه
  • المتصفح وإصداره

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

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

آخر تحديث في