Настройка валюты отображения

Вы можете настроить представление иностранных валют в соответствии с вашими потребностями и предпочтениями, изменив формат отображения валюты в вашей интеграции JavaScript.

Форматы отображения валюты 

Hello поддерживает следующие форматы отображения валюты:

• symbol (по умолчанию) - Отображение локализованного символа валюты (например, €123).
• code - Использование ISO кода валюты (например, 123 USD).
• name - Отображение локализованного названия валюты (например, 123 доллара).

Вы можете переопределить формат отображения валюты, используя свойство overrideCurrencyFormat в методе Zonos.init. Это свойство принимает один из форматов отображения валюты, перечисленных выше. Переопределение формата отображения валюты применяется как к Hello, так и к Zonos Checkout.

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

Использование пользовательского конвертера валют 

В случаях, когда простое переопределение формата отображения валюты недостаточно для нужд вашего сайта, вы можете использовать пользовательский конвертер валют для обработки конверсии и форматирования сумм в иностранной валюте. Этот подход позволяет вам полностью контролировать, как суммы валюты отображаются на вашем сайте.

Чтобы использовать пользовательский конвертер валют, вам необходимо реализовать функцию currencyConverter в методе Zonos.init. Эта функция должна принимать следующие параметры:

• convertAndFormat - Функция, которая конвертирует и форматирует сумму валюты.
• originalAmount - Исходная сумма валюты.
• selector - Селектор элемента, содержащего сумму валюты.

Когда функция currencyConverter присутствует, она будет проходить по всем соответствующим селекторам цен на вашем сайте и применять пользовательскую логику конверсии валюты к каждому из них.

Одним из распространенных случаев использования функции пользовательского конвертера валют является ситуация, когда у вас есть цены, отображаемые в выпадающем меню или других сложных HTML-элементах. Например, если у вас есть выпадающее меню с ценами, отображаемыми рядом с каждым вариантом, таких как:

<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>

В таких случаях вы не можете просто выбрать цену напрямую, так как рядом с ней есть дополнительный текст. Используя пользовательский конвертер валют, вы можете извлечь цену из элемента и применить к ней логику конвертации валюты.

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