DOCS

Anzeigewährung anpassen

Anzeigewährung anpassen

Überschreiben Sie, wie Hello Fremdwährungsbeträge anzeigt.

Sie können die Darstellung von Fremdwährungen an Ihre Bedürfnisse und Präferenzen anpassen, indem Sie das Währungsanzeigeformat in Ihrer JavaScript-Integration anpassen.

Währungsanzeigeformate 

Hello unterstützt die folgenden Währungsanzeigeformate:

  • symbol (Standard) - Zeigt ein lokalisiertes 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 dollars.

Sie können das Währungsanzeigeformat überschreiben, indem Sie die Eigenschaft overrideCurrencyFormat in der Methode Zonos.init 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.

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

Einen benutzerdefinierten Währungskonverter verwenden 

Für Fälle, in denen das einfache Überschreiben des Währungsanzeigeformats für die Bedürfnisse Ihrer Site nicht ausreicht, können Sie einen benutzerdefinierten Währungskonverter verwenden, um die Konvertierung und Formatierung von Fremdwährungsbeträgen zu handhaben. Dieser Ansatz ermöglicht Ihnen die volle Kontrolle darüber, wie Währungsbeträge auf Ihrer Site angezeigt werden.

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

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

Wenn vorhanden, durchläuft die Funktion currencyConverter alle passenden Preis-Selektoren auf Ihrer Site und wendet die benutzerdefinierte Währungskonvertierungslogik auf jeden an.

Ein häufiger Anwendungsfall für die Verwendung einer benutzerdefinierten Währungskonverter-Funktion ist, wenn Preise in einem Dropdown-Menü oder anderen komplexen HTML-Elementen angezeigt werden. Wenn Sie beispielsweise ein Dropdown-Menü mit Preisen neben jeder Option haben, wie:

1

In solchen Fällen können Sie den Preis nicht einfach direkt auswählen, da zusätzlicher Text daneben steht. Mit einem benutzerdefinierten Währungskonverter können Sie den Preis aus dem Element extrahieren und die Währungskonvertierungslogik darauf anwenden.

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

War diese Seite hilfreich?