DOCS

Dostosuj wyświetlanie waluty

Zmień sposób wyświetlania obcych walut w Hello.

Możesz dostosować prezentację obcych walut do swoich potrzeb i preferencji, personalizując format wyświetlania waluty w integracji JavaScript.

Formaty wyświetlania waluty 

Hello obsługuje następujące formaty wyświetlania waluty:

  • symbol (domyślny) - Wyświetl zlokalizowany symbol waluty, np. €123.
  • code - Użyj kodu ISO waluty, np. 123 USD.
  • name - Wyświetl zlokalizowaną nazwę waluty, np. 123 dolary.

Możesz zmienić format wyświetlania waluty za pomocą właściwości overrideCurrencyFormat w metodzie Zonos.init. Ta właściwość akceptuje jeden z formatów wyświetlania waluty wymienionych powyżej. Zmiana formatu wyświetlania waluty dotyczy zarówno Hello, jak i Zonos Checkout.

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

Używanie niestandardowego konwertera walut 

W przypadkach, gdy zwykła zmiana formatu wyświetlania waluty nie wystarczy dla potrzeb Twojej witryny, możesz użyć niestandardowego konwertera walut do obsługi konwersji i formatowania kwot obcych walut. Takie podejście daje Ci pełną kontrolę nad sposobem wyświetlania kwot walut na Twojej witrynie.

Aby użyć niestandardowego konwertera walut, musisz zaimplementować funkcję currencyConverter w metodzie Zonos.init. Ta funkcja powinna akceptować następujące parametry:

  • convertAndFormat - Funkcja, która konwertuje i formatuje kwotę waluty.
  • originalAmount - Oryginalna kwota waluty.
  • selector - Selektor elementu zawierającego kwotę waluty.

Gdy jest obecna, funkcja currencyConverter będzie przeglądać wszystkie pasujące selektory cen na Twojej witrynie i stosować logikę konwersji waluty do każdego z nich.

Jednym z typowych zastosowań niestandardowego konwertera walut jest sytuacja, gdy ceny są wyświetlane w menu rozwijającym lub innych złożonych elementach HTML. Na przykład, jeśli masz menu rozwijające z cenami wyświetlonymi obok każdej opcji, takie jak:

1

W takich przypadkach nie możesz po prostu wybrać ceny bezpośrednio, ponieważ obok niej znajduje się dodatkowy tekst. Korzystając z niestandardowego konwertera walut, możesz wyodrębnić cenę z elementu i zastosować do niej logikę konwersji waluty.

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});

Czy ta strona była pomocna?