WooCommerce Gateways Country Limiter - Плагин WordPress

Руководство по WooCommerce Gateways Country Limiter для настройки платёжных методов по стране

WooCommerce Gateways Country Limiter нужен не для украшения страницы оплаты, а для очень конкретной задачи: показать покупателю только те способы оплаты, которые подходят его стране. В этом руководстве разберём, как мыслить такую настройку в магазине WooCommerce, что проверить перед установкой старого отдельного расширения, как использовать текущую логику WPML Multilingual & Multicurrency for WooCommerce, где искать настройки, как провести тестовый заказ и какие симптомы говорят о конфликте.

Материал полезен в двух случаях. Первый - у вас уже есть архив WooCommerce Gateways Country Limiter и нужно безопасно понять, стоит ли его включать на рабочем магазине. Второй - вы ищете ту же функцию в актуальной связке WooCommerce, WPML и WCML, потому что отдельное расширение больше не развивается как самостоятельный продукт. Мы будем отделять подтверждённые факты от осторожных рекомендаций и не будем обещать совместимость там, где её нужно проверять на стенде.

Важно понимать: старый плагин был привязан к экосистеме WPML и решал узкую задачу отображения платёжных шлюзов по стране платёжного адреса. После прекращения отдельной разработки его функции были перенесены в WPML Multilingual & Multicurrency for WooCommerce. Поэтому практическая часть руководства строится вокруг безопасного сценария: проверить статус продукта, настроить актуальный механизм, протестировать checkout и держать план отката.

Какую задачу решает ограничение платёжных шлюзов по стране

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

Логика WooCommerce Gateways Country Limiter проста: магазин определяет страну покупателя и на этой основе оставляет в checkout подходящие платёжные методы. В старом описании WPML указано, что страна бралась из платёжного адреса. В текущей логике WCML сценарий шире: страна может быть связана с геолокацией, валютой, языком, платёжным адресом или адресом доставки, если это переопределено через документированный фильтр.

Почему это важно именно для checkout, а не только для каталога

Каталог показывает товары, цены и доступность, но платёжный метод становится критичным в конце покупки. Если покупатель выбирает страну, а затем видит неподходящий метод, ошибка всплывает слишком поздно. У магазина уже есть корзина, расчёт доставки, налоговые правила и ожидание покупателя. Хорошая настройка платёжных методов по стране уменьшает не выбор, а шум: покупатель видит меньше вариантов, зато каждый вариант должен быть применим к его заказу.

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

Где проходит граница между платёжным методом, валютой и страной

Не смешивайте три разных слоя. Валюта отвечает за сумму и формат цены. Страна покупателя отвечает за доступность локальных условий. Платёжный шлюз отвечает за конкретный способ оплаты и его техническую обработку. Старый WooCommerce Gateways Country Limiter закрывал именно слой платёжных шлюзов по стране. Текущая связка WCML добавляет к этому мультивалютность, поэтому правила часто приходится проверять вместе: страна выбрала валюту, валюта влияет на шлюз, а шлюз виден или скрыт в checkout.

Если магазин продаёт в несколько регионов, тестируйте не только страницу товара. Главная проверка - корзина и оформление заказа с разными странами, валютами, способами доставки и статусом пользователя.

Текущий статус продукта и что это меняет для владельца магазина

Главный факт, который нельзя пропускать: отдельная разработка WooCommerce Gateways Country Limiter прекращена, а WPML сообщает, что функции были объединены с WPML Multilingual & Multicurrency for WooCommerce. Это не означает, что сама идея ограничения платёжных методов устарела. Устарел именно отдельный аддон как самостоятельная точка установки и обновления.

Для владельца магазина это меняет порядок принятия решения. Если вы только планируете внедрение, разумнее сначала смотреть на актуальный WCML или на современные условные payment-плагины, а не строить новую архитектуру вокруг старого отдельного расширения. Если архив уже есть и магазин давно на нём работает, задача другая: не ломать рабочий checkout, а понять, насколько безопасно продолжать, какие ограничения есть и как подготовить переход.

