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

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

> استكشف المشكلات الشائعة في تكوينات Multicart وأصلحها.

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

يساعدك هذا الدليل على حل المشكلات الشائعة عند العمل مع تكوينات سلات متعددة في Upcart.

<div id="preview-limitations">
  ## قيود المعاينة
</div>

قد لا تعكس معاينات المسودة سلوك السلة المنشورة بالكامل. الميزات التي تعتمد على حالة السلة الحقيقية أو رموز الخصم المباشرة أو تكاملات معينة قد تتصرف بشكل مختلف.

**الميزات ذات قيود المعاينة المعروفة:**

* **الخصومات** - قد لا تعمل بشكل صحيح في وضع sandbox
* **حماية الشحن** - يتصرف البحث عن المنتجات بشكل مختلف في sandbox
* **الدفع السريع** (Shop Pay وApple Pay وغيرهما) - غير متاح في المعاينة

⚠️ **تلميح:** لمعظم تغييرات التخطيط والتصميم، المعاينة موثوقة. لاختبار الخصومات أو حماية الشحن أو الدفع السريع، ستحتاج إلى نشر السلة للاختبار بشكل صحيح.

<div id="preview-troubleshooting">
  ### استكشاف أخطاء المعاينة وإصلاحها
</div>

إذا عاينت سلة ورأيت سلة غير صحيحة، فقد يحدث ذلك بسبب قيود Shopify. جرّب تحديث الصفحة أو فتح السلة وإغلاقها لتحديث المعاينة.

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

إذا لم تظهر الترجمات على واجهة متجرك:

1. **تحقق مما إذا كانت الترجمة قد حُفظت** - انتقل إلى All Carts → Translate في سلتك المنشورة وتحقق من إدخال النص للغة المعنية
2. **تحقق مما إذا كانت السلة التي تحتوي على الترجمات منشورة** - تُزامَن الترجمات فقط عند نشر السلة
3. **تحقق من إعدادات لغات Shopify** - انتقل إلى Shopify Admin → Settings → Languages وتحقق من تفعيل اللغة
4. **تحقق من أن اللغة الصحيحة نشطة** - يجب تصفح واجهة متجرك باللغة المستهدفة حتى تُعرض الترجمات

<div id="common-issues-and-solutions">
  ## المشكلات الشائعة والحلول
</div>

<div id="upcart-has-disappeared-from-my-store">
  ### اختفى Upcart من متجري
</div>

**السبب الأكثر شيوعًا:** ليس لديك سلة منشورة.

**كيفية الإصلاح:**

1. افتح تطبيق Upcart وانتقل إلى **All Carts**
2. تحقق مما إذا كانت أي سلة تعرض شارة "live" خضراء
3. إذا لم تكن هناك سلة منشورة، انقر على **Publish** في أي سلة مسودة تريد تفعيلها

**أسباب أخرى:**

* قد يكون تضمين تطبيق Upcart معطلاً. ستعرض السلة المنشورة شارة صفراء "App embed off". انتقل إلى Shopify Admin → Online Store → Themes → Customize → App embeds → فعّل **Upcart**.

<div id="my-cart-settings-changedreset-after-i-published-a-different-cart">
  ### تغيّرت إعدادات سلتي/أُعيد ضبطها بعد أن نشرت سلة مختلفة
</div>

هذا سلوك متوقع. يؤدي نشر سلة إلى الكتابة فوق حقول التعريف (metafields) المباشرة في Shopify بإعدادات السلة الجديدة.

**كيفية الإصلاح:**

1. لا تزال سلتك السابقة محفوظة كمسودة
2. انتقل إلى **All Carts**، وابحث عن سلتك القديمة في قسم المسودات
3. انقر على **Publish** عليها لاستعادة الإعدادات السابقة

**كيفية منعها في المستقبل:** راجع سلة المسودة بعناية قبل النشر، حيث يستبدل النشر جميع الإعدادات المباشرة.

<div id="my-shipping-protection-disappeared-after-switching-carts">
  ### اختفت حماية الشحن بعد تبديل السلات
</div>

تُهيأ حماية الشحن لكل سلة. السلة المنشورة حديثًا إما لا تحتوي على منتج حماية شحن مهيأ، أو تحتوي على منتج مختلف.

**كيفية الإصلاح:**

1. انتقل إلى محرر السلة للسلة المنشورة حاليًا
2. انتقل إلى وحدة Add-ons ← قسم Shipping Protection
3. أعد تهيئة منتج حماية الشحن
4. احفظ (ستُحدَّث إعدادات السلة المنشورة فورًا)

**إذا أردت أن يكون لكلتا السلتين نفس حماية الشحن:** هيّئ منتج حماية الشحن في كل سلة على حدة قبل النشر.

<div id="my-discount-rules-stopped-working-after-switching-carts">
  ### توقفت قواعد الخصومات عن العمل بعد تبديل السلات
</div>

قواعد الخصومات **على مستوى المتجر بأكمله، وليست لكل سلة** — مجموعة واحدة لمتجرك بالكامل، تُطبَّق بغض النظر عن السلة المنشورة. لا يؤدي نشر سلة مختلفة أبدًا إلى إزالتها أو استبدالها، لذا فإن تغيّر السلوك بعد النشر لا يعني فقدان مجموعة القواعد.

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

