Multi Currency for WooCommerce

Multi Currency for WooCommerce — покупатель видит цены магазина в своей валюте по курсу НБУ, а заказ и платёж всегда идут в одной валюте: подмена суммы или валюты на этапе оплаты невозможна в принципе.

Как это выглядит для покупателя

Заказ и платёж — всегда одна валюта

Самая распространённая поломка мультивалютных плагинов: цена на странице показана в одной валюте, а платёжный шлюз списывает сумму в другой, или подпись платежа считается не из той валюты. Модуль фиксирует валюту ровно в момент оформления заказа — курс на тот момент сохраняется в заказе, а WooCommerce Order и платёжный шлюз дальше берут сумму и валюту из него самого. Расхождения между тем, что видел покупатель, и тем, что ушло на оплату, здесь структурно невозможны.

Переключатель и определение валюты

Шорткод [catcode_currency_switcher] вставляется в меню, шапку или футер и выводится списком или выпадающим списком. Валюта покупателя запоминается на месяц. Pro-версия дополнительно предлагает валюту сразу по стране посетителя — выбор покупателя всегда имеет приоритет над автоопределением.

Настройки админки

Отчёты WooCommerce остаются корректными

Заказы в иностранной валюте сводятся к базовой валюте магазина для Аналитики и отчётов WooCommerce по курсу, который действовал на момент самого заказа — а не текущему, который к тому времени уже мог измениться.

Бесплатная версия и Pro

Бесплатно: базовая валюта магазина плюс одна дополнительная, курс — автоматически из НБУ, переключатель валют. Pro: неограниченное количество дополнительных валют, наценка в процентах на курс каждой валюты, ручной (фиксированный) курс вместо автоматического, и валюта по стране посетителя. Всё, что настроено сверх бесплатного лимита, сохраняется и включается сразу, как только активирована лицензия — ничего не теряется.

Совместимость

WooCommerce 6.0+, WordPress 5.6+, PHP 7.4+, HPOS и блочный чекаут.

Зачем это магазину

Украинский магазин, который продаёт за границу, сталкивается с простой вещью: покупатель из Польши или Германии видит цену в гривне и не понимает, дорого это или нет. Он не пойдёт считать курс — он уйдёт с сайта. Показ цены в привычной ему валюте убирает этот шаг.

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

Откуда берётся курс

Курс тянется из НБУ и обновляется автоматически дважды в сутки. Это официальный курс, а не биржевой — тот самый, по которому считает бухгалтерия, поэтому отчёты сходятся.

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

Что получает админ

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

Настраивается округление: сколько знаков после запятой и нужно ли «причёсывать» результат до красивого числа, чтобы вместо 27,43 € выходило 27,50 €.

Совместимость с кешем

Типичный провал валютных модулей — кеш. Страница, сгенерированная для покупателя в евро, отдаётся следующему посетителю, и тот видит чужую валюту.

Модуль добавляет валюту в vary-ключ кеша, поэтому каждая валюта кешируется отдельно. Кеш при этом остаётся включённым — не приходится выключать его ради мультивалютности.

Бесплатная версия и Pro

Бесплатная версия — одна дополнительная валюта, курс НБУ с автообновлением, переключатель, фиксация валюты в заказе, корректные отчёты, работа с кешем. Ограничений по времени и рекламы в админке нет.

Pro снимает лимит на количество валют и добавляет ручной курс и наценку к курсу НБУ.

Сколько стоит

Лицензия Pro — 990 грн, на один сайт. Лицензия годовая: после окончания модуль работает дальше, прекращаются только обновления и поддержка. «Навсегда» не обещаем — НБУ меняет формат API, и модуль без обновлений однажды перестанет тянуть курс.

Технические требования

WordPress 6.2 и новее, WooCommerce, PHP 7.4 и новее. Совместимость с HPOS, классическим чекаутом и чекаутом на блоках. Для обновления курса нужен исходящий HTTPS к api.bank.gov.ua и работающий WP-Cron (или системный крон).

Что под капотом

Валюта и курс заказа хранятся в мета-полях самого заказа. Это и есть причина, почему платёж и отчётность сходятся: любой модуль, который потом читает заказ, видит ту же пару «сумма + валюта», что и покупатель на чекауте.

Курс кешируется, поэтому НБУ дёргается дважды в сутки, а не на каждую загрузку страницы. Если API не ответил — модуль работает на последнем известном курсе и не показывает покупателю пустую цену.

Как установить

1. Загрузите архив в «Плагины → Добавить новый → Загрузить плагин» и активируйте.

2. В настройках включите нужные валюты и нажмите обновление курса.

3. Поставьте переключатель шорткодом туда, где он нужен — обычно в шапку.

4. Оформите тестовый заказ в неосновной валюте и проверьте, что платёжка получила ту же сумму и валюту.

5. Если стоит кеш — прогрейте страницы в обеих валютах и убедитесь, что они не перепутались.