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

# كيف تعمل البلوكات؟

> افهم بلوكات Aftersell Cart: الأقسام والبلوكات الفرعية، الممتلئ مقابل الفارغ، الحدود، البلوكات المقفلة، الشروط، وإعدادات كل بلوك.

تخطيط سلتك هو مجموعة مكدّسة من **البلوكات**: قطع قابلة للتكوين تضيفها وتعيد ترتيبها وتنسّقها وتخصّصها في محرر السلة. البلوكات التي تضمّنها، وترتيبها، هي السلة التي يراها المتسوقون.

لمعرفة كيف تتموضع البلوكات داخل **الحالات** و**الأقسام**، راجع [كيف تعمل السلال؟](/ar/aftersell/cart/how-carts-work)

<div id="blocks-and-sub-blocks">
  ## البلوكات والبلوكات الفرعية
</div>

هناك نوعان من البلوكات:

* **البلوكات** توجد مباشرة في السلة، في أحد ثلاثة أقسام: **Header** أو **Body** أو **Footer**. يوفر كل قسم مجموعة مختلفة من البلوكات.
* **البلوكات الفرعية** تتداخل داخل بلوك آخر. حاليًا فقط [**Cart items**](/ar/aftersell/cart/cart-items-block) يستضيف بلوكات فرعية: صف **Product** (صف عنصر الطلب نفسه)، و[**Subscription upgrade**](/ar/aftersell/cart/subscription-upgrade-block)، و[**Custom code**](/ar/aftersell/cart/custom-code-blocks).

<div id="adding-reordering-and-removing-blocks">
  ## إضافة البلوكات وإعادة ترتيبها وإزالتها
</div>

* **أضف** بلوكًا عبر أداة الاختيار **Add block**. يظهر البلوك باهتًا إذا كان لا يمكن وضعه حيث تضيفه، أو إذا بلغت حدّه (تعرض أداة الاختيار شارة `count/max`).
* **أعد الترتيب** بسحب البلوك داخل قسمه.
* **أزل** بأيقونة سلة المهملات، باستثناء البلوكات المقفلة (أدناه).
* **أظهر/أخفِ** معظم البلوكات بمفتاح العين، الذي يخفي البلوك عن المتسوقين دون حذفه. بعض البلوكات الهيكلية لا يمكن إخفاؤها: **Cart items** و**Checkout button** وصف **Product**.

<div id="locked-blocks">
  ## البلوكات المقفلة
</div>

بعض البلوكات يمكن إعادة ترتيبها لكن لا يمكن حذفها، حتى لا يُحذف سلوك السلة الأساسي (مثل إتمام الشراء) عن طريق الخطأ:

* **Cart items**
* **Checkout button**

<div id="default-blocks">
  ## البلوكات الافتراضية
</div>

تبدأ السلال الجديدة بتخطيط افتراضي جاهز للعمل:

* **السلة الممتلئة:** Header وBanner وCart items وSummary وCheckout button
* **السلة الفارغة:** Header وبلوك Empty cart

<Info>
  **حالة السلة الفارغة** هي التخطيط الفارغ بأكمله. أما **بلوك Empty cart** فهو بلوك واحد داخلها. راجع [كيف تعمل السلال؟](/ar/aftersell/cart/how-carts-work) لمعرفة الفرق.
</Info>

<div id="how-many-of-each-block-you-can-add">
  ## عدد ما يمكنك إضافته من كل بلوك
</div>

تُحتسب الحدود **لكل حالة سلة**، وليس لكل سلة. لكل من السلة الممتلئة والسلة الفارغة حصتها الخاصة، لذا يمكن أن تحمل السلة ثلاثة بلوكات Banner في تخطيطها الممتلئ وثلاثة أخرى في تخطيطها الفارغ.

معظم البلوكات محدودة بواحد لكل حالة. الاستثناءات:

| البلوك         | الحد الأقصى لكل حالة سلة |
| -------------- | ------------------------ |
| Banner         | 3                        |
| Image          | 3                        |
| Product add-on | 3                        |
| Summary        | 2                        |
| Custom code    | غير محدود                |

