FOX

У режимі, коли клієнт платить у вибраній валюті, raw_woocommerce_price() підключається до woocommerce_product_get_price, геттерів звичайної й акційної ціни та геттерів варіацій. Пріоритет 9999 ставить його після інших плагінів, що коригують базову ціну. У режимі лише показу використовується тільки фільтр raw_woocommerce_price, тож збережені суми кошика й замовлення лишаються в базовій валюті.

Крайні випадки, які обробляє конвертер: порожні ціни проходять без змін, варіативний батько, запитаний з display=false, пропускається, щоб не конвертувати min/max двічі, а геттер акційної ціни повертає порожній рядок, коли акційної ціни не збережено. Без цього конвертована порожня акційна ціна стає 0, і WooCommerce показує закреслену ціну.

WooCommerce кешує обчислені масиви цін варіативного товару в transient за ключем-хешем вхідних даних ціноутворення. Якщо валюти немає в цьому хеші, конвертовані ціни першого відвідувача віддаються всім. woocommerce_get_variation_prices_hash() додає поточну валюту.

Потім woocommerce_variation_prices() конвертує кожен запис, застосовує фіксовані ціни окремих варіацій і пересортовує кожен масив через asort(). Діапазон цін береться з першого й останнього елементів, а фіксовані ціни за валютою можуть змінити порядок варіацій порівняно з базовою валютою.

Фіксовані ціни зберігаються як мета товару для кожного поля й валюти (_woocs_regular_price_EUR, _woocs_sale_price_EUR), де -1 означає «не задано, використати курс». Фіксована ціна у валюті відвідувача використовується як є. Інакше ціна за країною замінює базову, а результат конвертується за курсом. Ціни за країною групують країни в блоки з однією ціною на блок, а країна відвідувача береться з геолокації WooCommerce, збереженої в стані відвідувача.

Ціни за роллю застосовуються після цього кроку. Коли для ролі користувача задано ціну, вона замінює ціну, вибрану досі, зокрема фіксовану ціну у валюті, і конвертується за курсом.

Коли акційну ціну за країною залишено порожньою, get_product_geo_data() копіює в неї звичайну ціну, інакше товар став би безкоштовним у цій країні. Коли фіксоване поле акційної ціни порожнє, пошук повертається до фіксованого поля звичайної ціни.

Фіксовані ціни зберігаються для кожного поля, але woocommerce_product_get_price передає лише число. get_price_type() порівнює вхідне значення з сирими звичайною й акційною цінами товару, прочитаними в контексті 'edit'. Якщо жодна не збігається, вона веде статичну карту першої ціни, побаченої для кожного товару в запиті, і вважає пізніше, більше значення звичайною ціною.

Це евристика, тому явні типи полів передаються скрізь, де виклик їх знає. Ціни за роллю використовують власну копію тієї ж логіки.

Необов'язковий список цін під товаром будується всередині woocommerce_price_html(). Для кожної валюти перемикається поточна валюта, значення форматується з десятковими знаками й роздільниками цієї валюти, а потім початкова валюта відновлюється.

Діапазон варіативного товару не можна обчислити як базові min/max, помножені на курс, бо окремі варіації можуть мати фіксовані ціни. _get_min_max_variation_prices() перераховує ціну кожної варіації для цільової валюти й відкидає нульові значення. Групові товари обходять своїх нащадків і так само обробляють варіативних нащадків.

woocs_skip_conversion перевіряється в конвертері першим: інтеграція, що вже оцінила позицію в активній валюті, повертає true, і сума проходить без змін. Прапорець запиту woocs_block_price_hook вимикає конвертацію для ділянки коду; його використовують, наприклад, під час побудови даних webhook-ів.

Для зворотного напрямку woocs_convert_price і woocs_back_convert_price дозволяють стороннім плагінам конвертувати власні суми в базовій валюті, а convert_from_to_currency() конвертує між будь-якими двома валютами магазину через базову: value / rate_from * rate_to.

WooCommerce читає кількість десяткових знаків з однієї опції. FOX відповідає на цю опцію налаштуванням поточної валюти, а конвертер округлює через number_format() до тієї ж точності, тож збережене значення кошика й показане значення збігаються.

