نظرة عامة
التغييرات الجذرية - تغييرات أسماء فئات CSS
فئات V1 (مهملة)
فئتا تحذير نفاد المخزون
upcart-quantity-warning وupcart-quantity-warning-text لم تتغيرا أيضًا. فهما تأتيان من مُهيّئ السلة وليس من وحدة ذات إصدار، لذا تُصدَران بشكل متطابق سواء كانت وحداتك على V1 أو V2..styles_CartPreview__card__ ليست في هذه القائمة — فهي غلاف هيكل السلة المشترك المعروض حول كل وحدة بغض النظر عن الإصدار، لذا تستمر القواعد التي تستهدفها في العمل على V2. فئتا المكافآت هما .styles_Rewards__ (الشريط البسيط) و.styles_TieredRewards__ (الشريط المتدرج)؛ لا توجد فئة .styles_RewardsModule__.فئات V2.0 (النظام الجديد)
أسماء الفئات الداخلية
أسماء الفئات العامة
upcart-public-) وهي آمنة للتجاوز في التصميمات المخصصة.
✅ ما يجب فعله
upcart-public- للتنسيق.
❌ ما يجب تجنبه
نظام سمات البيانات
تغييرات متغيرات القوالب
{{ }}.
وحدة الإعلانات
- V1.0:
`{TIMER}` - V2.0:
`{{timer}}`
وحدة المكافآت المتدرجة
- V1.0:
`{AMOUNT}`→ V2:`{{amount}}` - V1.0:
`{COUNT}`→ V2:`{{count}}`
عملية الترقية
1. انسخ التكوين الحالي احتياطيًا
2. اختبر في وضع Sandbox
التخصيص المتقدم مع V2.0
القوالب المخصصة
- انتقل إلى Settings > Cart settings، ووسّع Advanced Settings، وحدد Access custom templates. مربع الاختيار موجود داخل هذا القسم المطوي، وليس في علامة تبويب Cart settings نفسها.
- فعّل مفتاح الميزة.
- ارجع إلى وثائق مطوري Upcart للاطلاع على الصياغة والأمثلة.

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