<div id="content-design-and-code">
  ## Content وDesign وCode
</div>

يُكوَّن كل بلوك من خلال ما يصل إلى ثلاث واجهات في المحرر:

* **Content**: إعدادات البلوك (النص، اختيارات المنتجات، العتبات، وغيرها). بلوك **Custom code** هو الاستثناء الوحيد: لا توجد له لوحة Content لأن البلوك *هو* الكود.
* **Design**: تنسيق على مستوى البلوك يُطبَّق فوق [**إعدادات التصميم**](/ar/aftersell/cart/design-settings) العامة. لكل بلوك واحدة باستثناء **Custom code**، الذي لا توجد له لوحة إعدادات إطلاقًا.
* **Code**: تجاوز العرض المدمج للبلوك عبر [**قالب مخصص**](/ar/aftersell/cart/custom-templates). معظم البلوكات تدعم هذا؛ وقلة لا تدعمه.

<div id="show-or-hide-by-market-country-or-currency">
  ## الإظهار أو الإخفاء حسب السوق أو البلد أو العملة
</div>

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

|                   | **مفتاح العين**                                  | **الشروط**                                           |
| ----------------- | ------------------------------------------------ | ---------------------------------------------------- |
| **ما الذي يفعله** | إخفاء البلوك بأكمله أو إظهاره لجميع المتسوقين    | اختيار نسخة الإعدادات التي يراها المتسوق (أو لا شيء) |
| **بناءً على**     | اختيارك في المحرر                                | سوق Shopify أو بلد العميل أو عملة العميل             |
| **أين**           | أيقونة العين في الشريط الجانبي على معظم البلوكات | لوحة الإعدادات للبلوكات التي تدعم الشروط             |

**أنواع الشروط المدعومة حاليًا:** سوق Shopify وبلد العميل وعملة العميل (كل منها بخيار **In** أو **Not in**). إجمالي السلة ومحتوياتها **ليسا** من أنواع الشروط. استخدم عتبات مستويات [Rewards](/ar/aftersell/cart/rewards-block) لتقدم الإنفاق/الكمية، أو [Cart SDK](/ar/aftersell/cart/sdk-overview) عندما تحتاج قاعدة لا يستطيع المحرر التعبير عنها.

الشروط قائمة مرتبة: **أول شرط مطابق** يفوز. ضع القواعد المحددة فوق قاعدة **All buyers** الشاملة. إذا لم يطابق شيء، لا يعرض البلوك شيئًا لذلك المتسوق.

