Substitua a forma como o Hello apresenta valores em moeda estrangeira.
Pode adaptar a apresentação de moedas estrangeiras às suas necessidades e preferências personalizando o formato de apresentação da moeda na sua integração JavaScript.
O Hello suporta os seguintes formatos de apresentação da moeda:
symbol (predefinição) - Apresenta um símbolo de moeda localizado, por exemplo, €123.
code - Utiliza o código ISO da moeda, por exemplo, 123 USD.
name - Apresenta o nome localizado da moeda, por exemplo, 123 dollars.
Pode substituir o formato de apresentação da moeda através da propriedade overrideCurrencyFormat no método Zonos.init. Esta propriedade aceita um dos formatos de apresentação da moeda indicados acima. A substituição do formato de apresentação da moeda aplica-se tanto ao Hello como ao Zonos Checkout.
Nos casos em que a simples substituição do formato de apresentação da moeda não é suficiente para as necessidades do seu site, pode utilizar um conversor de moeda personalizado para tratar da conversão e da formatação de valores em moeda estrangeira. Esta abordagem dá-lhe controlo total sobre a forma como os valores monetários são apresentados no seu site.
Para utilizar um conversor de moeda personalizado, tem de implementar a função currencyConverter no método Zonos.init. Esta função deve aceitar os seguintes parâmetros:
convertAndFormat - Uma função que converte e formata o valor monetário.
originalAmount - O valor monetário original.
selector - O seletor do elemento que contém o valor monetário.
Quando presente, a função currencyConverter percorre todos os seletores de preço correspondentes no seu site e aplica a lógica de conversão de moeda personalizada a cada um deles.
Um caso de utilização comum de uma função de conversão de moeda personalizada é quando tem preços apresentados num menu pendente ou noutros elementos HTML complexos. Por exemplo, se tiver um menu pendente com preços apresentados ao lado de cada opção, como:
1
2
3 Blue - $1.99
4
5
6
7 Red - $2.00
8
9
10
11 Yellow - $3.59
12
13
Em casos como este, não pode simplesmente selecionar o preço diretamente, porque existe texto adicional ao lado. Ao utilizar um conversor de moeda personalizado, pode extrair o preço do elemento e aplicar-lhe a lógica de conversão de moeda.
Personalizar a moeda de apresentação
Personalizar a moeda de apresentação
Substitua a forma como o Hello apresenta valores em moeda estrangeira.
Pode adaptar a apresentação de moedas estrangeiras às suas necessidades e preferências personalizando o formato de apresentação da moeda na sua integração JavaScript.
Formatos de apresentação da moeda
O Hello suporta os seguintes formatos de apresentação da moeda:
symbol(predefinição) - Apresenta um símbolo de moeda localizado, por exemplo,€123.code- Utiliza o código ISO da moeda, por exemplo,123 USD.name- Apresenta o nome localizado da moeda, por exemplo,123 dollars.Pode substituir o formato de apresentação da moeda através da propriedade
overrideCurrencyFormatno métodoZonos.init. Esta propriedade aceita um dos formatos de apresentação da moeda indicados acima. A substituição do formato de apresentação da moeda aplica-se tanto ao Hello como ao Zonos Checkout.Zonos.init({overrideCurrencyFormat: 'code',});Utilizar um conversor de moeda personalizado
Nos casos em que a simples substituição do formato de apresentação da moeda não é suficiente para as necessidades do seu site, pode utilizar um conversor de moeda personalizado para tratar da conversão e da formatação de valores em moeda estrangeira. Esta abordagem dá-lhe controlo total sobre a forma como os valores monetários são apresentados no seu site.
Para utilizar um conversor de moeda personalizado, tem de implementar a função
currencyConverterno métodoZonos.init. Esta função deve aceitar os seguintes parâmetros:convertAndFormat- Uma função que converte e formata o valor monetário.originalAmount- O valor monetário original.selector- O seletor do elemento que contém o valor monetário.Quando presente, a função
currencyConverterpercorre todos os seletores de preço correspondentes no seu site e aplica a lógica de conversão de moeda personalizada a cada um deles.Um caso de utilização comum de uma função de conversão de moeda personalizada é quando tem preços apresentados num menu pendente ou noutros elementos HTML complexos. Por exemplo, se tiver um menu pendente com preços apresentados ao lado de cada opção, como:
Blue - $1.99Red - $2.00Yellow - $3.59Em casos como este, não pode simplesmente selecionar o preço diretamente, porque existe texto adicional ao lado. Ao utilizar um conversor de moeda personalizado, pode extrair o preço do elemento e aplicar-lhe a lógica de conversão de moeda.
window.Zonos.init({currencyConverter: ({ convertAndFormat, originalAmount, selector }) => {const optionValue = selector.getAttribute('data-select-option');if (optionValue) {return `${optionValue} - ${convertAndFormat(originalAmount)}`;}return convertAndFormat(originalAmount);},});Esta página foi útil?