Когда старый архив можно рассматривать только как временное решение

Архив старого расширения может быть полезен для восстановления существующего сайта, анализа настроек или аккуратной миграции. Но для нового магазина он слабее актуального механизма по трём причинам. Во-первых, он не является текущей основной веткой разработки. Во-вторых, интерфейс WooCommerce Payments и отдельных шлюзов менялся, включая переход некоторых экранов на одностраничные интерфейсы. В-третьих, современный checkout может быть классическим или блочным, а старые расширения не всегда одинаково корректно работают с обоими вариантами.

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

Как понимать связь с WPML Multilingual & Multicurrency for WooCommerce

WPML Multilingual & Multicurrency for WooCommerce сейчас является основной точкой для мультивалютности WooCommerce в экосистеме WPML. По документации он умеет показывать валюты по местоположению, использовать геолокацию WooCommerce, настраивать валюты, иметь отдельные условия для платежей по валюте и локации в платной связке WPML. Именно поэтому в руководстве мы рассматриваем WooCommerce Gateways Country Limiter не как изолированный «плагин с одной галочкой», а как часть цепочки: страна - валюта - платёжный метод - результат в checkout.

Кому подходит такой подход, а кому лучше выбрать другое решение

Ограничение платёжных методов по стране особенно полезно магазинам, которые уже продают в несколько регионов или готовятся к этому. Если у магазина одна страна, одна валюта и один процессинг, отдельная логика country limiter обычно избыточна. Чем больше региональных различий в оплате, тем выше ценность настройки.

Подходящие сценарии

Хороший кандидат - магазин с единым каталогом, но разными условиями оплаты по странам. Например, банковский перевод доступен только в домашнем регионе, оплата при получении нужна только для локальной доставки, а картой через Stripe можно платить почти всем, кроме страны, где аккаунт провайдера не принимает платежи. В такой ситуации ограничение шлюзов делает checkout спокойнее и предотвращает заведомо неподходящие варианты.

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

Когда продукт может не подойти

WooCommerce Gateways Country Limiter может быть плохим выбором для нового проекта, если вам нужны сложные правила не только по стране, но и по товарам, категориям, ролям пользователей, купонам, сумме заказа, способу доставки и времени. Старый продукт решал более узкую задачу. В таком случае лучше смотреть на условные payment-плагины, где правила строятся как набор условий и действий.

Ещё один риск - кастомные платёжные шлюзы. Если шлюз нестандартно регистрируется в WooCommerce или использует собственный интерфейс настроек, country availability может работать иначе. В таких случаях тестируйте каждый шлюз отдельно и не переносите выводы со Stripe, PayPal, банковского перевода или оплаты при получении на кастомный процессинг.

Что проверить перед установкой и включением

Перед включением любого плагина, влияющего на checkout, нужно проверять не только совместимость WordPress. Для WooCommerce Gateways Country Limiter важнее цепочка зависимостей: WooCommerce, WPML или WCML, используемые платёжные шлюзы, тип checkout, геолокация, кеш и тема. Если хотя бы один слой ведёт себя нестандартно, покупатель может увидеть неправильный набор способов оплаты.

Проверка зависимостей

Начните с простого списка. Запишите, какие платёжные методы включены сейчас, какие страны продаются в настройках WooCommerce, какие валюты включены, используется ли WPML, активен ли WCML, включена ли геолокация и какой checkout стоит на сайте. Укажите отдельно, используется ли классическая страница оформления заказа или блоковый checkout. Это поможет не искать проблему вслепую, если после включения часть методов исчезнет.

• Проверьте, что WooCommerce активен и платёжные методы видны в WooCommerce > Settings > Payments.
• Проверьте, нужна ли магазину текущая версия WPML Multilingual & Multicurrency for WooCommerce вместо старого отдельного аддона.
• Убедитесь, что страны продаж и доставки в WooCommerce не противоречат странам, для которых вы хотите показывать платёжные методы.
• Подготовьте тестовые адреса для каждой ключевой страны: платёжный адрес, адрес доставки, индекс и способ доставки.
• Отключите агрессивное кеширование checkout, если кеш-плагин пытается кешировать корзину, оформление заказа или пользовательские фрагменты.

