> ## 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 درج سلة القالب الخاص بك بصريًا، لكنه **لا يتكامل مع درج سلة القالب أو صفحة السلة**. ستظل صفحة سلة Shopify متاحة للوصول.

<div id="managing-modules">
  # **إدارة الوحدات**
</div>

يمكن **تمكين أو تعطيل** كل وحدة من وحدات Upcart **بسهولة**. ما عليك سوى النقر على زر **Enable/Disable** في الزاوية العلوية اليمنى لتشغيل الوحدة أو إيقافها في أي وقت. تسري تغييراتك فورًا بمجرد الحفظ.

<img src="https://mintcdn.com/aftersell/uVGuDiyXpd6WOLO4/images/upcart/quickstart-announcements-module-row-disabled.png?fit=max&auto=format&n=uVGuDiyXpd6WOLO4&q=85&s=454a834d8ea953a99ba987dfdb80499a" alt="صف وحدة الإعلانات معلَّم بحالة Disabled مع سهم يشير إلى زر Enable" width="1548" height="210" data-path="images/upcart/quickstart-announcements-module-row-disabled.png" />

<div id="cart-design">
  # تصميم السلة
</div>

عند فتح Cart Editor في Upcart لأول مرة، ستصل إلى [وحدة التصميم](/ar/upcart/design_module). هنا يمكنك تخصيص الألوان الأساسية للدرج لتتوافق مع هوية متجرك.

<img src="https://mintcdn.com/aftersell/uVGuDiyXpd6WOLO4/images/upcart/quickstart-cart-editor-design-module.png?fit=max&auto=format&n=uVGuDiyXpd6WOLO4&q=85&s=e15c4d0893916f9200cf1884c1d0adfe" alt="وحدة Design في Cart Editor الخاص بـ Upcart مع إعدادات الألوان بجانب معاينة مباشرة لدرج السلة" width="600" data-path="images/upcart/quickstart-cart-editor-design-module.png" />

<div id="announcements">
  # الإعلانات
</div>

لعرض رسالة في السلة أو مؤقت عد تنازلي، انتقل إلى **Body > [Announcements](/ar/upcart/announcements_module)**.

في الزاوية العلوية اليمنى، انقر على **Enable**. تتغير الشارة بجانب اسم الوحدة من **Disabled** إلى **Active**.

أدخل رسالتك في حقل **Announcement Text** واضبط المؤقت إذا لزم الأمر.

<img src="https://mintcdn.com/aftersell/uVGuDiyXpd6WOLO4/images/upcart/quickstart-announcement-settings-timer-text.png?fit=max&auto=format&n=uVGuDiyXpd6WOLO4&q=85&s=2a726b39f6ea92d5899e2aae2968c2d1" alt="إعدادات الإعلان مع المؤقت وحقل نص الإعلان وخيارات الألوان" width="645" height="679" data-path="images/upcart/quickstart-announcement-settings-timer-text.png" />

تأكد من استخدام المتغير `{TIMER}` للعد التنازلي داخل نص إعلانك لضمان عمله بشكل صحيح (مثال: "هذا العرض متاح فقط لمدة {TIMER}.") تجنّب نسخ نص منسّق مباشرةً من أدوات خارجية.

بعد الانتهاء، تأكد من النقر على **Save** في الزاوية العلوية اليمنى.

<div id="theme-level-issues">
  #### مشكلات على مستوى القالب
</div>

* **تعارضات CSS أو التطبيقات:** تأكد من أن خصائص CSS مثل `display: none;` لا تُخفي شريط الإعلانات. تحقق أيضًا من أن التطبيقات الخارجية لا تتجاوز هذه الإعدادات.
* **وضوح النص:** تأكد من أن لون نص شريط الإعلانات متباين مع الخلفية، وعدّله في إعدادات القالب إذا لزم الأمر.

<div id="advanced-debugging-steps">
  #### خطوات تصحيح متقدمة
</div>

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

<div id="rewards">
  # المكافآت
</div>

لعرض شريط تقدم يشجّع العملاء على إنفاق المزيد، مكّن وحدة المكافآت (Rewards Module).

<div id="general-settings">
  ### **الإعدادات العامة**
