> ## 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 드로어의 모든 부분에서 작동해요
* **Shopify Markets**가 활성화되어 있으면 자동으로 적응해요

***

<div id="need-help">
  ## 도움이 필요하신가요?
</div>

고급 커스터마이징은 **Shopify Expert**와 협업하는 것을 권장해요. Upcart 지원팀은 커스텀 코드 작성이나 문제 해결을 지원하지 않아요.

[Shopify Experts 보기](https://www.shopify.com/partners/directory)