Почему нужна резервная копия и стенд

WPML support в похожих случаях рекомендует тестировать на копии сайта и иметь точку восстановления. Это особенно разумно для checkout. Резервная копия нужна не потому, что настройка обязательно сломает сайт, а потому что платёжная часть зависит от нескольких расширений одновременно. Если тестовая страна внезапно скрывает все методы оплаты, лучше увидеть это на стенде, а не от покупателя.

Стенд должен быть максимально похож на рабочий сайт: те же платёжные плагины, та же тема, тот же checkout, те же языки и валюты. При этом реальные платёжные ключи и секреты не нужно передавать внешним инструментам. Для проверки отображения методов часто достаточно тестового режима провайдеров или временных офлайн-методов WooCommerce.

Минимальный набор тестовых стран

Не тестируйте только одну страну, где метод должен быть виден. Нужны минимум три ситуации: страна, где метод разрешён; страна, где метод запрещён; страна с пограничной логикой, например другая валюта, другая доставка или пользователь без аккаунта. Если магазин продаёт в ЕС и за его пределы, отдельно проверьте страну внутри зоны и страну вне зоны.

Правило считается рабочим только тогда, когда оно проверено и на положительном, и на отрицательном сценарии. Видимый метод в разрешённой стране - половина проверки; скрытый метод в запрещённой стране - вторая половина.

Установка и первичная проверка без риска для заказов

Если вы работаете со старым архивом WooCommerce Gateways Country Limiter, устанавливайте его как обычный WordPress-плагин: Plugins, Add New, Upload Plugin, выбор ZIP-архива и Activate. Но после активации не переходите сразу к рабочим продажам. Сначала проверьте, появляется ли ожидаемый интерфейс в зоне настроек WooCommerce или WCML, нет ли ошибок PHP и не исчезли ли базовые платёжные методы.

Если вы внедряете функцию через актуальный WCML, порядок другой: установите WooCommerce, WPML Multilingual & Multicurrency for WooCommerce, а при необходимости полный WPML для расширенных мультиязычных возможностей. Затем перейдите в WooCommerce и раздел WCML, включите мультивалютный режим, добавьте валюты и только после этого проверьте платежи в WooCommerce > Settings > Payments.

Первичная проверка после активации

1. Откройте список плагинов и убедитесь, что расширение активировано без системных предупреждений.
2. Перейдите в WooCommerce > Status и посмотрите, нет ли критичных ошибок окружения.
3. Откройте WooCommerce > Settings > Payments и проверьте, что базовые методы не пропали.
4. Зайдите в настройки каждого важного шлюза и найдите область country availability или аналогичную настройку, если она доступна в текущей связке.
5. Сохраните настройки без изменений и проверьте, нет ли ошибки сохранения.
6. Сделайте тестовую корзину с простым товаром и откройте checkout в приватном окне браузера.

На этом этапе не нужно строить сложные правила. Цель первичной проверки - убедиться, что магазин не теряет платежи сразу после включения. Если уже здесь интерфейс не загружается, кнопка сохранения не работает или все методы исчезают, остановитесь и проверьте конфликт до настройки стран.

Что делать, если интерфейс отличается от старых инструкций

Интерфейс WooCommerce менялся, а некоторые платёжные настройки теперь могут открываться иначе. В источниках WPML есть отдельные errata по country availability для Stripe, WooPayments и офлайн-методов, где проблема связана с изменениями интерфейса WooCommerce. Поэтому отсутствие ожидаемого поля не всегда означает, что вы «не там нажали». Это может быть конфликт версии WooCommerce, WCML и конкретного платёжного плагина.

В такой ситуации не угадывайте. Проверьте известные проблемы WPML, changelog WCML и поддержку конкретного шлюза. Если проблема уже описана как resolved, обновите соответствующие компоненты на стенде. Если проблема открыта, используйте официальный обход только после проверки на тестовой копии.

Настройка правил страны, валюты и платёжного метода

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