</div>

اضبط ألوان علامتك التجارية والرسالة التي تظهر بعد الوصول إلى مستوى المكافأة الأخير.

اختر أساس المكافأة في بطاقة **Rewards calculation** أسفل الإعدادات العامة:

* **Cart total (\$)**: يتتبع القيمة الإجمالية للسلة
* **Cart quantity (#)**: يتتبع كمية المنتجات

<img src="https://mintcdn.com/aftersell/uVGuDiyXpd6WOLO4/images/upcart/quickstart-rewards-module-general-settings.png?fit=max&auto=format&n=uVGuDiyXpd6WOLO4&q=85&s=d702c06541f1304d2d2e742f79d62140" alt="الإعدادات العامة لوحدة المكافآت مع ألوان الشريط وحقول رسالة الإكمال" width="600" data-path="images/upcart/quickstart-rewards-module-general-settings.png" />

<div id="tier-settings">
  ### **إعدادات المستويات**
</div>

اختر نوع المكافأة:

* [**Shipping**](https://help.shopify.com/en/manual/fulfillment/setup/shipping-rates/flat-shipping-rates): يفتح الشحن المجاني عند المستوى
* [**Discount**](https://help.shopify.com/en/manual/discounts/discount-types): يفتح خصمًا عند المستوى
* [**Product**](/ar/upcart/set_up_a_free_product_reward_tier_in_upcart): يضيف منتجًا إلى السلة

يتم تحديد ما إذا كان تقدم المستويات يُقاس قبل الخصومات أو بعدها مرة واحدة للشريط بأكمله، عبر مربع الاختيار **Use pre-discounted prices for cart total** في **Rewards calculation** — وهو ليس خاصية لنوع المكافأة.

حدد حدًا أدنى لتفعيل المكافأة وخصّص حقل **Title before achieving tier**. يمكنك إنشاء ما يصل إلى **أربعة مستويات مكافآت**.

<img src="https://mintcdn.com/aftersell/uVGuDiyXpd6WOLO4/images/upcart/quickstart-rewards-settings-reward-type.png?fit=max&auto=format&n=uVGuDiyXpd6WOLO4&q=85&s=2085093e9f85cdd42ed163fab7d726db" alt="إعدادات المستوى مع قائمة اختيار نوع المكافأة والحد الأدنى للمبلغ وحقول عنوان المستوى" width="600" data-path="images/upcart/quickstart-rewards-settings-reward-type.png" />

<Note>
  تسبق لقطة الشاشة هذه التسميات الحالية: فهي تعرض القسم باسم "Rewards settings" والحقل باسم "Text before achieving". عناصر التحكم هي نفسها — وهي تظهر الآن باسم **Tier settings** و**Title before achieving tier**.
</Note>

<div id="upsells">
  # عروض البيع الإضافي (Upsells)
</div>

مكّن **Use AI Recommended Upsells**، واختر خوارزمية **Related**، وشغّل **Smart Variant Matching** لتحديد خيارات المنتجات المطابقة مسبقًا بناءً على محتويات السلة.

<img src="https://mintcdn.com/aftersell/uVGuDiyXpd6WOLO4/images/upcart/quickstart-upsells-settings-ai-recommended.png?fit=max&auto=format&n=uVGuDiyXpd6WOLO4&q=85&s=65cddd8e07bfe9e9805ce76e43377ab3" alt="إعدادات Upsells مع تمكين عروض البيع الإضافي الموصى بها بالذكاء الاصطناعي وخوارزمية Related والمطابقة الذكية للخيارات" width="600" data-path="images/upcart/quickstart-upsells-settings-ai-recommended.png" />

خصّص عنوان القسم وتسمية زر **Add**.

<img src="https://mintcdn.com/aftersell/uVGuDiyXpd6WOLO4/images/upcart/quickstart-upsell-fields-maximum-upsells.png?fit=max&auto=format&n=uVGuDiyXpd6WOLO4&q=85&s=58ad7bd0311baa003f3ea5dae376505d" alt="حقول Upsell للحد الأقصى من عروض البيع الإضافي المعروضة ونص عنوان القسم" width="600" data-path="images/upcart/quickstart-upsell-fields-maximum-upsells.png" />

<div id="add-ons">
  # الإضافات (Add-ons)
</div>

لعرض إضافة قائمة على مفتاح تبديل في التذييل، يمكنك تمكين أي من هذين الخيارين:

<div id="shipping-protection">
  ### **حماية الشحن**
</div>

اختر **Shipping Protection** واضبط مستويات تسعير ديناميكية بناءً على قيمة السلة.\
يؤدي هذا إلى إنشاء منتج حقيقي في كتالوج Shopify الخاص بك.

<img src="https://mintcdn.com/aftersell/uVGuDiyXpd6WOLO4/images/upcart/quickstart-shipping-protection-add-settings.png?fit=max&auto=format&n=uVGuDiyXpd6WOLO4&q=85&s=a8432cf06443d21b7c341a0942ef7d7e" alt="إعدادات إضافة Shipping Protection مع العنوان والوصف ومستويات التسعير" width="862" height="708" data-path="images/upcart/quickstart-shipping-protection-add-settings.png" />

<div id="product-add-on">
  ### **إضافة منتج**
</div>

انتقل إلى تبويب **Product Add-On** واختر منتجًا موجودًا لعرضه كبيع إضافي.

<img src="https://mintcdn.com/aftersell/uVGuDiyXpd6WOLO4/images/upcart/quickstart-product-add-on-energy-drink.png?fit=max&auto=format&n=uVGuDiyXpd6WOLO4&q=85&s=d7eaf37fa102b147636bfae244fef54c" alt="تبويب إضافة المنتج مع منتج Energy Drink محدد وزر Change Product" width="862" height="428" data-path="images/upcart/quickstart-product-add-on-energy-drink.png" />

<div id="activating-upcart-on-your-store">
  # تفعيل Upcart على متجرك
</div>

<div id="step-one-make-your-cart-live">
  ### الخطوة الأولى: اجعل سلتك مباشرة
</div>

بمجرد الانتهاء من ضبط كل شيء، انتقل إلى **Manage All Carts** > اختر السلة التي تريد تفعيلها > انقر على **Publish**.

بمجرد النشر، تنتقل السلة إلى القسم المباشر في جدول السلات. تعرض شارة تحذير **"App embed off"** حتى تقوم بتمكين تضمين تطبيق Upcart في قالبك، وهي الخطوة التالية. مع تشغيل التضمين، تتحول الشارة إلى شارة خضراء **"Live"** تؤكد أن السلة تظهر على واجهة متجرك.

<Note>
  يتحكم تضمين التطبيق (app embed) في ما إذا كان درج سلة Upcart يظهر على واجهة متجرك. إذا كانت لديك خصومات مضبوطة، تظل هذه القواعد نشطة عبر نظام خصومات Shopify حتى عند تعطيل تضمين التطبيق.
</Note>

<img src="https://mintcdn.com/aftersell/uVGuDiyXpd6WOLO4/images/upcart/quickstart-publish-cart-confirmation.gif?s=e8cc3d709577ee5a1ab9848afb9f6269" alt="نشر سلة في Upcart مع فتح مربع حوار تأكيد النشر" width="2008" height="1080" data-path="images/upcart/quickstart-publish-cart-confirmation.gif" />

<div id="step-two-enable-theme-app-embed">
  ### **الخطوة الثانية: تمكين تضمين التطبيق في القالب**
</div>

لتفعيل Upcart على قالبك، انتقل إلى **Shopify Admin → Online Store → Themes → Customize → App embeds**، ومكّن تضمين تطبيق **Upcart**، ثم انقر على **Save**.

<img src="https://mintcdn.com/aftersell/uVGuDiyXpd6WOLO4/images/upcart/quickstart-app-embed-toggle.gif?s=9244c8509f67622ebb4e1cc2af7ecebb" alt="تمكين مفتاح Upcart Cart Drawer في لوحة App embeds بقالب Shopify" width="1352" height="1080" data-path="images/upcart/quickstart-app-embed-toggle.gif" />

إذا واجهت أي مشكلات أو صادفت مشاكل في التوافق، فلا تتردد في التواصل مع **دردشة الدعم** للحصول على المساعدة.
