Геолокация WooCommerce: MaxMind, кэш и правильные цены для разных стран

Геолокация в WooCommerce нужна не ради красивой подписи со страной посетителя. От неё могут зависеть предварительный расчёт налогов, доступные способы доставки, ограничения каталога и другие элементы витрины. Ошибка в определении страны или неправильный full-page cache легко приводит к ситуации, когда покупатель видит данные, подготовленные для другого региона.

WooCommerce использует MaxMind GeoLite2 для встроенной геолокации. При этом магазин может работать в обычном режиме Geolocate или в режиме Geolocate (with page caching support). Второй вариант особенно важен, когда перед WordPress стоит page cache или CDN.

Ниже — схема настройки и диагностики без отключения кэша «на всякий случай».

Что именно делает геолокация WooCommerce

В WooCommerce → Settings → General параметр Default customer location определяет, какую стартовую локацию использовать до того, как покупатель явно введёт адрес. Официальная документация перечисляет варианты Shop country/region, No location by default, Geolocate и Geolocate (with page caching support).

При Geolocate WooCommerce определяет страну по IP через локальную базу MaxMind. Эти данные могут участвовать в выборе налоговых ставок и способов доставки. После того как покупатель вводит адрес, расчёт должен опираться уже на подтверждённые данные checkout согласно настройкам магазина.

Как подключается MaxMind

Для встроенной геолокации используется GeoLite2. В WooCommerce нужно выбрать режим геолокации, создать учётную запись MaxMind, получить license key и указать его в разделе интеграции. Подробная последовательность описана в официальной документации WooCommerce.

WooCommerce периодически обновляет локальную GeoIP-базу. Документация указывает, что обновление запускается через WP-Cron событием woocommerce_geoip_updater. Поэтому на сайте с отключённым или нестабильным WP-Cron база может устареть.

Geolocate и Geolocate with page caching support — в чём разница

Обычный Geolocate подходит, когда страница формируется динамически и сервер действительно выполняет WordPress/PHP для конкретного посетителя. Но при full-page cache ответ может быть отдан ещё до запуска WooCommerce.

Для таких случаев WooCommerce предлагает режим с поддержкой page caching. Он добавляет к URL параметр вида ?v=.... По документации WooCommerce это хеш, связанный с локацией пользователя, благодаря которому кэш может хранить отдельные варианты страниц.

Почему кэш может показать покупателю чужую страну

Типичный конфликт выглядит так: первый посетитель открывает страницу, WordPress определяет его страну и формирует HTML. CDN или page cache сохраняет этот HTML только по pathname. Следующий посетитель из другой страны получает уже готовую страницу и до PHP-запроса дело не доходит.

Поэтому нельзя считать включённый MaxMind достаточной настройкой. Нужно проверить, как именно cache key учитывает региональный вариант страницы. Если используется штатный режим WooCommerce с поддержкой кэширования, параметр v не следует бездумно вырезать из cache key правилами оптимизации.

Cloudflare, reverse proxy и реальный IP

Геолокация начинается с IP, который приложение считает адресом клиента. При reverse proxy, CDN или балансировщике важно, чтобы WordPress получал корректный клиентский адрес через доверенную цепочку заголовков. Если сервер видит IP прокси, MaxMind будет определять локацию прокси, а не покупателя.

Не стоит исправлять это правилом «доверять любому X-Forwarded-For». Заголовок должен обрабатываться только от известного прокси. Иначе клиент сможет подставить произвольный IP.

Налоги: геолокация — только первый этап

В документации по диагностике налогов WooCommerce отдельно советует проверять Default customer location и параметр Calculate tax based on. Неверная страна на первом экране может быть следствием MaxMind, но неправильная сумма после ввода адреса чаще связана уже с tax settings, классом налога или таблицей ставок.

Для международного магазина полезно тестировать минимум три состояния: новый анонимный посетитель, покупатель после ввода адреса и повторный посетитель с активной сессией.

Доставка и геолокация

Геолокация может помочь предварительно определить доступные shipping methods, но финальная доставка должна рассчитываться по адресу, который ввёл покупатель. Если метод доставки исчезает или появляется только после обновления страницы, проверьте не только shipping zones, но и кэш, сессию WooCommerce и фронтенд checkout.

Для нового магазина архитектуру каталога, доставки и checkout лучше проверять вместе. Это входит в задачи по разработке WooCommerce-магазина.

Как проверить проблему по шагам

1. Зафиксировать ожидаемую страну и IP тестового запроса.
2. Проверить Default customer location в WooCommerce.
3. Проверить наличие и актуальность MaxMind database.
4. Сравнить результат с отключённым page cache на staging.
5. Проверить, появляется ли ?v= в режиме page caching support.
6. Проверить cache key CDN и правила игнорирования query strings.
7. Проверить реальный client IP на origin.
8. После ввода адреса отдельно проверить налог и shipping zone.

Не путайте page cache и object cache

Redis Object Cache ускоряет повторные обращения к объектам и базе данных, но не заменяет full-page cache. Если проблема состоит в том, что CDN отдаёт готовый HTML другой страны, очистка Redis может ничего не изменить. Подробнее различие разобрано в материале про Redis Object Cache для WooCommerce.

Что учитывать в headless и Store API

Store API предназначен для customer-facing сценариев каталога, корзины и checkout. Официальная документация отмечает, что данные отражают текущего пользователя, а customer sessions в WooCommerce cookie-based. Для POST-запросов корзины и checkout используются Nonce Token или Cart Token.

Если frontend вынесен отдельно, нельзя кэшировать персонализированный ответ корзины как публичный объект. Документация Store API и Cart API должна быть исходной точкой для такой интеграции.

Практический чек-лист перед запуском

• MaxMind настроен и база обновляется.
• Default customer location выбран осознанно.
• CDN/origin видит корректный IP клиента.
• Full-page cache не смешивает региональные версии.
• Query parameter v не удаляется из cache key при режиме page caching support.
• Налоги проверены до и после ввода адреса.
• Shipping zones проверены для нескольких стран.
• Cart и checkout исключены из опасного публичного кэширования.

Когда нужна техническая диагностика

Если страна определяется правильно только после очистки кэша, налог меняется случайно, доставка зависит от повторного обновления страницы или разные пользователи получают одинаковую региональную версию, проблему лучше искать по всей цепочке: browser → CDN → reverse proxy → WordPress → WooCommerce session → tax/shipping logic.

В A.S Groups можно заказать диагностику WooCommerce, кэша и интеграций без полной переделки магазина. Для оценки достаточно описать симптом и текущую схему CDN/кэширования через форму контакта.