Skip to main content

​
نظرة عامة

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

​
أي نوع سلة تختار

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

​
كيفية تغيير نوع السلة في قالبك

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

​
خطوات استكشاف الأخطاء وإصلاحها

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

​
1. تحقق من Enhanced AJAX API Compatibility

يتحكم هذا الإعداد في كيفية تعامل 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.

​
2. تحقق من عمليات إعادة التوجيه من تطبيقات الطرف الثالث

تتجاوز العديد من تطبيقات الطرف الثالث سلوك السلة ويمكنها إعادة توجيه العملاء بعيدًا عن درج Upcart. إذا كان زر الإضافة إلى السلة لديك يرسل العملاء تحديدًا إلى صفحة السلة، فراجع لماذا ينتقل ‘Add to Cart’ إلى صفحة السلة بدلًا من 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 في العمل بشكل صحيح.

​
3. تحقق من توجيه زر الدفع

إذا نقر العملاء على زر الدفع داخل Upcart وأُعيد توجيههم إلى صفحة السلة بدلًا من صفحة الدفع:
  1. انتقل إلى Upcart > Cart Editor > Settings > Cart settings.
  2. حدد مكان “Go to cart page when pressing checkout button”.
  3. اضبطه على إيقاف.
  4. احفظ واختبر.
تتطلب إعادة التوجيه إلى صفحة دفع مخصصة برمجة متقدمة وهي غير مدعومة مباشرة من Upcart. إذا كنت بحاجة إلى توجيه العملاء إلى صفحة دفع مخصصة، فستحتاج إلى العمل مع مطور.

​
4. تحقق من إعدادات إعادة التوجيه إلى السلة في القالب

تعيد بعض القوالب توجيه العملاء تلقائيًا بعد إضافة منتج، متجاوزةً 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. احفظ واختبر.

​
5. امسح ذاكرة التخزين المؤقت للمتصفح

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

​
6. اختبر بقالب Shopify افتراضي

إذا استمرت المشكلة، فانتقل مؤقتًا إلى قالب Shopify افتراضي مثل Dawn لاستبعاد التعارضات الخاصة بالقالب.
  1. انتقل إلى Shopify Admin > Online Store > Themes.
  2. أضف قالبًا مجانيًا مثل Dawn وفعّله.
  3. اختبر Upcart على القالب الافتراضي.
إذا عمل Upcart بشكل صحيح على Dawn، فالمشكلة في قالبك المخصص. تواصل مع مطور القالب الخاص بك للحصول على المساعدة.

​
إجراءات وقائية

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

​
الأسئلة الشائعة

لا، تتطلب إعادة التوجيه إلى صفحة دفع مخصصة برمجة متقدمة وهي غير مدعومة مباشرة من Upcart. إذا كنت بحاجة إلى ذلك، فستحتاج إلى العمل مع مطور.
تأكد من أن Upcart نشط ومنشور في Cart Editor. امسح أيضًا ذاكرة التخزين المؤقت لمتصفحك لضمان سريان السلوك المحدّث. إذا استمرت المشكلة، فتحقق من تعارضات تطبيقات الطرف الثالث باستخدام الخطوات أعلاه.
افتح إعدادات تطبيق الإضافات وابحث عن أي تهيئات لإعادة التوجيه التلقائية أو “go to cart”. عطّلها إذا كانت تتعارض مع Upcart. راجع الخطوة 2 أعلاه للاطلاع على أمثلة خاصة بتطبيقات معينة.
هل تحتاج إلى مساعدة؟ إذا نفّذت جميع الخطوات أعلاه واستمرت المشكلة، فتواصل مع فريق الدعم لدينا عبر الدردشة داخل التطبيق أو عبر مراسلة support@upcart.app.