> ## 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 بما في ذلك عدم فتح الدرج، أو إعادة التوجيه إلى صفحة السلة، أو ظهور سلتين في الوقت نفسه، أو عدم تحميل السلة، أو عدم استجابة Upcart عند إضافة عناصر إلى السلة.

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

<div id="what-are-you-experiencing">
  ## ما الذي تواجهه؟
</div>

ابدأ من هنا للانتقال مباشرة إلى الحل المناسب:

* [**يفتح Upcart لفترة وجيزة ثم يعيد التوجيه إلى صفحة السلة**](#issue-1--2-upcart-redirecting-to-the-cart-page)
* [**يُنقل العملاء مباشرة إلى صفحة السلة بدلًا من رؤية Upcart**](#issue-1--2-upcart-redirecting-to-the-cart-page)
* [**تظهر سلتان في الوقت نفسه (Upcart وسلة القالب)**](#3-change-theme-cart-type-to-page)
* [**Upcart لا يفتح على الإطلاق**](#issue-4-upcart-is-not-opening-at-all)

لست متأكدًا أي حالة تنطبق عليك؟ ابدأ بـ [الخطوة 1](#step-1-make-sure-upcart-is-fully-active) للتأكد من تفعيل Upcart بالكامل قبل الغوص في مشكلة محددة.

معظم مشاكل درج سلة Upcart سببها:

* عدم تفعيل Upcart بالكامل
* تعارض إعدادات سلة القالب مع Upcart
* تكوين Enhanced AJAX API Compatibility
* تطبيقات خارجية تتجاوز سلوك السلة
* تعارض أدراج سلة القالب مع Upcart

اتبع الخطوات أدناه بالترتيب واختبر بعد كل تغيير.

***

<div id="step-1-make-sure-upcart-is-fully-active">
  ## الخطوة 1: تأكد من أن Upcart مفعّل بالكامل
</div>

قبل استكشاف أي شيء آخر، تأكد من تفعيل Upcart بشكل صحيح.

<div id="1-ensure-the-cart-is-activated">
  ### 1. تأكد من تفعيل السلة
</div>

إذا كانت السلة معطلة داخل محرر Upcart، فلن تظهر في واجهة متجرك.

* افتح Upcart
* انتقل إلى **Manage all carts**
* تأكد من أن السلة منشورة

<div id="2-enable-the-app-embed">
  ### 2. فعّل تضمين التطبيق (App Embed)
</div>

إذا كان تضمين التطبيق معطلًا، فلن يتم تحميل Upcart.

* انتقل إلى **Shopify Admin > Online Store > Themes > Customize**
* افتح **App Embeds**
* فعّل مفتاح **Upcart**
* احفظ

اختبر سلتك بعد تفعيل هذه الإعدادات.

<img src="https://mintcdn.com/aftersell/uxKAdY-e0h16xa48/images/upcart/cart-not-opening-activate-cart-app-embed.gif?s=244802191623615202cc95d61431de84" alt="تفعيل سلة Upcart وتمكين تضمين التطبيق الخاص بها في إدارة Shopify" width="2044" height="1080" data-path="images/upcart/cart-not-opening-activate-cart-app-embed.gif" />

***

<div id="issue-1--2-upcart-redirecting-to-the-cart-page">
  ## المشكلتان 1 و2: يقوم Upcart بإعادة التوجيه إلى صفحة السلة
</div>

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

<div id="1-check-checkout-button-setting-in-upcart">
  ### 1. تحقق من إعداد زر إتمام الشراء في Upcart
</div>

إذا كان العملاء ينقرون على Checkout ويُعادون إلى صفحة السلة:

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

عند تفعيله، يجبر هذا الإعداد زر إتمام الشراء على إعادة التوجيه إلى صفحة السلة بدلًا من المتابعة إلى إتمام الشراء (checkout).

<img src="https://mintcdn.com/aftersell/uxKAdY-e0h16xa48/images/upcart/cart-not-opening-go-to-cart-page-setting.gif?s=96670b4dedac961d37c1e39b80caea4a" alt="إعدادات سلة Upcart مع إبراز خيار الانتقال إلى صفحة السلة عند الضغط على زر إتمام الشراء" width="1180" height="1080" data-path="images/upcart/cart-not-opening-go-to-cart-page-setting.gif" />

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

انتقل إلى **Upcart > Cart Editor > Settings > Cart settings**، ووسّع **Advanced Settings**، وحدد موقع **Enhanced AJAX API Compatibility**.

يغيّر هذا الإعداد كيفية تعامل Upcart مع أحداث الإضافة إلى السلة:

* **معطل (موصى به لمعظم المتاجر)** - يعترض Upcart استدعاءات الإضافة إلى السلة ويمنع عمليات إعادة التوجيه
* **مفعّل** - يتوقف Upcart عن اعتراض استدعاءات الإضافة إلى السلة، مما يسمح لتطبيقات أخرى بالتحكم في سلوك السلة بما في ذلك عمليات إعادة التوجيه

هذا الإعداد **معطل افتراضيًا**. فعّله فقط إذا كان متجرك يستخدم واجهة AJAX cart API غير قياسية ولا يعترض Upcart أحداث الإضافة إلى السلة. إذا تسبب تفعيل هذا الإعداد في عمليات إعادة توجيه، فعطّله واستخدم واجهة Upcart اليدوية (`upcartRegisterAddToCart`) بدلًا من ذلك.

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

<img src="https://mintcdn.com/aftersell/Dz_83h-jRD2tmZWk/images/upcart/cart-not-opening-enhanced-ajax-api-compatibility.gif?s=7c3a3fc600bca7b421d57241bb740a78" alt="إعداد Enhanced Ajax API compatibility ووصفه في Upcart" width="2084" height="1080" data-path="images/upcart/cart-not-opening-enhanced-ajax-api-compatibility.gif" />

<div id="3-change-theme-cart-type-to-page">
  ### 3. غيّر نوع سلة القالب إلى "Page"
</div>

قد يكون درج السلة أو النافذة المنبثقة في قالبك يتجاوز Upcart.

1. انتقل إلى **Shopify Admin > Online Store > Themes**
2. انقر على **Customize**
3. افتح **Theme Settings > Cart**
4. غيّر **Cart Type** إلى **Page**
5. احفظ واختبر

ضبط السلة على "Page" يمنع فتح درج القالب الأصلي بدلًا من Upcart.

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

<Note>
  إذا لم يتضمن قالبك إعداد "Cart Type" (أو ما يعادله)، فتواصل مع مطوّر القالب لتحديد الخيار الصحيح أو إضافته. لا يمكن لـ Upcart تعديل إعدادات القالب مباشرة.
</Note>

<div id="4-disable-theme-cart-redirect-settings">
  ### 4. عطّل إعدادات إعادة توجيه السلة في القالب
</div>

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

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

<div id="5-check-for-conflicts-with-other-apps">
  ### 5. تحقق من التعارضات مع التطبيقات الأخرى
</div>

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

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

غيّرها إلى **Stay on page** أو **Do nothing** واختبر بعد كل تعديل.

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

* **Globo Product Options** - عطّل "Redirect to the shopping cart page after adding a product"
* **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"
* **PageFly** - عطّل أي إعادة توجيه للسلة أو قواعد إعادة توجيه في إعدادات PageFly
* **Replo** - عدّل إعدادات "go to page" للسماح بفتح درج السلة

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

***

<div id="issue-4-upcart-is-not-opening-at-all">
  ## المشكلة 4: Upcart لا يفتح على الإطلاق
</div>

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

<div id="disable-themes-native-cart-drawer">
  ### عطّل درج السلة الأصلي في القالب
</div>

1. انتقل إلى **Shopify Admin > Online Store > Themes > Customize**
2. افتح **Theme Settings > Cart**
3. اضبط نوع السلة على **Page**
4. احفظ

تأكد من تعطيل وضعي Drawer أو Popup.

<div id="upcart-not-detecting-your-buttons">
  ### هل لا يكتشف Upcart أزرارك؟
</div>

بعض القوالب تستخدم كودًا مخصصًا يمنع Upcart من اكتشاف زر الإضافة إلى السلة أو أيقونة السلة تلقائيًا. في هذه الحالة، يمكنك تحديد محددات (selectors) الأزرار يدويًا.

**الخطوة 1: اعثر على اسم الفئة (class)**

1. افتح متجرك في **Google Chrome**
2. انقر بزر الفأرة الأيمن على **زر الإضافة إلى السلة** أو **أيقونة السلة**
3. انقر على **Inspect**
4. في الكود المميّز، ابحث عن شيء مثل:

```text theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
class="icon icon-cart"
```

أو

```text theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
class="product-form__submit button"
```

انسخ **اسم فئة واحدًا فقط** (مثلًا: `icon-cart`). لا تنسخ `class=` أو علامات الاقتباس.

<img src="https://mintcdn.com/aftersell/uxKAdY-e0h16xa48/images/upcart/cart-not-opening-devtools-find-class.gif?s=1899e34961f704c4e9919620e3159376" alt="فحص أيقونة السلة في أدوات مطوّري Chrome للعثور على اسم فئتها" width="1600" height="1080" data-path="images/upcart/cart-not-opening-devtools-find-class.gif" />

**الخطوة 2: أضفه في Upcart**

يجب إضافة **نقطة (.)** قبل اسم الفئة عند إدخاله في Upcart. على سبيل المثال: `.icon-cart`

1. افتح **Upcart**
2. انتقل إلى **Cart Editor > Settings > Cart settings**، ثم وسّع **Advanced Settings**
3. اعثر على مجموعة المحددات التي تحتاجها:
   * **Open cart button selector** — لأيقونة السلة
   * **Add to cart button selector** — لزر الإضافة إلى السلة
4. في قائمة **Options** المنسدلة لتلك المجموعة، اختر **Add additional selector** (يحتفظ باكتشاف Upcart الخاص ويضيف محددك) أو **Use custom selector** (محددك فقط). يبقى حقل **Custom selector** معطلًا طالما أن **Use default selector** هو المختار.
5. الصق `.icon-cart` في **Custom selector** واحفظ

<img src="https://mintcdn.com/aftersell/uxKAdY-e0h16xa48/images/upcart/cart-not-opening-custom-open-selector.gif?s=d437f6359066a7aa26467f85611f13d2" alt="إدخال محدد مخصص لزر فتح السلة في الإعدادات المتقدمة لـ Upcart" width="1064" height="1080" data-path="images/upcart/cart-not-opening-custom-open-selector.gif" />

***

<div id="additional-troubleshooting">
  ## استكشاف أخطاء إضافي
</div>

إذا استمرت المشكلة بعد تنفيذ الخطوات أعلاه، فجرّب ما يلي واحدًا تلو الآخر، مع الاختبار بعد كل تغيير.

<div id="toggle-shadow-dom-onoff">
  ### بدّل Shadow DOM (تشغيل/إيقاف)
</div>

في بعض القوالب، يؤثر إعداد Shadow DOM على كيفية اكتشاف Upcart للأزرار وأحداث السلة.

1. انتقل إلى **Upcart > Cart Editor > Settings > Cart settings**، ثم وسّع **Advanced Settings**
2. حدد موقع **Render cart in shadow DOM**
3. فعّله **ON**، احفظ، واختبر
4. عطّله **OFF**، احفظ، واختبر مرة أخرى

استخدم الإعداد الذي يعطي سلوكًا متسقًا.

<div id="toggle-ajax-setting-onoff">
  ### بدّل إعداد AJAX (تشغيل/إيقاف)
</div>

بعض المتاجر تعمل بشكل أفضل مع تبديل معالجة AJAX، حسب إعداد القالب والتطبيقات.

1. انتقل إلى **Upcart > Cart Editor > Settings > Cart settings**، ثم وسّع **Advanced Settings**
2. حدد موقع **Enhanced Ajax API compatibility**
3. فعّله **ON**، احفظ، واختبر
4. عطّله **OFF**، احفظ، واختبر مرة أخرى

لاحظ أن هذا الإعداد يعطّل أيضًا معالجة Upcart الخاصة للإضافة إلى السلة، لذا إذا أصلح تفعيله مشكلة إعادة التوجيه، فمن الجدير التأكد من أن الإضافة إلى السلة ما زالت تعمل كما تتوقع. راجع [Enhanced Ajax API compatibility](/ar/upcart/enhanced_ajax_api_compatibility).

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

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

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

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

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

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

<div id="disable-apps-one-by-one">
  ### عطّل التطبيقات واحدًا تلو الآخر
</div>

1. انتقل إلى **Shopify Admin > Apps**
2. عطّل تطبيقًا واحدًا متعلقًا بالسلة في كل مرة
3. اختبر بعد كل واحد

عندما يبدأ Upcart في العمل، تكون قد حددت التطبيق المتعارض.

<div id="check-browser-console-for-errors">
  ### تحقق من وجود أخطاء في وحدة تحكم المتصفح
</div>

1. افتح متجرك
2. اضغط **F12** (أو انقر بزر الفأرة الأيمن > Inspect)
3. افتح علامة تبويب **Console**
4. أضف منتجًا إلى السلة
5. ابحث عن الأخطاء، وخصوصًا أي شيء متعلق بـ add.js أو أحداث السلة
6. التقط لقطة شاشة لأي أخطاء لمشاركتها مع الدعم

***

<div id="when-to-contact-support">
  ## متى تتواصل مع الدعم
</div>

إذا أكملت جميع الخطوات وما زال Upcart لا يعمل، فتواصل مع الدعم مع تزويده بما يلي:

* اسم القالب وإصداره
* قائمة التطبيقات المثبتة المتعلقة بالسلة
* لقطات شاشة لأخطاء وحدة التحكم
* الخطوات التي جربتها بالفعل

يمكنك التواصل مع دعم Upcart عبر الدردشة داخل التطبيق أو بمراسلة [support@upcart.app](mailto:support@upcart.app).