JPY і TWD жорстко закодовані як валюти без копійок, адміністратор може додати інші, а фільтр woocs_precision_on_calc дозволяє сайту перевизначити точність для кожної валюти.

Тарифи доставки обчислюються в базовій валюті й конвертуються пізніше в woocommerce_package_rates. Якби їх спершу округлити до десяткових знаків валюти відвідувача (наприклад, 0 для JPY), базове значення втратило б точність до конвертації. woocs_fix_decimals() повертає базові десяткові знаки, коли add_rate є у стеку викликів.

Те саме стосується масивів цін варіацій: woocs_fix_variation_decimal() форматує їх із базовими десятковими знаками до того, як над ними запуститься конвертер.

Роздільники десяткової частини й тисяч фільтруються для кожної валюти (шість схем у get_decimal_sep() і get_thousand_sep()). У редакторі замовлення в wp-admin поля введення WooCommerce, їхня JS-валідація та wc_format_decimal() припускають роздільник магазину, тож кома як десятковий роздільник змінила б збережені суми. Тому роздільники окремих валют у редакторі замовлення вимкнено.

woocs_is_admin_order_edit_context() розпізнає AJAX-дії редактора замовлення за назвою, інші AJAX-виклики — за referer (сторінка wc-orders, тип запису shop_order, ID запису замовлення), а також екрани HPOS і застарілі. Частина запиту кешується в статичній змінній; перевірка екрана виконується повторно, бо get_current_screen() на початку запиту порожня. Суми повернень, введені з комою, нормалізуються до того, як їх перевірить WooCommerce.

apply_conversion() виконується на woocommerce_paypal_args і переформатовує кожне поле amount_* і tax_cart з 0 десяткових знаків, коли поточна валюта не має копійок. enable_custom_currency() розширює білий список валют PayPal у WooCommerce, щоб шлюз лишався доступним, коли відвідувач платить у небазовій валюті.

Курс, наприклад кількість монет за USD, може бути значно нижчим за 0.0001, а перетворення float у рядок у PHP дає експоненціальну нотацію, яку не можуть використати ні форма адмінки, ні лист із курсом. rate_to_string() обчислює кількість десяткових знаків з log10 значення, обмежує її 20 і відкидає кінцеві нулі.

WOOCS_STORAGE надає set_val/get_val/is_isset і перемикається на налаштований бекенд. Сховище transient має ключ із хеша IP клієнта, а за Cloudflare перевага надається CF-Connecting-IP, бо Cloudflare перезаписує будь-яке значення, надане клієнтом. Memcached і Redis також підтримуються.

WOOCS_SESSION повторно використовує таблицю woocommerce_sessions із cookie, підписаним HMAC, читає через кеш об'єктів і записує на shutdown лише тоді, коли дані змінилися.

Зі сховищем transient і ввімкненим режимом кешу front.js один раз створює випадковий ідентифікатор (crypto.randomUUID, коли доступний) і надсилає його з кожним запитом. Сервер санітизує його через sanitize_key() і хешує в ключ transient, тож користувачі за офісним NAT чи мобільного оператора отримують окремі «кошики». Ідентифікатор навмисно створюється в нижньому регістрі: sanitize_key() переводить у нижній регістр, а ідентифікатор зі змішаним регістром дав би хеш іншого «кошика».

У цьому режимі transient живе 30 днів замість 1, бо ключ стабільний для браузера. Якщо localStorage заблоковано, код тихо повертається до ключа за IP.

Запити jQuery отримують ключ через обробник ajaxSend, але WooCommerce Blocks, Store API і PayPal Payments використовують fetch() і стартують до DOM ready. Обгортка встановлюється на верхньому рівні. Ключ передається в заголовку X-WOOCS-SK, а не в аргументі запиту, бо аргумент запиту для кожного відвідувача розколов би кеш сторінок на кожного відвідувача. Виклики між різними походженнями не чіпаються, бо власний заголовок спричиняє CORS preflight, який може зламати платіжні SDK.

На боці PHP запити wp-json до маршрутів cart, store і batch залишають плагін завантаженим, щоб блоковий кошик і оформлення замовлення відображалися у валюті відвідувача.

