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

> تحكم في طريقة عرض العملة في سلتك باستخدام Shopify Markets وإعدادات السكربت المخصص.

<div id="overview">
  # نظرة عامة
</div>

يتيح لك هذا التخصيص تغيير كيفية ظهور رموز وأكواد العملة في درج سلة Upcart. يمكنك التحكم في إظهار رمز العملة (مثل `$`)، أو كود العملة (مثل `USD`)، ومكان ظهورهما، وكيفية توزيع المسافات بينهما.

يتطلب هذا الإعداد ما يلي:

* أن يستخدم متجرك **Shopify Markets**، أو
* أن تعمل مع **سوق واحد**

***

<div id="where-to-add-the-script">
  ## أين تضيف السكربت
</div>

1. انتقل إلى **Upcart > Cart Editor > Settings > Custom HTML**
2. من القائمة المنسدلة **Select HTML Location**، اختر **Scripts (Before load)**
3. الصق السكربت أدناه في حقل الإدخال
4. احفظ تغييراتك

***

<div id="currency-formatting-script">
  ## سكربت تنسيق العملة
</div>

```html theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
<!-- Upcart Currency Formatting Script -->
<script>
// ~~~~~~START OF MERCHANT SETTINGS~~~~~~
let useCurrencySymbol = true;
let useCurrencyCode = true;
let currencySymbolPlacement = 'left';     // 'left' or 'right'
let currencyCodePlacement = 'right';      // 'left' or 'right'
let currencySymbolSpacing = false;
let currencyCodeSpacing = true;
let currencyFormat = "{{amount}}";        // Use Shopify's currency format
// ~~~~~~END OF MERCHANT SETTINGS~~~~~~

formatCurrency();

function formatCurrency() {
  let currencyMap = fillCurrencyMap(new Map());
  let currencyCode = Shopify.currency.active;
  let currencySymbol = currencyMap.get(currencyCode);

  if (currencySymbolPlacement == 'left' && currencyCodePlacement == 'left') {
    window.upcartMoneyFormat =
      (useCurrencyCode ? currencyCode : "") +
      (currencyCodeSpacing && useCurrencyCode ? " " : "") +
      (useCurrencySymbol ? currencySymbol : "") +
      (currencySymbolSpacing && useCurrencySymbol ? " " : "") +
      currencyFormat;

  } else if (currencySymbolPlacement == 'left' && currencyCodePlacement == 'right') {
    window.upcartMoneyFormat =
      (useCurrencySymbol ? currencySymbol : "") +
      (currencySymbolSpacing && useCurrencySymbol ? " " : "") +
      currencyFormat +
      (currencyCodeSpacing && useCurrencyCode ? " " : "") +
      (useCurrencyCode ? currencyCode : "");

  } else if (currencySymbolPlacement == 'right' && currencyCodePlacement == 'right') {
    window.upcartMoneyFormat =
      currencyFormat +
      (currencyCodeSpacing && useCurrencyCode ? " " : "") +
      (useCurrencyCode ? currencyCode : "") +
      (currencySymbolSpacing && useCurrencySymbol ? " " : "") +
      (useCurrencySymbol ? currencySymbol : "");

  } else if (currencySymbolPlacement == 'right' && currencyCodePlacement == 'left') {
    window.upcartMoneyFormat =
      (useCurrencyCode ? currencyCode : "") +
      (currencyCodeSpacing && useCurrencyCode ? " " : "") +
      currencyFormat +
      (currencySymbolSpacing && useCurrencySymbol ? " " : "") +
      (useCurrencySymbol ? currencySymbol : "");

  } else {
    console.warn("Unexpected placement configuration. Falling back to default.");
    window.upcartMoneyFormat =
      (useCurrencySymbol ? currencySymbol : "") +
      (currencySymbolSpacing && useCurrencySymbol ? " " : "") +
      currencyFormat +
      (currencyCodeSpacing && useCurrencyCode ? " " : "") +
      (useCurrencyCode ? currencyCode : "");
  }
}

function fillCurrencyMap(map) {
  map.set('EUR', '€');
  map.set('GBP', '£');
  map.set('JPY', '¥');
  map.set('AUD', '$');
  map.set('CAD', '$');
  map.set('CHF', 'CHF');
  map.set('CNY', '¥');
  map.set('INR', '₹');
  map.set('RUB', '₽');
  map.set('BRL', 'R$');
  map.set('ZAR', 'R');
  map.set('MXN', '$');
  map.set('SGD', '$');
  map.set('NZD', '$');
  map.set('HKD', 'HK$');
  return map;
}
</script>
```

***

<div id="settings-explained">
  ## شرح الإعدادات
</div>

داخل السكربت، ابحث عن هذا القسم:

```
// ~~~~~~START OF MERCHANT SETTINGS~~~~~~
```

يمكنك ضبط هذه القيم للتحكم في كيفية ظهور العملة في السلة:

|                             |                                                |                                                                              |
| --------------------------- | ---------------------------------------------- | ---------------------------------------------------------------------------- |
| الإعداد                     | الوصف                                          | الخيارات                                                                     |
| **useCurrencySymbol**       | إظهار أو إخفاء رمز العملة (مثال: `$`)          | `true` / `false`                                                             |
| **useCurrencyCode**         | إظهار أو إخفاء كود العملة (مثال: `USD`)        | `true` / `false`                                                             |
| **currencySymbolPlacement** | مكان ظهور الرمز                                | `'left'` / `'right'`                                                         |
| **currencyCodePlacement**   | مكان ظهور الكود                                | `'left'` / `'right'`                                                         |
| **currencySymbolSpacing**   | يضيف مسافة بين الرمز والمبلغ (مثال: `$ 10.00`) | `true` / `false`                                                             |
| **currencyCodeSpacing**     | يضيف مسافة بين الكود والمبلغ (مثال: `10 USD`)  | `true` / `false`                                                             |
| **currencyFormat**          | يتحكم في تنسيق الأرقام                         | `{{amount}}`، `{{amount_no_decimals}}`، إلخ. (راجع خيارات العملة في Shopify) |

***

<div id="final-result">
  ## النتيجة النهائية
</div>

بمجرد إضافة السكربت وحفظه:

* تظهر رموز وأكواد العملة تمامًا كما تم تكوينها
* يعمل عبر جميع أجزاء درج Upcart، بما في ذلك المكافآت والعروض الإضافية (upsells)
* يتكيف مع **Shopify Markets** تلقائيًا إذا كانت مفعّلة

***

<div id="need-help">
  ## بحاجة إلى مساعدة؟
</div>

للتخصيص المتقدم، نوصي بالعمل مع **خبير Shopify**. لا يقدم فريق دعم Upcart المساعدة في كتابة الكود المخصص أو استكشاف أخطائه وإصلاحها.

[اطلع على خبراء Shopify](https://www.shopify.com/partners/directory)