> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# توافق القوالب مع Upcart

> يوضح هذا المقال كيفية استكشاف مشكلات توافق القوالب مع Upcart وإصلاحها ويقدم أفضل الممارسات للأداء الأمثل.

<div id="overview">
  ## نظرة عامة
</div>

صُمم Upcart ليتكامل بسلاسة مع معظم **قوالب Shopify المبنية داخليًا**. ومع ذلك، قد تسبب بعض القوالب الخارجية مشكلات وظيفية بسبب الاختلافات في بنية الكود والتخصيص.

قوالب Shopify الأصلية مطوّرة من قِبل Shopify نفسها، مما يضمن توافقًا سلسًا، بينما قد تسبب القوالب المخصصة أو الخارجية مشكلات، حتى لو تم شراؤها عبر منصة Shopify.

نوصي باستخدام **قوالب Shopify المدمجة**، مثل **Dawn**، التي توفر أفضل توافق وأداء مع Upcart. لدى فريقنا نطاق دعم محدود للقوالب الخارجية، حيث يمكن أن تؤدي الاختلافات في طريقة تطويرها إلى تعارضات خارجة عن سيطرتنا.

للتوضيح، تُصنَّف قوالب مثل FOXECOM، حتى لو اشتُريت على Shopify، كقوالب خارجية وقد تكون لها قيود معينة في الوظائف.

***

<div id="incompatible-themes">
  ## القوالب غير المتوافقة
</div>

تبيّن أن القوالب التالية تسبب مشكلات باستمرار مع Upcart وهي غير مدعومة:

* **Trade**

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

***

<div id="themes-that-may-cause-issues">
  ## قوالب قد تسبب مشكلات
</div>

أُبلغ عن أن القوالب التالية تسبب تعارضات أو قد لا تعمل بالكامل كما هو مقصود مع Upcart:

* **Shrine**
* **Impulse**
* **Impact**
* **Prestige**

في حين أن هذه القوالب قد تعمل في بعض الحالات، قد لا تُعرض أو تعمل عناصر أو ميزات معينة من Upcart كما هو متوقع. إذا واجهت مشكلات أثناء استخدام أي من هذه القوالب، فنوصي بالاختبار مع **Dawn** أو قالب Shopify آخر للحصول على أفضل النتائج.

بالنسبة للقوالب ذات تحديات التوافق، يمكن للمطورين الاستفادة من [Upcart Public API](https://rokt.notion.site/upcart-public-api) للعمل على الحل.

ملاحظة

القوالب المدرجة هي أمثلة على القوالب التي أظهرت مشكلات توافق محتملة مع Upcart. قد توجد قوالب إضافية لم تُحدد بعد. سيتم تحديث هذه القائمة عند اكتشاف حالات جديدة أو الإبلاغ عنها.

***

<div id="partially-supported-themes">
  ## القوالب المدعومة جزئيًا
</div>

العديد من قوالب Shopify متوافقة مع Upcart، ونعمل على جعل التطبيق متاحًا قدر الإمكان للتجار الذين يستخدمون قوالب مخصصة أو غير افتراضية.

إذا كنت تشك في أن قالبك مدعوم جزئيًا فقط:

قد يشمل ذلك الاستعانة بخبير Shopify لاستخدام Upcart API، أو التأكد من استخدام عناصر Shopify القياسية، أو التفكير في التبديل إلى قالب Shopify أصلي للتخلص من تحديات التوافق.

1. راجع المقالات التالية أولاً:

* [**تغيير نوع السلة في القالب**](/ar/upcart/change_cart_type_in_theme)

- **Malformed Theme Code**

2. إذا استمرت المشكلات بعد اتباع هذه الخطوات، فتواصل مع **دعم Upcart** للحصول على مساعدة إضافية.
3. امنح مطوّر القالب حق الوصول إلى [UpCart Public API](https://rokt.notion.site/upcart-public-api) لحل مشكلات توافق القالب بفعالية.

***

<div id="testing-recommendation">
  ## توصية الاختبار
</div>

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

للقيام بذلك:

1. في لوحة تحكم Shopify، انتقل إلى **Online Store > Themes**.
2. انقر على **Actions** بجانب قالبك المباشر، ثم اختر **Duplicate**.
3. افتح القالب المكرر وانقر على **Preview**.
4. اختبر إعداد Upcart لديك، بما في ذلك تفاعلات السلة والخصومات وعروض البيع الإضافي.
5. بعد التأكد، انشر القالب المحدّث.

يضمن الاختبار المسبق التوافق ويساعد في منع أي مشكلات في العرض أو الأداء قبل أن تؤثر على عملائك.

***

<div id="best-practices">
  ## أفضل الممارسات
</div>

للحفاظ على أفضل أداء وضمان عمل Upcart بسلاسة مع قالبك:

* **حافظ على تحديث قالبك.** تصدر Shopify ومطورو القوالب تحديثات بانتظام تحسّن التوافق والأداء.
* **اختبر بعد أي تعديلات على القالب.** إذا أجريت تغييرات على الكود أو التخطيط، فاختبر سلوك سلتك للتأكد من عرض كل شيء بشكل صحيح.
* **تجنّب التخصيصات الخارجية الثقيلة.** يمكن للتعديلات الكبيرة في التصميم أو السكربتات أن تتداخل مع وظائف السلة.
* **استخدم محرر قوالب Shopify بحذر.** عاين التغييرات قبل النشر لمنع مشكلات العرض أو checkout.

يساعد اتباع أفضل الممارسات هذه في الحفاظ على إعداد مستقر ويضمن عمل متجرك بسلاسة مع Upcart.