woocommerce_price_html() обгортає кожну ціну в span з ID товару й унікальним ID перемальовування. На закешованій сторінці front.js збирає маркери й надсилає їх на woocs_get_products_price_html; JSON варіацій у формі додавання до кошика та власні шорткоди цін оновлюються так само. Стиль прелоадера може ховати застарілі ціни, доки не надійде відповідь.

Сервер повертає порожню відповідь, коли валюта, в якій відображено закешовану сторінку, вже дорівнює збереженій валюті відвідувача, тож такий перегляд сторінки не потребує відображення. get_price_html() він відображає лише для опублікованих видимих товарів.

WooCommerce зберігає фрагменти кошика в sessionStorage за ключем-хешем кошика, а хеш залежить лише від вмісту кошика. FOX фільтрує woocommerce_cart_hash до md5(cart + currency), тож перемикання робить збережені фрагменти недійсними, і доставка перераховується.

Коли валюта надходить в URL на закешованій сторінці, front.js спершу дзеркалить її в «кошик» ключа браузера і лише потім запускає wc_fragment_refresh, інакше оновлення прочитало б порожній «кошик» і повернулося б до базової валюти.

set_currency() зберігає лише увімкнені валюти, а збережене значення перевіряється заново в кожному запиті, тож валюта, видалена адміністратором, повертається до базової. get_woocommerce_currency() ніколи не повертає WooCommerce невідомий код, бо WooCommerce записав би його в замовлення.

Валюти, позначені як приватні, не можна вибрати через ?currency= чи AJAX-перемикач. Значення запиту woocs_in_order_currency приймає приватну валюту лише для користувачів з edit_shop_orders.

woocommerce_package_rates() множить вартість і кожен запис податку на курс і округлює до десяткових знаків валюти. Фіксована вартість flat-rate для валюти зберігається в опції налаштувань екземпляра самого способу доставки. Коли використовується фіксована вартість, масштабувати старий податок було б хибно, тому податок перераховується через WC_Tax::calc_shipping_tax().

Вартість flat-rate на кшталт '[cost] * 0.1' отримує вартість кошика у валюті відвідувача, а отриманий тариф доставки потім знову конвертується в woocommerce_package_rates. woocommerce_fix_shipping_calc() спершу ділить аргумент cost на курс, тож конвертація відбувається один раз.

Спосіб безкоштовної доставки порівнює показану проміжну суму з min_amount. Коли клієнт платить у вибраній валюті, проміжна сума кошика виражена в ній, тож перевірку реалізовано заново: проміжна сума конвертується назад за поточним курсом, знижка й податок на знижку теж, враховуються налаштування ignore_discounts і показу податків, а вимоги coupon/either/both оцінюються як у WooCommerce.

Якщо задано фіксований мінімум для валюти, він теж конвертується назад, тож обидві частини порівняння виражені в базовій валюті.

woocommerce_coupon_loaded() конвертує суму купона (крім типів percent і percent_product) та мінімальні й максимальні витрати, а потім записує їх назад через сеттери купона, тож уся валідація WooCommerce виконується в одній валюті. Фіксовані суми й ліміти купонів для окремих валют, збережені як мета купона, перевизначають конвертовані значення.

У режимі лише показу валюта скидається до базової на сторінці оформлення, на checkout_process, у блоковому оформленні й під час оновлень огляду замовлення. У режимі оплати у вибраній валюті запит оформлення явно читає збережену валюту, а за потреби валюту примусово визначає країна відвідувача. Незавершене замовлення, оплачене пізніше за своїм посиланням на оплату, перемикається на власну валюту замовлення.

Платіжні шлюзи можна ховати або показувати для кожної валюти, бо багато шлюзів підтримують лише деякі валюти.

RateProvider::getRate() будує URL, отримує дані з тайм-аутом і делегує parseResponse(). Потоки центральних банків котируються відносно власної валюти, тож парсери обчислюють крос-курси: ECB має базу EUR, а потік Банку Росії також містить Nominal (курс за 10 або 100 одиниць), на який треба поділити.

get_rate_provider() зіставляє налаштовану назву джерела з файлом класу. Сайти можуть додавати власні джерела через фільтри woocs_add_custom_rate і woocs_add_aggregator_processor.