Шаг 1. Определите источник страны

Старый продукт ориентировался на платёжный адрес покупателя. В актуальной связке WPML и WCML страна может попадать в логику через геолокацию WooCommerce, платёжный адрес, адрес доставки или пользовательский фильтр. Для магазина это принципиальная разница. Геолокация удобна на первом визите, но может ошибаться из-за VPN, прокси, корпоративных сетей и кеша. Платёжный адрес точнее для оплаты, но появляется только когда покупатель заполнил checkout. Адрес доставки важен, если метод оплаты привязан к способу получения.

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

Шаг 2. Настройте страны продаж и доставки в WooCommerce

В WooCommerce > Settings > General проверьте страны, в которые магазин продаёт и доставляет. Если WooCommerce сам не разрешает страну, настройка платёжного метода для этой страны не спасёт checkout. Покупатель может не дойти до оплаты или увидит ограничения раньше. Поэтому порядок такой: сначала география магазина, затем доставка и налоги, затем платёжные методы.

Шаг 3. Настройте валюты и геолокацию в WCML

Если вы используете текущий WCML, перейдите в раздел мультивалютности и добавьте нужные валюты. Для отображения валют по местоположению WooCommerce использует MaxMind Geolocation, а документация WooCommerce требует включить geolocation в настройках и добавить license key MaxMind. После этого страна может влиять на валюту, а валюта - на доступность платежей в связке WPML.

Не включайте правило по платёжному методу, пока не проверили, что страна и валюта определяются ожидаемо. Иначе вы будете диагностировать сразу два слоя: почему не та валюта и почему не тот метод оплаты. Сначала добейтесь стабильного определения страны, затем подключайте фильтрацию платежей.

Шаг 4. Настройте Country Availability у шлюза

В текущей документации WPML для управления платежами по локации указан путь через WooCommerce > Settings, вкладку Payments, выбор нужного payment method и настройку Country Availability. Название и расположение поля могут отличаться у конкретного шлюза. У офлайн-методов, Stripe, WooPayments и кастомных шлюзов поведение может зависеть от версии интеграции.

Практическое правило: меняйте один шлюз за раз. Например, сначала настройте банковский перевод только для одной страны, сохраните, проверьте checkout, затем переходите к оплате при получении, затем к Stripe или PayPal. Если вы измените сразу пять методов, при ошибке будет сложнее понять, какое правило сломало результат.

Типовые значения для магазина с несколькими странами

• Банковский перевод оставляйте для стран, где менеджер реально обрабатывает такие платежи и реквизиты понятны покупателю.
• Оплату при получении включайте только там, где доставка и операционный процесс поддерживают сбор денег.
• Картой через международный шлюз оставляйте шире, но проверяйте ограничения провайдера и валюты.
• Локальные методы оплаты показывайте только покупателям из стран, где эти методы известны и поддерживаются.

Как откатить спорную настройку

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

Практический пример: оставить банковский перевод только для одной страны

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

Цель

Покупатель из домашней страны видит банковский перевод и карту. Покупатель из другой страны видит карту, но не видит банковский перевод. При этом заказ должен проходить, а менеджер не должен получать неоплаченные международные заказы через неподходящий способ оплаты.

Подготовка

На стенде включите простой товар, разрешите нужные страны продаж, проверьте, что банковский перевод активен в WooCommerce > Settings > Payments. Если работаете через WCML, убедитесь, что валюта для домашней страны определяется ожидаемо. Откройте приватное окно браузера или очистите cookies, потому что геолокация и валюта могут сохраняться в cookie или профиле пользователя.

Шаги настройки

1. Откройте WooCommerce > Settings > Payments.
2. Выберите банковский перевод или другой метод, который хотите ограничить.
3. Найдите настройку Country Availability или аналогичную область, добавленную WCML.
4. Оставьте домашнюю страну в списке разрешённых стран или исключите все остальные, в зависимости от интерфейса.
5. Сохраните изменения через Save Changes.
6. Создайте корзину с тестовым товаром и перейдите к checkout.
7. Выберите платёжный адрес домашней страны и проверьте, что банковский перевод виден.
8. Измените платёжный адрес на другую страну и проверьте, что банковский перевод скрыт, а карта остаётся доступной.

