DOCS

Customize currency display

/

Pas de weergavevaluta aan

Overschrijf hoe Hello buitenlandse valuta bedragen weergeeft.

U kunt de presentatie van buitenlandse valuta aanpassen aan uw behoeften en voorkeuren door het valutaweergaveformaat in uw JavaScript-integratie aan te passen.

Valutaweergaveformaten 

Hello ondersteunt de volgende valutaweergaveformaten:

  • symbool (standaard) - Toon een gelokaliseerd valutateken (bijv. €123).
  • code - Gebruik de ISO-valutacode (bijv. 123 USD).
  • naam - Toon de gelokaliseerde valutanaam (bijv. 123 dollars).

U kunt het valutaweergaveformaat overschrijven door de overrideCurrencyFormat eigenschap te gebruiken in de Zonos.init methode. Deze eigenschap accepteert een van de hierboven vermelde valutaweergaveformaten. Het overschrijven van het valutaweergaveformaat is van toepassing op zowel Hello als Zonos Checkout.

JavaScript

1
2
3
Zonos.init({
  overrideCurrencyFormat: 'code',
});

Het gebruik van een aangepaste valutaconverter 

Voor gevallen waarin het eenvoudig overschrijven van het valutadisplayformaat niet voldoende is voor de behoeften van uw site, kunt u een aangepaste valutaconverter gebruiken om de conversie en opmaak van buitenlandse valuta bedragen te verwerken. Deze aanpak stelt u in staat om volledige controle te hebben over hoe valutabedragen op uw site worden weergegeven.

Om een aangepaste valutaconverter te gebruiken, moet u de currencyConverter functie implementeren in de Zonos.init methode. Deze functie moet de volgende parameters accepteren:

  • convertAndFormat - Een functie die het valutabedrag converteert en opmaakt.
  • originalAmount - Het oorspronkelijke valutabedrag.
  • selector - De selector van het element dat het valutabedrag bevat.

Wanneer aanwezig, zal de currencyConverter functie over alle overeenkomende prijsselectoren op uw site lopen en de aangepaste valutaconversielogica op elk daarvan toepassen.

Een veelvoorkomend gebruiksvoorbeeld voor het gebruik van een aangepaste valutaconverterfunctie is wanneer u prijzen hebt die worden weergegeven in een dropdownmenu of andere complexe HTML-elementen. Bijvoorbeeld, als u een dropdownmenu heeft met prijzen die naast elke optie worden weergegeven, zoals:

HTML

1
2
3
4
5
6
7
8
9
10
11
<select title="Option">
  <option className="money" data-select-option="Blue" value="option1">
    Blue - $1.99
  </option>
  <option className="money" data-select-option="Red" value="option2">
    Red - $2.00
  </option>
  <option className="money" data-select-option="Yellow" value="option3">
    Yellow - $3.59
  </option>
</select>

In gevallen zoals deze, kun je de prijs niet eenvoudigweg direct selecteren, omdat er aanvullende tekst naast staat. Door een aangepaste valutaconverter te gebruiken, kun je de prijs uit het element extraheren en de valutaconversielogica erop toepassen.

JavaScript

1
2
3
4
5
6
7
8
9
window.Zonos.init({
  currencyConverter: ({ convertAndFormat, originalAmount, selector }) => {
    const optionValue = selector.getAttribute('data-select-option');
    if (optionValue) {
      return `${optionValue} -  ${convertAndFormat(originalAmount)}`;
    }
    return convertAndFormat(originalAmount);
  },
});

Was deze pagina nuttig?