> ## 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 وإصلاحها عبر تعديل إعداد نوع السلة في قالبك.

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

يساعدك هذا الدليل على استكشاف الحالات التي **لا يفتح فيها Upcart** أو يُعاد فيها توجيه العملاء إلى صفحة السلة بدلًا من رؤية درج Upcart. تنجم معظم هذه المشكلات عن إعدادات نوع السلة في القالب، أو تهيئة Enhanced AJAX API Compatibility، أو عمليات إعادة التوجيه من تطبيقات الطرف الثالث، أو توجيه زر الدفع.

<Note>
  إذا كان Upcart لا يفتح على الإطلاق أو يعيد التوجيه إلى صفحة السلة، فراجع [استكشاف مشكلة عدم فتح Upcart أو إعادة التوجيه إلى صفحة السلة](/ar/upcart/troubleshooting_upcart_not_opening_or_redirecting) للحصول على دليل استكشاف أخطاء أكثر شمولًا.
</Note>

***

<div id="what-cart-type-to-choose">
  ## أي نوع سلة تختار
</div>

قبل الخوض في استكشاف الأخطاء، تحقق أولًا من إعداد نوع السلة في قالبك لأنه السبب الأكثر شيوعًا.

* **Page** - عادة ما يكون هذا هو الخيار الأفضل لأن Upcart يعترض الطلبات إلى صفحة **‎/cart**.
* **Drawer** - اختر هذا إذا فشل Upcart في الفتح وكانت صفحة **‎/cart** تُشغَّل بدلًا منه.
* **Confirmation Popup** - استخدم هذا إذا كان قالبك يدعمه ولم تحل الخيارات الأخرى المشكلة.

اختبار كلا الخيارين لا يستغرق سوى بضع دقائق، لكن **Page** هو عادة الخيار الأكثر فعالية.

<div id="how-to-change-cart-type-in-your-theme">
  ### كيفية تغيير نوع السلة في قالبك
</div>

1. انتقل إلى **Online Store > Themes > Customize** في لوحة إدارة Shopify.
2. افتح **Theme Settings > Cart > Cart Type**.
3. اختر إما **Page** أو **Drawer** بناءً على السلوك الذي تستكشف أخطاءه.
4. احفظ تغييراتك واختبر السلة في واجهة متجرك.

<img src="https://mintcdn.com/aftersell/uxKAdY-e0h16xa48/images/upcart/cart-type-theme-editor-settings-option.gif?s=81eef4e6af5190720b3eb86be578c605" alt="إعدادات السلة في محرر قالب Shopify تعرض خيار نوع السلة" width="644" height="1080" data-path="images/upcart/cart-type-theme-editor-settings-option.gif" />

<Note>
  إذا لم تتمكن من العثور على هذا الإعداد، فتواصل مع مطور القالب الخاص بك. يتحكم قالبك في هذا الإعداد ولا يمكن لـ Upcart تعديله مباشرة.
</Note>

***

<div id="troubleshooting-steps">
  ## خطوات استكشاف الأخطاء وإصلاحها
</div>

إذا لم يؤدِّ تغيير نوع السلة إلى حل المشكلة، فنفّذ الخطوات التالية بالترتيب.

<div id="1-check-enhanced-ajax-api-compatibility">
  ### 1. تحقق من Enhanced AJAX API Compatibility
</div>

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

1. انتقل إلى **Upcart > Cart Editor > Settings > Cart settings**، ثم وسّع **Advanced Settings**.
2. حدد مكان **Enhanced Ajax API compatibility**.
3. هذا الإعداد **معطّل افتراضيًا** لمعظم المتاجر. عند تعطيله، يعترض Upcart استدعاءات Add to Cart ويمنع عمليات إعادة التوجيه.
4. إذا كان مفعّلًا، فيمكن للتطبيقات الأخرى السيطرة على سلوك السلة وإعادة توجيه العملاء إلى صفحة السلة. جرّب تعطيله واختبر.
5. إذا تسبب تعطيله في مشكلات أخرى، فأعد تفعيله واستخدم واجهة Upcart API اليدوية (`upcartRegisterAddToCart`) بدلًا من ذلك.

للحصول على إرشادات كاملة حول هذا الإعداد، راجع [Enhanced AJAX API Compatibility](/ar/upcart/enhanced_ajax_api_compatibility).

<div id="2-check-for-third-party-app-redirects">
  ### 2. تحقق من عمليات إعادة التوجيه من تطبيقات الطرف الثالث
</div>

تتجاوز العديد من تطبيقات الطرف الثالث سلوك السلة ويمكنها إعادة توجيه العملاء بعيدًا عن درج Upcart. إذا كان زر الإضافة إلى السلة لديك يرسل العملاء تحديدًا إلى صفحة السلة، فراجع [لماذا ينتقل 'Add to Cart' إلى صفحة السلة بدلًا من Upcart؟](/ar/upcart/why_does_add_to_cart_go_to_the_cart_page_instead_of_upcart) لمزيد من التفاصيل.

افتح إعدادات أي تطبيقات متعلقة بالسلة وابحث عن خيارات مثل:

* Redirect to cart
* Go to cart after add
* Automatically open cart page
* Action after product is added

غيّرها إلى **Stay on page** أو **Do nothing**.

**إصلاحات شائعة خاصة بتطبيقات معينة:**