Проверка результата

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

Нюанс, который часто мешает

Если метод не появляется после смены страны, не делайте вывод сразу. Checkout может хранить предыдущее состояние в сессии, валюта может быть закреплена в cookie, а кеш может отдавать старый фрагмент. Обновите checkout, очистите cookies, проверьте в приватном окне и повторите тест без входа в аккаунт. Затем проверьте залогиненного покупателя, потому что WCML может хранить выбор валюты в профиле пользователя.

Практичные идеи применения для разных магазинов

Ограничение платёжных методов по стране не стоит включать ради абстрактной «оптимизации». Оно полезно, когда у магазина есть понятная операционная причина. Ниже несколько сценариев, которые можно адаптировать без выдумывания скрытых функций продукта.

Локальный наложенный платёж без международного шума

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

Банковский перевод только для B2B-клиентов из домашнего региона

Если старый country limiter закрывает только страну, а вам нужно ещё и B2B-условие, одного продукта может не хватить. Тогда country limiter можно использовать как первый фильтр по стране, а более сложные правила отдать альтернативному conditional payment-плагину. В статье это важный пример границы возможностей: страна - да, сложная бизнес-логика - только если выбранный инструмент это поддерживает.

Локальные методы оплаты для доверия на новом рынке

Покупатель охотнее завершает заказ, когда видит знакомый платёжный метод. Но показывать локальный метод всем подряд бессмысленно. Если провайдер поддерживает метод только в одной стране или регионе, country availability позволяет не перегружать checkout лишними вариантами.

Миграция со старого аддона на WCML

Если магазин давно использовал WooCommerce Gateways Country Limiter, не переносите настройки «на глаз». Сначала выпишите текущие правила, затем создайте такие же сценарии в WCML или альтернативном решении, затем сравните checkout по странам. Цель миграции - не повторить интерфейс старого плагина, а сохранить поведение покупателя на странице оплаты.

Проверка результата после настройки

Проверка результата должна быть повторяемой. Если вы просто один раз увидели нужный метод в checkout, это ещё не значит, что правило стабильно. Составьте маленький тест-план и проходите его после каждого изменения платёжных правил, обновления WooCommerce, обновления WCML и замены платёжного шлюза.

Матрица тестирования

Как проверить геолокацию

WooCommerce использует MaxMind для определения страны, если geolocation включена. Для теста используйте приватное окно, очищайте cookies и не входите в аккаунт, если хотите проверить первого посетителя. Онлайн-сервисы и VPN могут помочь, но WooCommerce прямо предупреждает, что VPN не всегда даёт одинаково точный результат. Поэтому для финальной проверки важнее не «я вижу сайт как страна X», а то, что checkout корректно реагирует на выбранный платёжный или доставочный адрес.

Что записать после проверки

После успешного теста зафиксируйте, какие страны и методы проверены, какой checkout использован, какие плагины активны и где находится настройка. Эта короткая внутренняя заметка сэкономит время при следующем обновлении. В больших магазинах полезно держать таблицу «страна - валюта - доставка - платёжный метод - последний тест».

Безопасная доработка: когда страна должна браться из адреса доставки

Иногда платёжный метод зависит не от страны плательщика, а от страны доставки. Например, оплата при получении доступна только там, где курьерская служба реально собирает деньги. В документации WCML есть фильтр wcml_geolocation_get_user_country, который позволяет переопределить страну, используемую WCML. Это не универсальная рекомендация для всех магазинов, но полезный безопасный пример, если бизнес-логика действительно должна опираться на доставку.

Добавляйте такой snippet только на тестовой копии, через дочернюю тему или Code Snippets. Не правьте ядро WordPress, WooCommerce, WPML, WCML или старого плагина. После проверки легко отключите snippet и вернитесь к исходному поведению.