Джерело Pulse Verity повертає ціну в USD для будь-якого символу, тож фіатний код мовчки отримав би ціну стороннього токена. Постачальник спершу перевіряє жорстко закодований список ISO 4217, бо плагіни криптоплатежів додають монети до списку валют WooCommerce, і цьому списку не можна довіряти. Він працює лише з базою USD, надсилає API-ключ у заголовку Bearer, повідомляє власний код помилки API для будь-якої відповіді не 2xx (хибний ключ, обмеження тарифу, ліміт запитів) і відхиляє нульові або нечислові ціни. Отримана ціна в USD за монету інвертується в монети за 1 USD.

PN_WP_CRON_WOOCS зберігає початок, наступний запуск, інтервал і останній запуск для кожного хука в одній опції та перевіряється з init, admin_init і rest_api_init. Оскільки його викликають у кожному запиті, attach() має бути ідемпотентним: з незмінним інтервалом він не чіпає next, а при зміні інтервалу перераховує next від останнього запуску, обмежуючи значенням «зараз плюс один інтервал». Три хуки реєструються з 0 прийнятих аргументів, бо rest_api_init передає об'єкт WP_REST_Server, який інакше потрапив би в параметр $reset і перезапускав би розклад у кожному REST-запиті.

process() зсуває наступний запуск уперед перед викликом хука, перехоплює й логує винятки, викинуті ним, і запускає кожен хук щонайбільше один раз за запит. Оновлений розклад зберігається в опцію після виконання хуків.

rate_auto_update() отримує кожну валюту у власному блоці try і замінює курс лише додатним числом, тож валюта чи джерело, що відмовило, не зупиняє інші й ніколи не записує нуль чи текст помилки як курс. get_rate() пропускає кожен числовий курс через ExchangeRateLimiter, який обмежує його необов'язковою нижньою й верхньою межею для кожної валюти. Після збереження дія woocs_sheduler_rates_updated дозволяє іншому коду відреагувати.

Усі курси зберігаються як одиниці на 1 базової, тож нова база одразу робить хибним кожне число. save_etalon() зберігає прапорець нової бази, перемикає default_currency у пам'яті й викликає get_rate() для кожної іншої валюти до відповіді екрану адмінки, тож форма заповнюється узгодженими значеннями.

Націнка зберігається поруч із курсом як фіксована сума або відсоток і застосовується у фільтрі woocs_currency_data_manipulation з пріоритетом 1, тож кожен споживач get_currencies() бачить курс із націнкою. get_currencies(true) пропускає фільтри, коли потрібне сире значення.

Під час оформлення та на сторінці подяки курс, базова валюта й позначка «змінено вручну» записуються через $order->update_meta_data(), що працює і для HPOS, і для сховища на записах. Якщо поточної валюти немає в списку, використовується базовий курс. Мета-ключі приховані від показу позицій. Адміністратор може виправити збережений курс на екрані замовлення, і рядки аналітики товарів замовлення синхронізуються заново.

Перерахунок конвертує підсумки замовлення, проміжні суми й підсумки рядків, масиви податків за ставками, позиції доставки та їхні податки, позиції податків і повернення. У HPOS він іде через сеттери CRUD, також конвертує рядки комісій і рядки купонів та перераховує податки. У застарілому сховищі він оновлює post meta і мета позицій замовлення напряму, зокрема знижку кошика замовлення.

Якщо сайт визначає woocs_order_recalculated_custom(), вона викликається перед збереженням із замовленням, обома валютами й старим курсом — для сум, які мають зберігати фіксоване значення для кожної валюти. Масова дія перераховує всі замовлення в базову валюту.

Поточна валюта належить тому, хто ініціював запит: адміністраторові, що завершує замовлення, cron-завданню або клієнтові, який переглядає сайт в іншій валюті. FOX перемикається на валюту замовлення в wc_get_template для шаблонів листів, у сповіщенні про завершення і при повторному надсиланні листа, для відображення PDF-рахунків, у списках замовлень і переглядах замовлень у «Моєму акаунті», у попередньому перегляді замовлення в адмінці та для кожного рядка списку замовлень HPOS через фільтр імені покупця.

