DOCS

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

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

Переопределите способ отображения иностранных валют в Hello.

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

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

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

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

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

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

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

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

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

  • convertAndFormat - функция, которая преобразует и форматирует сумму валюты.
  • originalAmount - первоначальная сумма валюты.
  • selector - селектор элемента, содержащего сумму валюты.

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

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

1

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

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

Была ли эта страница полезной?


На этой странице: