Personalizar moeda de exibição

Você pode adaptar a apresentação de moedas estrangeiras conforme suas necessidades e preferências personalizando o formato de exibição de moeda na sua integração JavaScript.

Formatos de exibição de moeda 

O Hello oferece suporte aos seguintes formatos de exibição de moeda:

• symbol (padrão) - Exibe um símbolo de moeda localizado, por exemplo, €123.
• code - Usa o código de moeda ISO, por exemplo, 123 USD.
• name - Exibe o nome da moeda localizado, por exemplo, 123 dollars.

Você pode substituir o formato de exibição de moeda usando a propriedade overrideCurrencyFormat no método Zonos.init. Essa propriedade aceita um dos formatos de exibição de moeda listados acima. Substituir o formato de exibição de moeda se aplica tanto ao Hello quanto ao Zonos Checkout.

Usar um conversor de moeda personalizado 

Nos casos em que simplesmente substituir o formato de exibição de moeda não seja suficiente para as necessidades do seu site, você pode usar um conversor de moeda personalizado para gerenciar a conversão e a formatação de valores em moeda estrangeira. Essa abordagem permite controle total sobre como os valores de moeda são exibidos no seu site.

Para usar um conversor de moeda personalizado, você precisa implementar a função currencyConverter no método Zonos.init. Essa função deve aceitar os seguintes parâmetros:

• convertAndFormat - Uma função que converte e formata o valor da moeda.
• originalAmount - O valor original da moeda.
• selector - O seletor do elemento que contém o valor da moeda.

Quando presente, a função currencyConverter percorrerá todos os seletores de preço correspondentes no seu site e aplicará a lógica de conversão de moeda personalizada a cada um.

Um caso de uso comum para usar uma função de conversor de moeda personalizada é quando você tem preços exibidos em um menu suspenso ou em outros elementos HTML complexos. Por exemplo, se você tiver um menu suspenso com preços exibidos ao lado de cada opção, como:

Em casos como este, você não pode simplesmente selecionar o preço diretamente porque há texto adicional ao lado. Ao usar um conversor de moeda personalizado, você pode extrair o preço do elemento e aplicar a lógica de conversão de moeda.