WooCommerce Analytics копіює суми замовлень у власні довідкові таблиці як є, тож виручка змішувала б валюти. WOOCS_analytics підключається до woocommerce_analytics_update_product, _tax і _coupon, читає рядок, який WooCommerce щойно записав, ділить кожну суму на збережений курс замовлення (або на поточний, якщо його немає) і округлює до базових десяткових знаків. Застарілі звіти WooCommerce адаптовано так само, конвертуючи кожне замовлення назад.

wp-admin зазвичай працює в базовій валюті. Для AJAX-дій редактора замовлення (додати позицію, зберегти позиції, перерахувати податки) поточна валюта задається як валюта замовлення, для користувачів, які можуть редагувати замовлення. Коли вручну додається товар із фіксованою ціною в цій валюті, проміжна сума й підсумок позиції беруться з фіксованої ціни, а підсумки замовлення перераховуються. Коли в редакторі додається купон, поточна валюта перемикається на валюту замовлення.

Системи POS та ERP синхронізують ціни через WooCommerce REST API, а запит може нести сесію відвідувача, який вибрав іншу валюту. Серверна змінна SCRIPT_URI, яку використовує загальний REST-запобіжник, існує в Apache, але не в nginx, тому маршрут також розбирається з REQUEST_URI за допомогою rest_get_url_prefix() або з ?rest_route=, і плагін завершується до створення свого об'єкта для будь-якого маршруту wc/vN. Store API і власний простір імен FOX це не стосується.

woocs_validate_currency() відповідає валютою магазину, коли об'єкта плагіна в запиті немає. Преміум-версія.

Асинхронна доставка йде через Action Scheduler: базова валюта вмикається з пріоритетом 1 на woocommerce_deliver_webhook_async і вимикається на 999. Синхронна доставка складніша: починаючи з WooCommerce 4.4 webhook-и ставляться в чергу й доставляються на shutdown, тому FOX вмикає базову валюту всередині фільтра woocommerce_webhook_deliver_async лише тоді, коли його викликано на shutdown із WC_Webhook і async=false, а вимикає в woocommerce_webhook_payload, одразу після build_payload().

Доставка може виконуватися в запиті, що несе cookie відвідувача, а отже і його валюту. Перемикаються і прапорець конвертації, і current_currency, бо фіксовані ціни для окремих валют читають current_currency напряму. Преміум-версія.

Краулери можуть приходити з валютою в URL. Відомі user agent-и ботів скидаються до базової валюти у wp_head, якщо адміністратор цього не вимкнув. Незалежно від цього structured_data_product_offer() задає priceCurrency як базову й ділить записи price, lowPrice, highPrice і priceSpecification на курс, тож розмітка товару лишається узгодженою з валютою магазину.

Експорт товарів у CSV скидає валюту перед своїм запитом, тож експортовані ціни — це базові значення, які можна імпортувати назад. Завантаження варіацій у редакторі товару та кожна не-AJAX сторінка wp-admin працюють у базовій валюті. Плагін не завантажується для AJAX-дій масового редактора BEAR, для завантаження позицій замовлення, для REST-запитів, чий URL містить /refunds або paypal (PayPal Payments), і для повернень у бекенді, якщо їх не потребує відомий плагін, бо ці запити записують збережені суми.

woocs/v3 надає список валют, ціну одного товару й пакет цін товарів. Колбек задає запитану валюту лише якщо вона існує в магазині, обчислює ціни з тим самим пріоритетом, що й головний конвертер (фіксована, за країною, за роллю, потім курс), повертає сирі значення для кожної варіації з min і max або HTML та відновлює попередню валюту.

Базовою валютою магазину був AUD. Під час запиту імпорту GeoIP перемкнув поточну валюту на USD, а імпортер записував поточну валюту в кожне замовлення. Виклик $WOOCS->reset_currency(), захищений class_exists('WOOCS'), додано у двох місцях коду замовлень імпортера, тож замовлення записуються в базовій валюті. Це патч до стороннього імпортера, і його треба застосовувати знову після оновлення того плагіна. Клієнт підтвердив, що це спрацювало.