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

# بلوك رمز الخصم

> بلوك Discount code في Aftersell Cart — دع المتسوقين يدخلون رمز خصم ويطبقونه قبل إتمام الشراء.

> بلوك **Discount code** هو حقل إدخال يمكن للمتسوقين فيه إدخال رمز ترويجي وتطبيقه في السلة، ليروا الخصم منعكسًا قبل الالتزام بإتمام الشراء.

<Frame>
  <img src="https://mintcdn.com/aftersell/1Y3gBpUfxv16VGSW/images/aftersell/cart-discount-code-block-input-apply.png?fit=max&auto=format&n=1Y3gBpUfxv16VGSW&q=85&s=ac5730766b756fdf99c2fc9f65ac202b" alt="بلوك رمز الخصم مع حقل إدخال وزر Apply في درج السلة" width="1314" height="230" data-path="images/aftersell/cart-discount-code-block-input-apply.png" />
</Frame>

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

* عند التطبيق، يُشذّب الرمز ويُحوَّل إلى أحرف كبيرة ويُرسل إلى Shopify. ولأن Shopify يقبل الطلب سواء كان الرمز صالحًا أم لا، يعيد البلوك بعدها فحص السلة للتأكد من أن الرمز طُبّق فعلًا.
  * **صالح** ← يُمسح الحقل ويُطبَّق الخصم.
  * **غير صالح** ← يعرض البلوك "Invalid discount code."
* كيفية تراكب الرمز مع الخصومات الأخرى (الخصومات التلقائية، الرموز الأخرى) يتولاها Shopify بالكامل — البلوك يطبّق الرمز فحسب.
* تُعرض الرموز المطبقة في بلوك [**Summary**](/ar/aftersell/cart/summary-block)، وليس هنا.

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

| الإعداد         | ما الذي يتحكم فيه                       | القيمة الافتراضية |
| --------------- | --------------------------------------- | ----------------- |
| **Placeholder** | النص النائب لحقل الإدخال. قابل للترجمة. | `Discount code`   |
| **Button text** | تسمية زر التطبيق. قابلة للترجمة.        | `Apply`           |

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

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

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

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

| الخاصية                | النوع                     | الغرض منها                                                               |
| ---------------------- | ------------------------- | ------------------------------------------------------------------------ |
| `discountCodeInput`    | `string`                  | القيمة الحالية لحقل الإدخال.                                             |
| `placeholder`          | `string`                  | النص النائب المعروض في الحقل الفارغ.                                     |
| `buttonText`           | `string`                  | تسمية زر التطبيق.                                                        |
| `isValidating`         | `boolean`                 | تكون `true` أثناء التحقق من رمز مُرسل. عطّل زر الإرسال لديك بناءً عليها. |
| `isInvalid`            | `boolean`                 | تكون `true` عندما رُفض آخر رمز مُرسل.                                    |
| `setDiscountCodeInput` | `(value: string) => void` | يحدّث قيمة حقل الإدخال.                                                  |
| `handleSubmit`         | `(event: Event) => void`  | يرسل الرمز الحالي.                                                       |
| `isLoading`            | `boolean`                 | تكون `true` أثناء إجراء السلة جلبها الأول.                               |

<Warning>
  اربط كلًا من `setDiscountCodeInput` و`handleSubmit`. بدون الأولى، لا يمكن الكتابة في الحقل؛ وبدون الثانية، لا يُطبَّق أي رمز أبدًا.
</Warning>

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

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

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