Anzeigewährung anpassen

Sie können die Darstellung ausländischer Währungen an Ihre Bedürfnisse und Vorlieben anpassen, indem Sie das Währungsanzeigeformat in Ihrer JavaScript-Integration anpassen.

Währungsanzeigeformate 

Hello unterstützt die folgenden Währungsanzeigeformate:

• symbol (Standard) - Zeigt ein lokalisierter Währungssymbol an (z.B. €123).
• code - Verwendet den ISO-Währungscode (z.B. 123 USD).
• name - Zeigt den lokalisierten Währungsnamen an (z.B. 123 Dollar).

Sie können das Währungsanzeigeformat überschreiben, indem Sie die overrideCurrencyFormat-Eigenschaft in der Zonos.init-Methode verwenden. Diese Eigenschaft akzeptiert eines der oben aufgeführten Währungsanzeigeformate. Das Überschreiben des Währungsanzeigeformats gilt sowohl für Hello als auch für Zonos Checkout.

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

Verwendung eines benutzerdefinierten Währungsumrechners 

Für Fälle, in denen das einfache Überschreiben des Währungsanzeigeformats nicht ausreicht, um die Anforderungen Ihrer Website zu erfüllen, können Sie einen benutzerdefinierten Währungsumrechner verwenden, um die Umrechnung und Formatierung von Beträgen in Fremdwährungen zu übernehmen. Dieser Ansatz ermöglicht es Ihnen, die vollständige Kontrolle darüber zu haben, wie Währungsbeträge auf Ihrer Website angezeigt werden.

Um einen benutzerdefinierten Währungsumrechner zu verwenden, müssen Sie die currencyConverter-Funktion in der Zonos.init-Methode implementieren. Diese Funktion sollte die folgenden Parameter akzeptieren:

• convertAndFormat - Eine Funktion, die den Währungsbetrag umrechnet und formatiert.
• originalAmount - Der ursprüngliche Währungsbetrag.
• selector - Der Selektor des Elements, das den Währungsbetrag enthält.

Wenn vorhanden, wird die currencyConverter-Funktion über alle übereinstimmenden Preisselektoren auf Ihrer Website iterieren und die benutzerdefinierte Währungsumrechnungslogik auf jeden anwenden.

Ein häufiger Anwendungsfall für die Verwendung einer benutzerdefinierten Währungsumrechnerfunktion ist, wenn Sie Preise in einem Dropdown-Menü oder anderen komplexen HTML-Elementen anzeigen. Zum Beispiel, wenn Sie ein Dropdown-Menü haben, in dem die Preise neben jeder Option angezeigt werden, wie:

<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 solchen Fällen können Sie den Preis nicht einfach direkt auswählen, da sich zusätzlicher Text daneben befindet. Durch die Verwendung eines benutzerdefinierten Währungsumrechners können Sie den Preis aus dem Element extrahieren und die Währungsumrechnungslogik darauf anwenden.

window.Zonos.init({
  currencyConverter: ({ convertAndFormat, originalAmount, selector }) => {
    const optionValue = selector.getAttribute('data-select-option');
    if (optionValue) {
      return `${optionValue} -  ${convertAndFormat(originalAmount)}`;
    }
    return convertAndFormat(originalAmount);
  },
});