<div id="i-cant-delete-my-cart">
  ### لا أستطيع حذف سلتي
</div>

أنت تحاول حذف سلة منشورة. لا يمكن حذف السلات المنشورة.

**كيفية الإصلاح:**

1. انتقل إلى **All Carts** وحدد السلة المنشورة (الشارة الخضراء)
2. انقر على **Unpublish** عليها
3. ⚠️ تحذير: هذا يعني عدم وجود سلة منشورة حتى تنشر أخرى
4. بمجرد أن تصبح مسودة، سيصبح خيار الحذف متاحًا

**إذا لم تكن لديك سلة أخرى للنشر:** أنشئ سلة جديدة (أو كرر الحالية)، وهيّئها، ثم انشر السلة الجديدة قبل حذف القديمة. يتجنب هذا فترة بدون سلة منشورة.

<div id="the-draft-preview-doesnt-look-rightdoesnt-match-what-i-expect">
  ### معاينة المسودة لا تبدو صحيحة/لا تطابق ما أتوقعه
</div>

تستخدم معاينات المسودة وضع sandbox، الذي له قيود معروفة. لا تتصرف جميع الميزات بنفس الطريقة كما في البيئة المباشرة.

**القيود المعروفة:**

* قد لا تعمل الخصومات في وضع sandbox
* قد لا تُعرض حماية الشحن بشكل صحيح
* أزرار الدفع السريع (Shop Pay وApple Pay وغيرهما) غير متاحة في المعاينة

**لمعظم تغييرات التخطيط/التصميم:** معاينة sandbox موثوقة بما فيه الكفاية.

**لاختبار الخصومات أو حماية الشحن أو الدفع السريع:** ستحتاج إلى نشر السلة في بيئة مباشرة للاختبار بشكل صحيح.

<div id="my-live-cart-analytics-arent-populated">
  ### تحليلات سلتي المنشورة غير معبأة
</div>

تغطي التحليلات لكل سلة فقط النشاط المسجل منذ بدء ختم السلات على أحداث التحليلات. لا يزال النشاط السابق مخزنًا ومحتسبًا — لكنه لا يمكن تقسيمه حسب السلة، لذا اعرضه في صفحة Analytics أو الرسم البياني في الصفحة الرئيسية بدلاً من العرض لكل سلة.

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

<div id="what-happens-to-my-current-live-cart-when-i-publish-a-new-one">
  ### ماذا يحدث لسلتي المنشورة الحالية عند نشر سلة جديدة؟
</div>

تُنقل السلة المنشورة السابقة تلقائيًا إلى المسودات. يحدث هذا فورًا. سترى نافذة تأكيد قبل حدوث ذلك.

<div id="can-i-preview-both-sandbox-and-live-carts-at-once">
  ### هل يمكنني معاينة سلتي sandbox والمنشورة في وقت واحد؟
</div>

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

<div id="i-published-a-cart-by-mistake-and-now-my-live-settings-are-wrong-what-do-i-do">
  ### نشرت سلة عن طريق الخطأ والآن إعداداتي المباشرة خاطئة. ماذا أفعل؟
</div>

لا تُفقد أي بيانات. انتقل إلى **All Carts** وابحث عن السلة التي أردتها فعلاً أن تكون منشورة (ستكون الآن في قسم المسودات). انقر على **Publish** عليها لاستعادتها كسلة منشورة.

<div id="im-getting-an-error-when-trying-to-publishunpublishdelete-whats-wrong">
  ### أحصل على خطأ عند محاولة النشر/إلغاء النشر/الحذف. ما المشكلة؟
</div>

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

انتظر بضع ثوانٍ وحاول مرة أخرى. الخطأ عابر. إذا استمر، حدّث الصفحة وحاول مرة أخرى.

<div id="the-upgrade-to-v2-changed-how-my-cart-looks-can-i-revert-it">
  ### غيّرت الترقية إلى V2 مظهر سلتي. هل يمكنني التراجع عنها؟
</div>

**إذا لم تنشر بعد:** يمكنك التراجع عن الترقية في محرر السلة قبل النشر.

**إذا نشرت سلة V2 بالفعل:** لست بحاجة إلى مسودة قديمة. افتح محرر السلة واستخدم القائمة المنسدلة **Cart version** للعودة إلى **V1.0 (Legacy)**، ثم احفظ. تظهر القائمة المنسدلة متى كانت كل وحدة في السلة على V2، سواء كانت السلة منشورة أو مسودة.

<div id="i-dont-see-a-translate-option-on-my-cart-where-is-it">
  ### لا أرى خيار "Translate" في سلتي. أين هو؟
</div>

يظهر إجراء Translate فقط في جدول **All Carts**، وليس في بطاقة السلة على الصفحة الرئيسية. كما يتطلب أن تكون لديك لغة واحدة على الأقل غير الإنجليزية مفعّلة في متجر Shopify الخاص بك.

للوصول إليه:

1. انتقل إلى Upcart ← All Carts (عبر "Manage all carts" في الصفحة الرئيسية)
2. ابحث عن سلتك في الجدول
3. ابحث عن زر Translate في إجراءات الصف

إذا لم يظهر خيار Translate على الإطلاق، فقد لا تكون لديك لغات إضافية معدّة في Shopify. انتقل إلى Shopify Admin → Settings → Languages لإضافة لغة.