> ## 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.\
​

يعمل Upcart كطبقة درج جانبي لسلة التسوق، حيث يعزز تجربة سلة التسوق دون أن يستبدل بالكامل سلة Shopify الأصلية أو صفحة الدفع.\
​

التطبيقات التي تتجاوز سلوك سلة Shopify، أو تعترض إجراءات الإضافة إلى السلة (Add to Cart)، أو تستبدل نظام التسعير أو العملات الأصلي في Shopify قد تتعارض مع Upcart.

نوصي باستخدام وظائف Shopify الأصلية حيثما أمكن (مثل Shopify Markets لتحويل العملات). **يمتلك فريقنا نطاق دعم محدودًا لتطبيقات الطرف الثالث التي تغيّر بشكل كبير بنية سلة Shopify الافتراضية.**

حتى لو كان التطبيق متاحًا في متجر تطبيقات Shopify، فقد يظل مصنفًا كتطبيق طرف ثالث وقد تكون له قيود معينة عند استخدامه مع Upcart.

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

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

**BUCKS (تطبيق محول العملات)**\
لا يتوافق Upcart مع تطبيقات تحويل العملات من طرف ثالث. يستخدم Upcart تحويل العملات الأصلي في Shopify عبر Shopify Markets. تطبيقات تحويل العملات مثل BUCKS تغيّر الأسعار بصريًا فقط في واجهة المتجر ولا تعدّل عملة السلة الفعلية. لهذا السبب، لن تؤثر في عرض العملة داخل Upcart وقد تسبب تباينات.

إذا كنت بحاجة إلى وظيفة تعدد العملات، فنوصي باستخدام **Shopify Markets.**

**CloudFox Checkout**\
تطبيقات استبدال صفحة الدفع من طرف ثالث غير متوافقة مع Upcart.

**CartPanda**\
أنظمة الدفع من طرف ثالث غير مدعومة.

***

<div id="apps-that-may-cause-issues">
  ## **تطبيقات قد تسبب مشكلات**
</div>

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

* **qikify Quick View Popups**
* **Vitals**
* **Bundle Bear**

بينما قد تعمل هذه التطبيقات في بعض الحالات، فإن بعض عناصر أو ميزات Upcart قد لا تُعرض أو لا تعمل كما هو متوقع.

إذا واجهت مشكلات أثناء استخدام أي من هذه التطبيقات، فنوصي بتفعيل إعداد التوافق الموضح أدناه.\
​

يمكن للمطورين أيضًا الاستفادة من [<u>Upcart Public AP</u>](https://rokt.notion.site/upcart-public-api)I للعمل على إيجاد حل.

***

<div id="enhanced-ajax-api-compatibility">
  ## **Enhanced AJAX API Compatibility**
</div>

إذا كنت تواجه تعارضات مع تطبيق آخر، فنوصي بتفعيل:

**Enhanced AJAX API Compatibility**

لتفعيل هذا الإعداد:

انتقل إلى **Upcart → Cart editor → Settings → Cart settings → Advanced Settings → Enhanced Ajax API compatibility**. لا يوجد وجهة Settings في المستوى الأعلى من لوحة إدارة Upcart — يقع الإعداد داخل محرر السلة، خلف قسم **Advanced Settings** المطوي.

يخبر هذا الإعداد Upcart بالتوقف عن اعتراض استدعاءات Add to Cart.

كما يقوم بأمر ثانٍ لا يوحي به الاسم: فهو يجعل Upcart يضع استدعاءات Ajax cart API الخاصة بـ Shopify‏ (`/cart/add` و`/cart/add.js` و`/cart/update.js` و`/cart/change.js`) في طابور بحيث تعمل واحدة تلو الأخرى، مما يمنع التحديثات المتزامنة من سكربتات مختلفة من الكتابة فوق بعضها البعض. ونظرًا لأن هذا الطابور يعدّل جميع طلبات شبكة السلة على الصفحة، فعّل الإعداد فقط عند الحاجة إليه، واختبر واجهة المتجر بعد ذلك.

يتيح ذلك للتطبيقات الأخرى، مثل تطبيقات الحزم ومنشئي الصفحات وتطبيقات التخصيص وتطبيقات خيارات المنتجات، العمل دون تداخل.

<div id="important">
  ### **هام:**
</div>

هذا الإعداد يأتي مع مقايضة.

نظرًا لأن Upcart لن يعترض بعد الآن استدعاءات Add to Cart، فلن يتمكن من منع التطبيقات الأخرى من إعادة توجيه العملاء إلى صفحة السلة الأصلية.

إذا أُعيد توجيه العملاء بعيدًا عن الدرج الجانبي لسلة التسوق بعد تفعيل هذا الإعداد:

1. تحقق من إعدادات التطبيق المتعارض.
2. ابحث عن خيارات مثل:
   * Disable redirect to cart
   * Stay on page after add to cart
   * Enable AJAX add to cart
3. عدّل تلك الإعدادات لمنع إعادة التوجيه القسرية إلى صفحة السلة.

يوصى بشدة بالاختبار بعد تفعيل هذا الإعداد.

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

<div id="if-upcart-is-not-opening-or-is-redirecting">
  ### إذا لم يكن Upcart يفتح أو كان يعيد التوجيه
</div>

إذا لم يكن Upcart يفتح بشكل صحيح أو كان يعيد التوجيه إلى صفحة السلة بدلًا من ذلك، فيُرجى الرجوع إلى دليل استكشاف الأخطاء وإصلاحها الخاص بنا:

[استكشاف مشكلة عدم فتح Upcart أو إعادة التوجيه إلى صفحة السلة](/ar/upcart/troubleshooting_upcart_not_opening_or_redirecting)

يستعرض هذا الدليل الأسباب الشائعة والحلول خطوة بخطوة، بما في ذلك:

* التعارضات مع القالب أو الكود المخصص
* مشكلات إعدادات سلة AJAX
* فحوصات توافق التطبيقات
* خطوات استكشاف أخطاء المتصفح وذاكرة التخزين المؤقت

إذا استمرت المشكلة بعد اتباع الدليل، فيُرجى التواصل مع الدعم مع ذكر رابط متجرك ووصف موجز للمشكلة.

***

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

قبل نشر أي تغييرات، نوصي باختبار Upcart على نسخة مكررة من قالبك.

للقيام بذلك:

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

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

***