* **PageFly** - عطّل قواعد إعادة التوجيه في إعدادات تطبيق PageFly.
* **Globo Product Options** - ألغِ تفعيل إعادة التوجيه التلقائية إلى سلة Shopify.
* **Replo** - عدّل إعدادات "go to page" لتفعيل الدرج الجانبي لسلة التسوق.
* **Zepto Product Personalizer** - انتقل إلى Zepto > Settings > Add to Cart Settings وغيّر "Action after a product is added to the cart" إلى "Stay on the product page and show a success message."

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

<div id="3-check-checkout-button-routing">
  ### 3. تحقق من توجيه زر الدفع
</div>

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

1. انتقل إلى **Upcart > Cart Editor > Settings > Cart settings**.
2. حدد مكان **"Go to cart page when pressing checkout button"**.
3. اضبطه على **إيقاف**.
4. احفظ واختبر.

<Note>
  تتطلب إعادة التوجيه إلى صفحة دفع مخصصة برمجة متقدمة وهي غير مدعومة مباشرة من Upcart. إذا كنت بحاجة إلى توجيه العملاء إلى صفحة دفع مخصصة، فستحتاج إلى العمل مع مطور.
</Note>

<div id="4-check-theme-cart-redirect-settings">
  ### 4. تحقق من إعدادات إعادة التوجيه إلى السلة في القالب
</div>

تعيد بعض القوالب توجيه العملاء تلقائيًا بعد إضافة منتج، متجاوزةً Upcart تمامًا.

1. انتقل إلى **Online Store > Themes > Customize**.
2. افتح **Theme Settings > Products** (أو Cart).
3. ابحث عن إعدادات مثل:
   * Enable cart redirection
   * Redirect to cart after add
   * Go to cart after add
4. اضبطها على **إيقاف**.
5. احفظ واختبر.

<div id="5-clear-browser-cache">
  ### 5. امسح ذاكرة التخزين المؤقت للمتصفح
</div>

يمكن للسكربتات القديمة المخزّنة مؤقتًا الاحتفاظ بسلوك السلة السابق ومنع Upcart من التحميل بشكل صحيح.

1. افتح إعدادات متصفحك.
2. انتقل إلى **Privacy and Security**.
3. اختر **Clear Browsing Data**.
4. امسح الصور والملفات المخزنة مؤقتًا وملفات تعريف الارتباط.
5. حدّث متجرك واختبر.

<div id="6-test-with-a-default-shopify-theme">
  ### 6. اختبر بقالب Shopify افتراضي
</div>

إذا استمرت المشكلة، فانتقل مؤقتًا إلى قالب Shopify افتراضي مثل Dawn لاستبعاد التعارضات الخاصة بالقالب.

1. انتقل إلى **Shopify Admin > Online Store > Themes**.
2. أضف قالبًا مجانيًا مثل Dawn وفعّله.
3. اختبر Upcart على القالب الافتراضي.

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

***

<div id="preventative-measures">
  ## إجراءات وقائية
</div>

* **راجع التهيئات بعد التحديثات** - يمكن لتحديثات القوالب والتطبيقات إعادة ضبط إعدادات السلة أو تجاوزها. تحقق من نوع السلة وتهيئات التطبيقات بعد أي تحديث كبير.
* **اختبر توافق التطبيقات قبل التثبيت** - قبل إضافة تطبيقات طرف ثالث جديدة، تأكد من توافقها مع Upcart.
* **استخدم قالب مسودة للاختبار** - اختبر التغييرات على قالب مسودة قبل النشر لتجنب تعطيل متجرك المنشور. راجع [تفعيل Upcart في قالب مسودة فقط](/ar/upcart/enabling_upcart_in_a_draft_theme_only) للحصول على التعليمات.

***

<div id="frequently-asked-questions">
  ## الأسئلة الشائعة
</div>

<AccordionGroup>
  <Accordion title="هل يمكن لزر الدفع في Upcart إعادة التوجيه إلى صفحة دفع مخصصة؟">
    لا، تتطلب إعادة التوجيه إلى صفحة دفع مخصصة برمجة متقدمة وهي غير مدعومة مباشرة من Upcart. إذا كنت بحاجة إلى ذلك، فستحتاج إلى العمل مع مطور.
  </Accordion>

  <Accordion title="لماذا لا تزال السلة تعيد التوجيه إلى Shopify بعد تفعيل Upcart؟">
    تأكد من أن Upcart نشط ومنشور في Cart Editor. امسح أيضًا ذاكرة التخزين المؤقت لمتصفحك لضمان سريان السلوك المحدّث. إذا استمرت المشكلة، فتحقق من تعارضات تطبيقات الطرف الثالث باستخدام الخطوات أعلاه.
  </Accordion>

  <Accordion title="كيف أصلح تطبيق إضافات منتجات يسبب إعادة توجيه؟">
    افتح إعدادات تطبيق الإضافات وابحث عن أي تهيئات لإعادة التوجيه التلقائية أو "go to cart". عطّلها إذا كانت تتعارض مع Upcart. راجع الخطوة 2 أعلاه للاطلاع على أمثلة خاصة بتطبيقات معينة.
  </Accordion>
</AccordionGroup>

***

**هل تحتاج إلى مساعدة؟**

إذا نفّذت جميع الخطوات أعلاه واستمرت المشكلة، فتواصل مع فريق الدعم لدينا عبر الدردشة داخل التطبيق أو عبر مراسلة [support@upcart.app](mailto:support@upcart.app).