Skip to main content

نظرة عامة

تقدم وحدات Upcart V2.0 إعادة تصميم معماري كامل لنظام السلة. يركز التحديث على تحسين الأداء وتعزيز التخصيص وسهولة الصيانة. سيساعدك هذا الدليل على فهم ما يتغير عند الانتقال من وحدات V1.0 إلى V2.0، وما مشاكل التوافق التي قد تواجهها، وكيفية تحديث تخصيصاتك الحالية بأمان.

التغييرات الجذرية - تغييرات أسماء فئات CSS

فئات V1 (مهملة)

🚨 أسماء فئات V1.0 التالية لم تعد مدعومة في V2.0:
فئتا تحذير نفاد المخزون upcart-quantity-warning وupcart-quantity-warning-text لم تتغيرا أيضًا. فهما تأتيان من مُهيّئ السلة وليس من وحدة ذات إصدار، لذا تُصدَران بشكل متطابق سواء كانت وحداتك على V1 أو V2.
.styles_CartPreview__card__ ليست في هذه القائمة — فهي غلاف هيكل السلة المشترك المعروض حول كل وحدة بغض النظر عن الإصدار، لذا تستمر القواعد التي تستهدفها في العمل على V2. فئتا المكافآت هما .styles_Rewards__ (الشريط البسيط) و.styles_TieredRewards__ (الشريط المتدرج)؛ لا توجد فئة .styles_RewardsModule__.

فئات V2.0 (النظام الجديد)

يقدم V2.0 نظام تسمية منظمًا ببادئات فئات داخلية (internal) وعامة (public).

أسماء الفئات الداخلية

هذه محجوزة للاستخدام الداخلي وقد تتغير دون إشعار. إذا تجاوزت هذه الفئات، فالتوافق المستقبلي غير مضمون.

أسماء الفئات العامة

🚨 قائمة أسماء الفئات العامة المتاحة
هذه جزء من واجهة API التنسيق العامة (upcart-public-) وهي آمنة للتجاوز في التصميمات المخصصة.

✅ ما يجب فعله

استخدم فقط أسماء فئات upcart-public- للتنسيق.

❌ ما يجب تجنبه

تجنّب تجاوز أسماء الفئات الداخلية
تجنّب استهداف عقد محددة بمحددات عميقة أو مخصصة.

نظام سمات البيانات

يقدم V2.0 نظام سمات بيانات (data attributes) منظمًا لتحسين الاستهداف والتخصيص المتقدم.
تجعل هذه السمات من الأسهل إنشاء قوالب مرنة قائمة على البيانات مع الحفاظ على وضوح الكود.

تغييرات متغيرات القوالب

تستخدم وحدات V2 صياغة جديدة لمتغيرات القوالب بأقواس معقوفة مزدوجة {{ }}.

وحدة الإعلانات

  • V1.0: `{TIMER}`
  • V2.0: `{{timer}}`

وحدة المكافآت المتدرجة

  • V1.0: `{AMOUNT}` → V2: `{{amount}}`
  • V1.0: `{COUNT}` → V2: `{{count}}`

عملية الترقية

1. انسخ التكوين الحالي احتياطيًا

قبل إجراء أي تغييرات، انسخ ملفات CSS المخصص وHTML الحالية احتياطيًا.

2. اختبر في وضع Sandbox

أعدّ سلتك المحدّثة باستخدام وضع sandbox لاختبار الوحدات الجديدة بأمان قبل الإطلاق.

التخصيص المتقدم مع V2.0

القوالب المخصصة

تدعم وحدات V2.0 قوالب مخصصة بالكامل للتجار الذين يريدون تحكمًا كاملاً في التخطيط والهيكل. لتفعيل القوالب المخصصة:
  1. انتقل إلى Settings > Cart settings، ووسّع Advanced Settings، وحدد Access custom templates. مربع الاختيار موجود داخل هذا القسم المطوي، وليس في علامة تبويب Cart settings نفسها.
  2. فعّل مفتاح الميزة.
  3. ارجع إلى وثائق مطوري Upcart للاطلاع على الصياغة والأمثلة.
مربع اختيار Access custom templates مفعّل مع وصفه في إعدادات سلة Upcart ملاحظة: لا يمكن لفريق دعم Upcart المساعدة في تطوير القوالب المخصصة أو تصحيح أخطائها أو استكشاف مشاكلها وإصلاحها.

أفضل الممارسات

  • اختبر التحديثات دائمًا في وضع sandbox أولاً.
  • رقِّ التخصيصات وحدّثها تدريجيًا.
  • استخدم الفئات العامة للتنسيق بدلاً من الفئات الداخلية.
  • احتفظ بنسخ احتياطية من جميع الإصدارات السابقة قبل تحديث الإعدادات المباشرة.

اعتبارات مستقبلية

  • ستستمر وحدات V2 في تلقي ميزات جديدة وتحسينات وتحديثات.
  • وحدات V1 الآن في وضع الصيانة بدعم محدود ودون ميزات جديدة.
  • نشجع التجار على الترقية إلى V2 في أقرب وقت ممكن لتحقيق التوافق الكامل.