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

# كتلة الملخص

> كتلة Summary في سلة Aftersell: الإجماليات والتوفير وأكواد الخصم المطبقة.

> تعرض كتلة **Summary** للمتسوق ما سيدفعه: صف إجمالي مع توفير اختياري، بالإضافة إلى وسوم الخصم المطبقة. وهي تلخّص إجماليات السلة والتوفير مباشرة فوق زر الدفع، بحيث يرى المتسوقون المحصلة النهائية قبل الالتزام.

<Frame>
  <img src="https://mintcdn.com/aftersell/1Y3gBpUfxv16VGSW/images/aftersell/cart-summary-block-subtotal-savings-applied-discounts.png?fit=max&auto=format&n=1Y3gBpUfxv16VGSW&q=85&s=455f22040697c41fd1e02a870e9cccf8" alt="كتلة الملخص تعرض المجموع الفرعي والتوفير والخصومات المطبقة قبل الدفع" width="1368" height="250" data-path="images/aftersell/cart-summary-block-subtotal-savings-applied-discounts.png" />
</Frame>

<div id="behavior">
  ## السلوك
</div>

* **رموز التوفير تنطوي بسلاسة.** إذا أشارت خلية إلى `{{savings}}` أو `{{pre_savings_price}}` لكن السلة لا تحتوي على توفير، فإن تلك الخلية تعود إلى `{{total_price}}` فقط، بحيث لا يرى المتسوقون أبدًا "خصم 0.00\$" أو سعرًا مشطوبًا مساويًا للإجمالي. إذا جمعت `{{cart_item_count}}` و `{{savings}}` في نفس الخلية، فسيُزال عدد العناصر أيضًا في حالة عدم وجود توفير — ضعهما في خليتين منفصلتين لتجنب ذلك.
* تظهر وسوم الخصم فقط عندما يكون **Show discount codes** مفعّلًا *و* كانت السلة تحتوي على خصومات لعرضها. يشمل ذلك الخصومات القائمة على الأكواد والخصومات التلقائية على حد سواء.

<div id="settings">
  ## الإعدادات
</div>

| الإعداد                 | ما الذي يتحكم فيه                                                                                           | الافتراضي                     |
| ----------------------- | ----------------------------------------------------------------------------------------------------------- | ----------------------------- |
| **Left text**           | الخلية اليسرى من صف الإجمالي. نص منسق مع رموز. مثال: `Subtotal ({{cart_item_count}} items)`.                | `Subtotal`                    |
| **Right text**          | الخلية اليمنى. نص منسق مع رموز (الإجمالي، السعر المشطوب قبل التوفير، التوفير، عدد العناصر).                 | الإجمالي مع ترميز توفير مشطوب |
| **Savings format**      | عرض التوفير كنسبة `percent` كاملة أو كمبلغ `absolute`.                                                      | `percent`                     |
| **Show discount codes** | ما إذا كانت وسوم الخصم المطبقة تظهر. يشمل ذلك الخصومات القائمة على الأكواد والخصومات التلقائية على حد سواء. | مفعّل                         |

تدعم خلايا النص الرموز `{{cart_item_count}}` و `{{total_price}}` و `{{pre_savings_price}}` و `{{savings}}`.

<div id="placement-and-limits">
  ## الموضع والحدود
</div>

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

<div id="custom-template">
  ## القالب المخصص
</div>

تدعم [قالبًا مخصصًا](/ar/aftersell/cart/custom-templates) من تبويب Code الخاص بها، والذي يستبدل ترميز هذه الكتلة المدمج بـ JSX الخاص بك. هذه هي الخصائص التي تستقبلها.

| الخاصية             | النوع      | ما هي لأجله                                                                                        |
| ------------------- | ---------- | -------------------------------------------------------------------------------------------------- |
| `leftHtml`          | `string`   | الخلية اليسرى كـ HTML معقَّم، مع حل الرموز.                                                        |
| `rightHtml`         | `string`   | الخلية اليمنى كـ HTML معقَّم، مع حل الرموز.                                                        |
| `discountCodes`     | `string[]` | عناوين الخصومات المطبقة على السلة (القائمة على الأكواد والتلقائية). `[]` عند عدم وجودها.           |
| `showDiscountCodes` | `boolean`  | ما إذا كان التاجر يريد سرد وسوم الخصم **و** كانت السلة تحتوي على خصومات لعرضها.                    |
| `hasSavings`        | `boolean`  | `true` عندما تحتوي السلة على توفير. استخدمها لإخفاء صف التوفير الخاص بك.                           |
| `totalPrice`        | `string`   | إجمالي السلة، منسّق مسبقًا.                                                                        |
| `preSavingsPrice`   | `string`   | الإجمالي قبل التوفير، منسّق مسبقًا.                                                                |
| `savings`           | `string`   | المبلغ الموفَّر. منسّق مسبقًا، **أو نسبة مئوية** مثل `15%`، بحسب إعداد تنسيق التوفير لدى التاجر.   |
| `itemCount`         | `number`   | إجمالي الوحدات في السلة — مجموع كميات الأسطر المرئية، باستثناء سطر حماية الشحن.                    |
| `isLoading`         | `boolean`  | دائمًا `false` هنا: تعرض الكتلة هيكلها المدمج أثناء التحميل ولا تستدعي قالبك إلا بعد جاهزية السلة. |

<Warning>
  نظرًا لأن `savings` قد تكون مبلغًا أو نسبة مئوية، لا تبنِ جملتك الخاصة حولها بافتراض أحدهما. `{props.savings}` بمفردها آمنة؛ أما `You saved ${props.savings}` فليست كذلك.
</Warning>

<div id="design">
  ## التصميم
</div>

صمّم هذه الكتلة عبر قسم **Design** الخاص بها في لوحة الإعدادات. هذه تجاوزات لكل كتلة تُطبَّق فوق تصميمك العام وتعود إليه عندما تكون فارغة.

ما هي إعدادات التصميم؟ اعرف المزيد هنا: [إعدادات التصميم](/ar/aftersell/cart/design-settings).