add_filter( 'wcml_geolocation_get_user_country', function( $user_country, $all_countries ) {
    // Используем страну доставки, если покупатель уже указал её в checkout.
    if ( ! empty( $all_countries['shipping'] ) ) {
        return $all_countries['shipping'];
    }

    return $user_country;
}, 10, 2 );

Проверка после вставки такая: откройте checkout, выберите платёжный адрес одной страны и адрес доставки другой страны, затем посмотрите, какой набор методов отображается. Если логика стала непредсказуемой, отключите snippet и вернитесь к штатному источнику страны. Код не должен заменять нормальную настройку платежей; он нужен только для узкого случая, где документированный фильтр лучше отражает бизнес-правило.

Почему платёжный метод не появляется или не скрывается

Ошибки в country limiter обычно выглядят одинаково: метод не виден там, где должен быть виден, виден там, где должен быть скрыт, или checkout пишет, что нет доступных способов оплаты. Но причины разные. Ниже - диагностический маршрут, который помогает не прыгать сразу к переустановке плагина.

Метод не виден в разрешённой стране

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

Проверьте сам шлюз в WooCommerce > Settings > Payments, затем проверьте страну в платёжном адресе, затем очистите cookies и повторите тест в приватном окне. Если метод связан с доставкой, выберите способ доставки до проверки платежей. Если после отключения country-правила метод появляется, проблема в правиле. Если не появляется, проблема ниже по цепочке - в шлюзе, доставке, валюте или checkout.

Метод виден в запрещённой стране

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

Если магазин использует WCML, посмотрите, не переопределяет ли страна через фильтр или кастомный код. Если включены другие conditional payment-плагины, временно отключите их на стенде и проверьте, не возвращают ли они метод обратно. Правильное поведение - один слой скрывает метод, а другой не должен снова показывать его без причины.

В checkout нет ни одного способа оплаты

Симптом: после настройки страна видит пустой блок оплаты. Это критичнее, чем один лишний метод. Возможная причина - все методы скрыты правилами, валюта не поддерживается ни одним шлюзом, доставка не выбрана, страна не входит в продажи WooCommerce или кастомный шлюз отключился из-за своих условий.

Исправление начинайте с fallback-метода. Для каждой страны должен оставаться хотя бы один рабочий способ оплаты, если магазин реально принимает заказы из этой страны. Если такого метода нет, лучше запретить продажу или доставку в этой стране раньше, чем доводить покупателя до пустого checkout.

Настройка Country Availability не сохраняется

Симптом: вы выбираете страны, нажимаете Save Changes, но настройка сбрасывается. У WPML были известные проблемы такого типа для отдельных шлюзов, включая Stripe и WooPayments. Проверьте errata WPML и версии WCML, WooCommerce и платёжного плагина. Если проблема описана как исправленная, обновляйте на стенде. Если проблема открыта, используйте официальный workaround только после резервной копии.

После обновления WooCommerce пропал раздел настройки

Симптом: поле country availability раньше было, а после обновления интерфейс изменился. Для некоторых офлайн-методов WPML описывал ситуацию, где настройки не появлялись из-за миграции интерфейса WooCommerce в SPA. В этом случае не пытайтесь вручную менять таблицы базы. Проверьте, есть ли обновление WCML с исправлением, и временно откатите только на стенде, если это прямо рекомендовано источником и критично для магазина.

Когда лучше откатить настройку

Откатывайте последнее изменение, если пустой checkout появляется хотя бы в одной продаваемой стране, если метод сохраняется нестабильно, если заказ создаётся в неправильной валюте или если ошибка затрагивает основной платёжный метод. Платёжные правила не должны быть экспериментом на живом трафике.

Ограничения, совместимость и влияние на скорость

Country limiter не должен заметно менять скорость каталога, если он работает только на уровне checkout и настроек шлюзов. Но он может влиять на пользовательский путь, потому что список методов пересчитывается при изменении адреса, доставки, валюты или сессии. Поэтому самая важная совместимость - не «страница товара загружается быстро», а «checkout корректно обновляет методы без кеша и без конфликтов».

Кеш и сессии

