Formati di visualizzazione della valuta
Hello supporta i seguenti formati di visualizzazione della valuta:
symbol(predefinito) - Visualizza un simbolo di valuta localizzato, ad es.€123.code- Usa il codice valuta ISO, ad es.123 USD.name- Visualizza il nome localizzato della valuta, ad es.123 dollars.
Puoi sovrascrivere il formato di visualizzazione della valuta usando la proprietà overrideCurrencyFormat nel metodo Zonos.init. Questa proprietà accetta uno dei formati di visualizzazione della valuta elencati sopra. La sovrascrittura del formato di visualizzazione della valuta si applica sia a Hello sia a Zonos Checkout.
Zonos.init({ overrideCurrencyFormat: 'code',});Usare un converter di valuta personalizzato
Nei casi in cui la semplice sovrascrittura del formato di visualizzazione della valuta non è sufficiente per le esigenze del tuo sito, puoi usare un converter di valuta personalizzato per gestire la conversione e la formattazione degli importi in valuta estera. Questo approccio ti consente di avere il pieno controllo su come gli importi in valuta vengono visualizzati sul tuo sito.
Per usare un converter di valuta personalizzato, devi implementare la funzione currencyConverter nel metodo Zonos.init. Questa funzione deve accettare i seguenti parametri:
convertAndFormat- Una funzione che converte e formatta l’importo in valuta.originalAmount- L’importo originale in valuta.selector- Il selettore dell’elemento che contiene l’importo in valuta.
Quando presente, la funzione currencyConverter eseguirà un ciclo su tutti i selettori di prezzo corrispondenti sul tuo sito e applicherà la logica di conversione di valuta personalizzata a ciascuno.
Un caso d’uso comune per una funzione di converter di valuta personalizzato è quando hai prezzi visualizzati in un menu a discesa o in altri elementi HTML complessi. Ad esempio, se hai un menu a discesa con prezzi visualizzati accanto a ciascuna opzione, come:
Blue - $1.99 Red - $2.00 Yellow - $3.59 In casi come questo, non puoi semplicemente selezionare il prezzo direttamente perché c’è testo aggiuntivo accanto. Usando un converter di valuta personalizzato, puoi estrarre il prezzo dall’elemento e applicarvi la logica di conversione di valuta.
window.Zonos.init({ currencyConverter: ({ convertAndFormat, originalAmount, selector }) => { const optionValue = selector.getAttribute('data-select-option'); if (optionValue) { return `${optionValue} - ${convertAndFormat(originalAmount)}`; } return convertAndFormat(originalAmount); },});
Personalizza la valuta visualizzata
Sovrascrivi come Hello visualizza gli importi in valuta estera.
Puoi adattare la presentazione delle valute estere alle tue esigenze e preferenze personalizzando il formato di visualizzazione della valuta nella tua integrazione JavaScript.