- Требования
- Установка
- Open Exchange Rates (необязательно)
- App ID
- Период обновления курсов
- Настройка и использование
- Добавление виджета
- Настройки виджета
- Использование
- Часто задаваемые вопросы
- Не отображается символ валюты
- Можно ли вывести виджет не в сайдбаре?
- Медленная загрузка / не подтягиваются курсы
- Доставка не конвертируется
- Флаги стран вместо кодов валют
- Почему не работает конвертация в корзине и оформлении заказа?
- Политика конфиденциальности

Виджет конвертера валют для WooCommerce от Kestrel позволяет показывать список валют, между которыми покупатели могут переключаться, чтобы видеть цены в нужной валюте.
Требования
- WooCommerce 4.0+
Установка
- Скачайте .zip-файл из своей учётной записи WooCommerce.
- Перейдите в Консоль WordPress → Плагины → Добавить новый и нажмите Загрузить плагин, затем выберите файл через Выбрать файл.
- Установите и активируйте плагин.
- Подробнее: Установка и активация плагинов / расширений.
Open Exchange Rates (необязательно)
Конвертация валют выполняется с помощью встроенного сервиса от Kestrel, но при необходимости можно использовать сервис Open Exchange Rates. Для этого нужно создать аккаунт и получить App ID.
App ID
Если у вас есть App ID от Open Exchange Rates:
- Перейдите в WooCommerce → Настройки → Интеграции → Open Exchange Rates.
- Вставьте ключ в соответствующее поле.
- Сохраните изменения.

Настройки Open Exchange Rates
После добавления App ID появятся дополнительные настройки:
Период обновления курсов
Позволяет задать, как часто (в часах) будут обновляться курсы валют. По умолчанию — каждые 12 часов (2 раза в день). Минимум — 1 час, максимум — 24 часа.
Настройка и использование
Все настройки выполняются прямо в настройках виджета.
Добавление виджета
Чтобы добавить виджет:
- Перейдите в: Внешний вид → Виджеты.
- Выберите область виджетов и нажмите кнопку +.
- Введите Currency converter и выберите виджет.

Добавление виджета
Настройки виджета
После добавления виджета нажмите на него, чтобы настроить:
- Заголовок — название виджета
- Коды валют — по одному коду на строку
- Список валют: http://openexchangerates.org/api/currencies.json
- Используйте * для управления отображением символа валюты:
- Например: SEK* → 999kr, USD * → 999 $
- Если * не указан, используется стандартное положение символа валюты WooCommerce
- Отображение валют — кнопки или выпадающий список
- Сообщение виджета — текст, который увидят пользователи
- Показывать символы валют — по умолчанию только коды валют
- Показывать ссылку сброса — добавляет кнопку возврата к валюте магазина
- Отключить определение местоположения — отключает автоматический выбор валюты по стране пользователя

Настройки виджета
Использование
Покупатели увидят переключатель валют:

Виджет конвертера валют
Если включена геолокация, валюта будет выбрана автоматически, а цены обновятся. Если страна пользователя не совпадает с доступными валютами, используется валюта магазина.
Можно использовать выпадающий список вместо кнопок — выберите опцию Select Box.

Выбор валюты
Конвертируются все цены:
- Цены товаров
- Цены со скидкой
- Суммы в корзине и оформлении заказа
- Доставка
Цены отображаются с символом валюты, например $10, а не 10 USD.

Покупатели всё равно оплачивают заказ в основной валюте магазина. Конвертация используется только для отображения.
Часто задаваемые вопросы
Не отображается символ валюты
Если используется валюта, не поддерживаемая WooCommerce, добавьте её с помощью сниппета: Add a Custom Currency Symbol.
Можно ли вывести виджет не в сайдбаре?
Да, используйте шорткод [woocommerce_currency_converter].
В шаблонах можно использовать:
echo do_shortcode( '[woocommerce_currency_converter]' ); Доступные атрибуты:
currency_codes— список валют (по умолчанию USD и EUR)message— текст над виджетомcurrency_display— кнопки илиselectshow_symbols— показывать символы (1 или 0)show_reset— показывать кнопку сбросаdisable_location— отключить геолокацию
Пример:
[woocommerce_currency_converter currency_codes="AUD, USD, GBP, EUR" message="Предпочитаете другую валюту?" show_symbols=1 show_reset=1 currency_display="select" disable_location=1] 
Пример отображения
Медленная загрузка / не подтягиваются курсы
Проверьте, не блокирует ли сервер запросы к API. IP сервиса: 185.24.96.251
Доставка не конвертируется
Конвертация работает только если способы доставки отображаются как радиокнопки, а не выпадающий список.
Флаги стран вместо кодов валют
Можно использовать флаги с помощью следующего кода:
a[data-currencycode="USD"] {
background-image: url('http://upload.wikimedia.org/wikipedia/en/a/a4/Flag_of_the_United_States.svg') !important;
background-size: 60px !important;
width: 30px;
background-repeat: no-repeat;
font-size: 0;
height: 20px;
} Почему не работает конвертация в корзине и оформлении заказа?
Добавьте шорткод [woocommerce_currency_converter] на страницы корзины и оформления заказа.

По умолчанию доступны только USD и EUR. Для других валют добавьте их через атрибуты шорткода.