Страницы корзины и оформления заказа обычно нельзя кешировать как обычные статичные страницы. Если кеш-плагин отдаёт старый HTML или старые фрагменты, покупатель может видеть методы от предыдущей страны. WooCommerce и WCML используют сессии, cookies и AJAX-обновления, поэтому исключения для checkout должны быть настроены аккуратно.

Если магазин использует мультивалютность с кешем, проверьте документированные настройки WCML, включая возможность добавлять параметр валюты в URL для корректного переключения. Это не настройка WooCommerce Gateways Country Limiter напрямую, но она влияет на ту же цепочку принятия решения: страна и валюта должны совпадать с тем, что видит покупатель.

Блочный checkout и классический checkout

Многие современные payment-плагины отдельно заявляют совместимость с WooCommerce Blocks checkout. Старое расширение могло проектироваться под классический checkout. Если сайт уже использует блоковую страницу оформления заказа, проверьте её отдельно. Если правило работает в классическом checkout, но не работает в блоковом, это не обязательно ошибка настройки. Это может быть ограничение поддержки конкретного плагина или шлюза.

Кастомные шлюзы и нестандартные регистрации

WooCommerce регистрирует платёжные шлюзы как объекты с идентификаторами, названиями и настройками. Если custom gateway ведёт себя не как обычный WC_Payment_Gateway или добавляет собственный интерфейс, ограничения могут применяться иначе. В поддержке WPML встречались ошибки, где взаимодействие WCML с платёжными шлюзами приводило к техническим сбоям. Поэтому custom gateway всегда проверяйте последним, после базовых методов.

Как принять решение о переходе на актуальное решение

Если у вас новый магазин, решение почти прямое: не начинайте с отдельного старого WooCommerce Gateways Country Limiter, если ту же функцию можно собрать в актуальной и поддерживаемой связке. Если у вас старый магазин, решение должно быть осторожнее. Не заменяйте рабочий механизм только ради «обновления». Сначала составьте карту текущих правил, затем проверьте, какой новый инструмент воспроизводит их без потери сценариев.

Карта миграции

1. Экспортируйте или вручную перепишите текущие правила: метод, разрешённые страны, исключения, комментарий.
2. Определите, какие правила относятся только к стране, а какие завязаны на валюту, доставку, товары или роли.
3. Для правил только по стране проверьте WCML country availability.
4. Для сложных условий выберите conditional payment-плагин и проверьте поддержку ваших шлюзов.
5. Создайте тестовую матрицу checkout и сравните старое и новое поведение.
6. Переносите на рабочий сайт только после успешного теста и резервной копии.

Ближе к финальной проверке полезно получить файл WooCommerce Gateways Country Limiter, если вам нужен именно архив для анализа старой конфигурации или восстановления совместимости на существующем сайте. Для нового внедрения используйте этот шаг как повод ещё раз проверить, не закрывает ли текущий WCML вашу задачу лучше.

Что не стоит переносить

Не переносите правила, причина которых уже неизвестна. Если в старом плагине когда-то была исключена страна, но никто не помнит зачем, сначала проверьте реальные условия провайдера, доставки и валюты. Также не переносите временные workarounds, если известная проблема уже исправлена в новой версии WCML или шлюза.

Когда WooCommerce Gateways Country Limiter будет удачным выбором

WooCommerce Gateways Country Limiter полезен как концепция и как ориентир для старых магазинов: страна покупателя должна управлять тем, какие платёжные методы он видит. Но как отдельный продукт он требует осторожности, потому что официально больше не развивается отдельно. Поэтому лучший путь для большинства новых сайтов - использовать актуальную логику WPML Multilingual & Multicurrency for WooCommerce или современный conditional payment-плагин, если правил больше, чем просто страна.

Если вы работаете с уже существующим архивом, подходите к нему как к инструменту миграции или поддержки старой конфигурации. Проверьте зависимости, настройте один метод за раз, сохраните карту правил, проведите тесты для разрешённых и запрещённых стран, проверьте пустой checkout и только после этого переносите изменения на рабочий магазин. Тогда ограничение платёжных методов будет помогать покупателю, а не превращаться в скрытую точку отказа.