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

# Personalizzare il formato della valuta in Upcart

> Controlla come viene visualizzata la valuta nel tuo carrello usando Shopify Markets e impostazioni di script personalizzate.

<div id="overview">
  # Panoramica
</div>

Questa personalizzazione ti permette di cambiare il modo in cui i simboli e i codici di valuta appaiono nel cart drawer di Upcart. Puoi decidere se mostrare il simbolo di valuta (ad esempio `$`), il codice valuta (ad esempio `USD`), dove appaiono e come sono spaziati.

Questa configurazione richiede che:

* Il tuo negozio utilizzi **Shopify Markets**, oppure
* Tu stia lavorando con un **solo mercato**

***

<div id="where-to-add-the-script">
  ## Dove aggiungere lo script
</div>

1. Vai a **Upcart > Cart Editor > Settings > Custom HTML**
2. Dal menu a tendina **Select HTML Location**, scegli **Scripts (Before load)**
3. Incolla lo script qui sotto nel campo di input
4. Salva le modifiche

***

<div id="currency-formatting-script">
  ## Script per il formato della valuta
</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">
  ## Spiegazione delle impostazioni
</div>

All'interno dello script, cerca questa sezione:

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

Puoi modificare questi valori per controllare come la valuta appare nel carrello:

|                             |                                                                     |                                                                                         |
| --------------------------- | ------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
| Impostazione                | Descrizione                                                         | Opzioni                                                                                 |
| **useCurrencySymbol**       | Mostra o nasconde il simbolo di valuta (esempio: `$`)               | `true` / `false`                                                                        |
| **useCurrencyCode**         | Mostra o nasconde il codice valuta (esempio: `USD`)                 | `true` / `false`                                                                        |
| **currencySymbolPlacement** | Dove appare il simbolo                                              | `'left'` / `'right'`                                                                    |
| **currencyCodePlacement**   | Dove appare il codice                                               | `'left'` / `'right'`                                                                    |
| **currencySymbolSpacing**   | Aggiunge uno spazio tra il simbolo e l'importo (esempio: `$ 10.00`) | `true` / `false`                                                                        |
| **currencyCodeSpacing**     | Aggiunge uno spazio tra il codice e l'importo (esempio: `10 USD`)   | `true` / `false`                                                                        |
| **currencyFormat**          | Controlla la formattazione dei numeri                               | `{{amount}}`, `{{amount_no_decimals}}`, ecc. (consulta le opzioni di valuta di Shopify) |

***

<div id="final-result">
  ## Risultato finale
</div>

Una volta aggiunto e salvato lo script:

* I simboli e i codici di valuta vengono visualizzati esattamente come configurati
* Funziona in tutte le parti del drawer di Upcart, inclusi premi e upsell
* Si adatta automaticamente a **Shopify Markets** se sono abilitati

***

<div id="need-help">
  ## Hai bisogno di aiuto?
</div>

Per personalizzazioni avanzate, ti consigliamo di collaborare con un **esperto Shopify**. Il team di supporto di Upcart non fornisce assistenza nella scrittura o nella risoluzione di problemi di codice personalizzato.

[Vedi gli esperti Shopify](https://www.shopify.com/partners/directory)