WPCS

Шорткод приймає value або meta_value з необов'язковим post_id; post_id без meta_value читає мета-ключ wpcs_price. price() множить на курс лише тоді, коли поточна валюта відрізняється від базової, а потім передає число у format_price_numeric() і фільтр wpcs_price.

price_html() обгортає результат у span з унікальним id і data-amount, що містить базове значення, яке режим кешу сторінок згодом використовує для перемальовування.

Для фіксованих цін шорткод розбирає список у карту й показує суму для поточної валюти або 'none', якщо її немає. Список цін у всіх валютах використовує ту саму карту замість конвертації.

JPY і TWD завжди показуються без копійок; будь-яку валюту можна додати до цього списку через hide_cents. Налаштування містять десяткові знаки для кожної валюти та роздільники десяткової частини й тисяч для кожної валюти. Вибір роздільника — це індекс у двох паралельних масивах, де індекс 0 означає глобальне налаштування, тож наявні сайти зберігають своє форматування.

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

Список інформації про ціну прибирає роздільник тисяч із уже відформатованого рядка, нормалізує роздільник десяткової частини, конвертує назад у базову через back_convert() (1/rate), а потім уперед у кожну іншу валюту. Точка [wpcs_converter] використовує rate[to] / rate[from], обидва відносно бази, і відкидає копійки для валют без копійок.

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

Журнал змін фіксує цю плинність: Yahoo вилучено в 1.1.1 (2017), Google вилучено в 1.1.2 (2018), обидва повернуто в 1.1.3 (2018), джерела, що перестали працювати, знову вилучено в 1.1.3 і 1.1.4, власні агрегатори через хук — у 1.1.5 (2020). Кожне джерело — це клас з getApiUrl() і parseResponse() на спільній базі RateProvider.

get_rate_provider() зіставляє значення опції з назвою класу; якщо класу немає, wpcs_add_aggregator_processor дозволяє сайту підключити власне джерело, а wpcs_announce_aggregator додає його до списку в налаштуваннях. У списку налаштувань 14 джерел.

ECB публікує відносно EUR, Національний банк України — відносно UAH, Magyar Nemzeti Bank — відносно HUF. Кожен постачальник обробляє три випадки: база — валюта банку, ціль — валюта банку, жодна з них. Джерело MNB — це SOAP-сервіс з комами як десятковими роздільниками та котируваннями за одиницю (наприклад, 100 JPY), які нормалізуються перед діленням.

get_rate() повертає текст помилки постачальника замість числа, коли курс від'ємний. rate_auto_update() приводить результати до float і замінює курс лише тоді, коли нове значення більше за нуль, тож зламане джерело ніколи не запише нуль чи текст помилки як курс.

Налаштування пропонують щогодини, двічі на день, щодня, щотижня або щомісяця. Плагін реєструє два додаткові інтервали через cron_schedules і при завантаженні планує подію з вибраним інтервалом, якщо вона ще не запланована.

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

WPCS_World_Currencies зберігає символ, опис, десяткові знаки й код прапора для кожної валюти. add_currencies_ajax() додає вибрані, отримує курс для кожної, реєструє невідомі символи як власні знаки та завантажує прапор у медіатеку, а якщо завантаження не вдається, використовує віддалений URL прапора. Діалог масового додавання показується лише в преміум-збірці.

Кожен span ціни має унікальний id і базову суму. З увімкненою опцією кешу front.js надсилає пари id/сума на wpcs_get_prices_html, який визначає валюту відвідувача на сервері й повертає карту id → новий HTML плюс поточну валюту; віджети перемикача після цього синхронізуються з нею. Цей режим присутній у коді 2016 року.

Поки віджети перемикача встановлюються на повернену валюту, прапорець не дає їхнім подіям change запустити ще одне перемикання валюти.

WPCS_STORAGE будує бекенд за назвою з абстрактного класу Storage. SessionStorage::create() повертає false, коли session_start() не вдається, і тоді обгортка переходить на сховище transient. Кожне значення санітизується при записі.

Журнал змін називає причину: transients з ключем за IP змішують користувачів, що мають одну адресу. CookieStorage ключує transients за UUID із cookie. Якщо заголовки вже надіслано, коли створюється ID, він виводить скрипт у футері, який надсилає ID на AJAX-точку з перевіркою nonce, а та встановлює cookie з чистої відповіді.

У режимі за замовчуванням wpcs_redirect() перебудовує поточний URL, зберігаючи інші GET-параметри та #якір. У режимі 'No GET data in link' він надсилає валюту на wpcs_set_currency_ajax і перезавантажує сторінку. GET-параметри, виведені у скрипт сторінки, спершу рекурсивно санітизуються.

У першому запиті вітальна валюта зберігається й прапорець встановлюється; гео-правила також виконуються лише для першого унікального візиту. Якщо збережену валюту пізніше видалено зі списку, get_currencies() повертається до базової.

WC_Geolocation від WooCommerce недоступний на простому сайті WordPress, тож плагін постачає власну базу країн. lib/GeoIP.dat і geoip.inc обгорнуті в OpenIpCountryResolver з кешем за IP у межах запиту.

З вбудованою базою заголовок Cloudflare HTTP_CF_IPCOUNTRY використовується напряму, а пошук у базі пропускається. Запит, чий REMOTE_ADDR дорівнює 127.0.0.1 або ::1, розв'язується як 8.8.8.8 до читання заголовків проксі.

З ліцензійним ключем MaxMind адміністратор завантажує архів GeoLite2-Country; обробник розпаковує .tar.gz через PharData, знаходить файл .mmdb, копіює його в uploads/currency-switcher і видаляє тимчасові файли і при успіху, і при помилці. Без ключа плагін лишається на вбудованій базі. Пошук іде через пакет Composer geoip2.

init_geo_currency() визначає країну, пропускає її через wpcs_geo_position, зберігає для відвідувача й застосовує перше підхоже правило лише під час першого візиту. [wpcs_check_country] виводить виявлену країну для налагодження правила.

wpcs_get_prices_html доступна анонімним відвідувачам. Вона обрізає ввід до 500 записів, приймає лише id, що відповідають набору символів uniqid(), який використовує price_html(), пропускає нескалярні ціни й кодує відповідь із JSON_HEX_TAG, AMP, APOS і QUOT, бо admin-ajax віддає її як text/html.

price_html() записує значення, що надходять з атрибутів [wpcs_price], як-от базова сума або сирий список 'USD:15,EUR:20' фіксованої ціни, в атрибути data-* span-а ціни. Ключі й значення екрануються та беруться в лапки, тож значення атрибута не може вставити розмітку.

wpcs_rates_current_currency передає ввід відвідувача в do_shortcode(). Виживають лише коди валют, що є в конфігурації, результат проходить esc_attr, а точність приводиться до int, тож додатковий синтаксис шорткодів вставити не можна.

Поле форми перемикача валют і параметр ?currency= перевіряються через array_key_exists() за налаштованим списком до потрапляння в сховище, а WPCS_STORAGE::set_val() санітизує кожне значення.

Символи на кшталт руб. зберігаються як сутності. Select надсилає md5(symbol), а обробник збереження зіставляє хеш назад з оригінальною сутністю зі списку відомих, тож сутність не кодується двічі й не береться із сирого вводу. Збереження захищене check_admin_referer(), а position перевіряється за фіксованим списком.