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

# التوافق المحسّن مع Ajax API

> اسمح للتطبيقات الخارجية والسكربتات المخصصة بالتحكم في عملية الإضافة إلى السلة.

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

يقوم هذا الإعداد بأمرين:

1. **وضع استدعاءات سلة Ajax في Shopify في طابور.** عندما تستدعي عدة سكربتات واجهة برمجة تطبيقات سلة Ajax في Shopify (`/cart/add`، `/cart/add.js`، `/cart/update.js`، `/cart/change.js`) في الوقت نفسه، تُسقط Shopify أحيانًا أحد التغييرات. يجبر Upcart تلك الاستدعاءات على التنفيذ واحدًا تلو الآخر حتى يُسجَّل كل تحديث. هذا هو الغرض الرئيسي للإعداد.
2. **التنحي عن الإضافة إلى السلة.** كما يعطّل معالجة Upcart المدمجة لعملية الإضافة إلى السلة، بحيث لا يتعارض معها تطبيق أو قالب يحتاج إلى التحكم الكامل في هذا التدفق.

يرتبط كلا السلوكين بمربع الاختيار الواحد — لا يمكنك تفعيل طابور الطلبات دون التخلي أيضًا عن معالجة Upcart للإضافة إلى السلة.

<div id="where-to-find-it">
  ## أين تجده
</div>

افتح محرر السلة، وانتقل إلى **Settings > Cart settings**، ثم وسّع **Advanced Settings**.\
ابحث عن **"Enhanced Ajax API compatibility"**.

<div id="how-it-works">
  ## كيف يعمل
</div>

<div id="disabled-recommended">
  ### معطّل (موصى به)
</div>

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

هذا هو **الإعداد الموصى به لمعظم المتاجر**. أبقِ هذا الإعداد معطّلًا ما لم تواجه مشاكل محددة حيث لا يعترض Upcart أحداث الإضافة إلى السلة من قالبك أو تطبيقات أخرى.

<div id="enabled">
  ### مفعّل
</div>

لن يدير Upcart بعد الآن عملية الإضافة إلى السلة. يتيح ذلك للتطبيقات الأخرى أو JavaScript المخصص أو قالبك تعديل السلة دون تدخل.

**فعّل هذا الإعداد فقط عندما:**

* يستخدم متجرك واجهة برمجة تطبيقات AJAX cart غير قياسية
* لا يعترض Upcart أحداث الإضافة إلى السلة من قالبك أو تطبيقات أخرى
* تحتاج التطبيقات الخارجية إلى التحكم المباشر في سلوك السلة

**مقايضات مهمة عند التفعيل:**

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

**إذا تسبب التفعيل في حلقات إعادة توجيه:**

1. عطّل هذا الإعداد
2. استخدم واجهة برمجة تطبيقات Upcart اليدوية (`upcartRegisterAddToCart`) بدلًا من ذلك
3. راجع أدلة التكامل الخاصة بتطبيقات محددة (مثل [Replo](/ar/upcart/upcart_x_replo_landing_page_builder))

<div id="testing">
  ## الاختبار
</div>

بعد تغيير هذا الإعداد:

1. انقر على **Save**
2. اختبر إضافة منتجات إلى سلتك
3. تحقق من أن درج Upcart يفتح بشكل صحيح
4. تأكد من عدم إعادة توجيهك إلى صفحة سلة Shopify

إذا واجهت مشاكل بعد التفعيل، فعطّل الإعداد وتواصل مع الدعم للحصول على حلول بديلة.