Multi Currency for WooCommerce

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

Як це виглядає для покупця

Замовлення і платіж — завжди одна валюта

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

Перемикач і визначення валюти

Шорткод [catcode_currency_switcher] вставляється в меню, шапку або футер і виводиться списком або випадаючим списком. Валюта покупця запам’ятовується на місяць. Pro-версія додатково пропонує валюту одразу за країною відвідувача — вибір покупця завжди має пріоритет над автовизначенням.

Налаштування адмінки

Звіти WooCommerce лишаються коректними

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

Сумісність

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. Якщо стоїть кеш — прогріте сторінку в обох валютах і переконайтесь, що вони не переплутались.