**في المحرر حاليًا**، تتوفر واجهة الشروط الكاملة في بلوك [**Rewards**](/ar/aftersell/cart/rewards-block#per-market-rewards): مجموعات مستويات مختلفة لكل سوق أو بلد أو عملة. أما البلوكات الأخرى فإما تستخدم إعدادًا واحدًا "لجميع المشترين" أو لا تشارك في هذا النظام بعد.

معاينة المحرر **لا** تقيّم المشتري الفعلي. حدد شرطًا في اللوحة لمعاينة تلك النسخة.

<div id="all-blocks">
  ## جميع البلوكات
</div>

**الهيكل**

* [Header](/ar/aftersell/cart/header-block): العنوان وعدد العناصر والشعار وزر الإغلاق، مثبّتة في الأعلى.
* [Cart items](/ar/aftersell/cart/cart-items-block): العناصر التي يضيفها العملاء إلى السلة؛ يتكرر لكل سطر.
* [Subscription upgrade](/ar/aftersell/cart/subscription-upgrade-block): بلوك فرعي يعرض تحويل سطر إلى اشتراك.
* [Summary](/ar/aftersell/cart/summary-block): الإجماليات والتوفير والخصومات المطبقة.
* [Checkout button](/ar/aftersell/cart/checkout-button-block): دعوة اتخاذ الإجراء الأساسية لإتمام الشراء.
* [Empty cart](/ar/aftersell/cart/empty-cart-block): المحتوى المعروض عندما تكون السلة فارغة.
* [Express payments](/ar/aftersell/cart/express-payments-block): أزرار الدفع السريع (Shop Pay وPayPal وغيرها) داخل السلة.

**الترويج للمنتجات**

* [Upsells](/ar/aftersell/cart/upsells-block): توصيات منتجات مختارة وفق استراتيجية.
* [Product add-on](/ar/aftersell/cart/product-add-on-block): منتج محدد واحد يُعرض كإضافة.
* [Rewards](/ar/aftersell/cart/rewards-block): مكافآت متدرجة مثل الشحن المجاني أو الهدايا.
* [Shipping protection](/ar/aftersell/cart/shipping-protection-block): إضافة حماية شحن اختيارية.

**إدخال المتسوق**

* [Discount code](/ar/aftersell/cart/discount-code-block): حقل لتطبيق رمز خصم.
* [Notes](/ar/aftersell/cart/notes-block): حقل ملاحظات الطلب.

**المحتوى**

* [Banner](/ar/aftersell/cart/banner-block): بانر رسائل، مع مؤقّت عد تنازلي اختياري.
* [Image](/ar/aftersell/cart/image-block): صورة واحدة أو قالب مستضاف جاهز مثل أيقونات الدفع.
* [Custom code](/ar/aftersell/cart/custom-code-blocks): HTML أو React مخصص في أي مكان في السلة.

**التوسيع**

* [القوالب المخصصة](/ar/aftersell/cart/custom-templates): تجاوز طريقة عرض أي بلوك من علامة تبويب Code الخاصة به.

<div id="blocks-available-in-each-section">
  ## البلوكات المتاحة في كل قسم
</div>

لكل قسم مجموعة مختلفة من البلوكات المتاحة. هذا يُبقي التخطيط مركّزًا ويقلل الفوضى.

| القسم      | البلوكات المتاحة                                                                                                                                    |
| ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Header** | Header وBanner وRewards وImage وCustom code                                                                                                         |
| **Body**   | Banner وNotes وDiscount code وCart items وEmpty cart وCustom code وRewards وProduct add-on وShipping protection وImage وUpsells                     |
| **Footer** | Banner وNotes وDiscount code وCustom code وRewards وProduct add-on وShipping protection وExpress payments وImage وUpsells وSummary وCheckout button |

بعض تلك البلوكات خاص بحالة معينة (مثل Empty cart في الحالة الفارغة فقط). راجع [كيف تعمل السلال؟](/ar/aftersell/cart/how-carts-work)

<div id="block-validation-errors">
  ## أخطاء التحقق من صحة البلوكات
</div>

إذا احتوت إعدادات بلوك على قيمة غير صالحة، تظهر نقطة حمراء صغيرة بجوار اسم ذلك البلوك في الشريط الجانبي. تبقى النقطة حتى تصلح المشكلة. وهي ليست إشعارًا يمكن تجاهله.

طالما وُجد خطأ في أي بلوك، **يُمنع الحفظ**. يبقى زر **Save** قابلًا للنقر، لكن تحديده يعرض رسالة خطأ (*"Fix the errors in your cart blocks before saving"*) وينتقل إلى أول بلوك فيه مشكلة، فاتحًا إعداداته لتصحيح الحقل المميّز. أما **Publish** فيتطلب إضافة إلى ذلك عدم وجود تغييرات غير محفوظة، لذا يبقى غير متاح حتى ينجح حفظ نظيف.

بمجرد تصحيح الحقل غير الصالح تختفي النقطة من تلقاء نفسها، ويجري الحفظ بشكل طبيعي.

<Note>
  البلوكات المخفية تخضع للتحقق أيضًا. يمكن لبلوك أخفيته أن يحمل إعدادًا غير صالح ويعرض نقطة خطأ ويمنع الحفظ تمامًا مثل البلوك المرئي، فإذا كان الحفظ ممنوعًا وكل البلوكات المرئية تبدو سليمة، فافحص بلوكاتك المخفية.
</Note>