Aelia Tax Display by Country for WooCommerce - Плагин WordPress

Руководство по настройке Aelia Tax Display by Country for WooCommerce для международного магазина

Aelia Tax Display by Country for WooCommerce нужен не для "красивого вывода цены", а для более тонкой задачи: показать покупателю цену с налогом или без налога в зависимости от страны, которую плагин определяет автоматически или получает от самого покупателя. В этом руководстве разберём, как подготовить WooCommerce, какие настройки проверить после установки, как связать правила показа с налоговыми ставками и как убедиться, что корзина, оформление заказа и письма не дают покупателю противоречивые суммы.

Материал рассчитан на владельца магазина, администратора WooCommerce и разработчика, которому нужно внедрить понятную налоговую логику без правки ядра магазина. Здесь не будет инструкций по покупке, лицензированию или обходу активации. Мы будем говорить о рабочем применении уже установленного продукта: сценариях, настройке, проверке результата, диагностике геолокации, виджете выбора страны, фиксированных ценах и ограничениях, которые важно понять до запуска на живом трафике.

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

Какую задачу решает плагин и где он особенно полезен

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

Aelia Tax Display by Country for WooCommerce добавляет слой управления по стране. Плагин определяет страну посетителя через геолокацию, может предварительно выбрать страну в оформлении заказа и даёт покупателю виджет выбора страны до перехода к оплате. На практике это помогает в трёх типовых ситуациях.

Международный B2C-магазин с разными ожиданиями по НДС

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

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

Магазин с фиксированной витринной ценой

В WooCommerce цена, введённая как сумма с налогом, обычно считается включающей налог базовой страны магазина. Если ставка покупателя отличается от базовой, итоговая витринная цена может измениться. Это не ошибка плагина, а логика WooCommerce. Aelia Tax Display by Country for WooCommerce добавляет режим фиксированных цен для товаров: можно сохранить одинаковую итоговую цену для покупателя, а налоговая часть внутри суммы будет отличаться по стране.

Такой режим удобен, когда маркетинговая цена должна оставаться одинаковой: например, товар должен выглядеть как 100 единиц валюты для разных стран, даже если налоговая доля внутри суммы меняется. Но у режима есть важный нюанс: по документации Aelia, фиксированные цены предназначены именно для товарных цен; доставка в WooCommerce рассматривается как сумма без налога, и её нельзя таким же способом удерживать фиксированной через этот механизм.

Сайт, где страна должна быть выбрана до оформления заказа

Если покупатель доходит до checkout и только там видит поле страны, у него может быть неприятный сюрприз: цена меняется, появляется налог, пропадает налог или меняется доступная доставка. Country selector widget помогает вынести выбор страны выше по пути пользователя: в сайдбар, шапку, страницу магазина или блок перед списком товаров. Покупатель заранее выбирает страну, а магазин показывает более ожидаемую цену.

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

Кому подходит Aelia Tax Display by Country for WooCommerce, а кому лучше выбрать другой подход

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

Хороший сценарий для этого плагина

Продукт подходит магазину, который уже использует WooCommerce Tax settings, понимает свои налоговые зоны и хочет управлять витринным восприятием цены по стране. В такой конфигурации плагин становится связующим слоем между геолокацией, выбранной страной покупателя, виджетом и правилами показа цены. Он не требует перестройки каталога и не заставляет вводить отдельные цены для каждой страны.

Ещё один сильный сценарий - магазин, где применяется Aelia Currency Switcher. Официальная страница Tax Display by Country указывает совместимость с этим решением. Вместе они позволяют связать выбор страны, валюты и отображения налога, но такую связку нужно тестировать особенно внимательно: валюта, страна и налоговая ставка влияют на разные части расчёта.

Когда плагин может не закрыть задачу

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

Также не стоит ожидать, что IP-геолокация всегда даст идеальный результат. MaxMind прямо описывает IP-геолокацию как неточную технологию: чаще всего определяется страна, но точность региона, города и почтового кода может отличаться. Для Tax Display by Country это означает, что виджет выбора страны и проверка checkout остаются важной страховкой.

Что проверить перед установкой на рабочий магазин

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

Базовые настройки WooCommerce

Начните с WooCommerce > Settings > General. Налоги должны быть включены, иначе вкладка налогов в WooCommerce может не отображаться. Затем проверьте WooCommerce > Settings > Tax: как введены цены, по какому адресу рассчитывается налог, как цены показываются в магазине, корзине и checkout. Эти параметры остаются фундаментом. Aelia Tax Display by Country for WooCommerce не заменяет их, а работает поверх них.

Особенно важны три значения: Prices entered with tax, Display prices in the shop и Display prices during cart and checkout. Документация WooCommerce предупреждает, что смешанные режимы могут приводить к неожиданному округлению и конфликтам отображения. Если магазин уже показывает предупреждения WooCommerce по налоговым настройкам, сначала разберитесь с ними, а потом подключайте правила по стране.

Налоговые ставки и страна базового магазина

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

Для каждого теста заранее запишите ожидаемое поведение: витрина с налогом или без, корзина с налогом или без, checkout по billing или shipping country, итоговая сумма и суффикс цены. Такой лист пригодится при проверке после включения.

Зависимости, геолокация и кеш

На странице продукта указано, что для работы требуется Aelia Foundation Classes for WooCommerce. Этот компонент используется в том числе для геолокации и работы с GeoLite data. Если база геолокации не загружается или сервер отдаёт неверные IP-заголовки, страна покупателя может определяться неправильно.

Отдельно проверьте кеш. Плагин меняет отображение цены в зависимости от страны, а полный статический кеш страницы может сохранить цену для одного посетителя и показать её другому. Если на сайте есть серверный кеш, кеш WordPress, CDN или агрессивная оптимизация HTML, настройте исключения для фрагментов, где зависит цена, или проверьте, что кеш учитывает cookie/контекст страны. Без этого любая геолокация будет выглядеть случайной.

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

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

Устанавливайте плагин как обычное расширение WordPress через Plugins > Add New или загрузку ZIP-файла в админ-панели. После активации проверьте, что зависимый компонент Aelia Foundation Classes установлен и активен. Если в админ-панели появилось предупреждение о GeoIP database, не игнорируйте его: для корректной автостраны база должна быть доступна и обновляема.

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

Где искать настройки после включения

По документации и скриншотам Aelia, ключевые настройки плагина находятся в зоне WooCommerce и Tax Display by Country. В руководствах Aelia встречается путь WooCommerce > Tax Display by Country > Tax Calculation для режима фиксированных цен. Для общих параметров Aelia и поддержки используется путь WooCommerce > Settings > Aelia > Support, где можно включить отладочный режим и посмотреть расположение журнала.

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

Первая витринная проверка

1. Откройте страницу простого товара в приватном окне браузера.
2. Проверьте цену до выбора страны и запишите, какой режим сработал по умолчанию.
3. Используйте VPN или тестовую сеть для другой страны, если проверяете геолокацию.
4. Добавьте товар в корзину и перейдите к оформлению заказа.
5. Проверьте, какая страна предварительно выбрана в полях billing и shipping.
6. Сохраните скриншоты карточки товара, корзины и checkout для сравнения.

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

Настройка правил показа цены по странам

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

Логика "страна - отображение - налоговая ставка"

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

1. В WooCommerce добавлены налоговые ставки для нужных стран и регионов.
2. В настройках WooCommerce выбран адрес, по которому рассчитывается налог.
3. В Aelia Tax Display by Country настроены страны, где цена должна показываться с налогом или без него.
4. Витрина проверена до выбора страны и после выбора страны через виджет.
5. Checkout проверен с billing country и shipping country, если они могут отличаться.

Если в вашей налоговой модели решающим является адрес доставки, не полагайтесь только на billing country. Официальный changelog Aelia содержит исправления, связанные с checkout block и отслеживанием billing country при расчёте налогов по shipping country. Это хороший сигнал: в магазинах с блоковым checkout и сложной налоговой логикой нужно отдельно проверять, какая страна реально влияет на расчёт.

Суффиксы цены и текстовые пояснения

Официальная страница продукта указывает, что для каждого tax display rule можно задать price suffix. Это полезно, когда один и тот же магазин показывает разным посетителям разные режимы цены. Суффикс не должен быть длинным юридическим текстом. Его задача - быстро объяснить, что видит покупатель: например, цена включает местный налог или налог будет рассчитан на checkout.

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

Режим фиксированных цен

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

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

Когда не включать фиксированные цены

Не включайте режим только потому, что цена "прыгает" между странами. Сначала проверьте, что вы правильно понимаете настройку Prices entered with tax. В WooCommerce цена, введённая с налогом, привязана к налогу базовой страны магазина. Когда применяется ставка другой страны, итоговая сумма может измениться. Иногда это именно ожидаемый налоговый результат, а не ошибка.

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

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

Виджет выбора страны и shortcode в реальном интерфейсе магазина

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

Вывод через WordPress Widgets

Документация Aelia описывает стандартный путь: откройте Appearance > Widgets, найдите виджет WooCommerce Tax Display by Country - Billing Country Selector, перетащите его в область виджетов, укажите заголовок и тип, затем сохраните. После этого покупатель увидит selector в публичной части сайта там, где область виджетов выводится вашей темой.

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

Вывод через shortcode

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

[aelia_tdbc_country_selector_widget title="Choose your billing country" widget_type="dropdown" state_label="Province/State"]

Параметр title задаёт заголовок, widget_type по документации из коробки поддерживает dropdown, а state_label используется, если включена обработка штата или провинции. Для русского сайта внешний заголовок лучше адаптировать в интерфейсе темы или переводах, но точные параметры shortcode оставляйте как есть.

Аккуратная CSS-настройка внешнего вида

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

.widget_wc_aelia_country_selector_widget {
  margin: 16px 0;
}

.widget_wc_aelia_country_selector_widget .countries {
  max-width: 280px;
}

.widget_wc_aelia_country_selector_widget .change_country {
  margin-top: 8px;
}

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

Практический сценарий: показать НДС для ЕС и убрать налог для покупателей вне ЕС

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

Цель и подготовка

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

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

1. В WooCommerce > Settings > General включите расчёт налогов, если он ещё не включён.
2. В WooCommerce > Settings > Tax проверьте, как введены цены: с налогом или без налога.
3. Добавьте налоговые ставки для стран, которые должны получать налоговую строку.
4. В настройках Tax Display by Country создайте правила отображения: выбранным странам - price including tax, остальным - price excluding tax.
5. Настройте короткий price suffix для каждой группы, чтобы покупатель понимал режим цены.
6. Добавьте country selector widget на страницу магазина или в видимую область перед checkout.
7. Сохраните настройки и очистите кеш сайта, если он есть.

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

Откройте карточку тестового товара как покупатель из первой страны. Цена и суффикс должны соответствовать правилу. Затем смените страну через виджет и обновите страницу, если тема не обновляет цену мгновенно. После этого добавьте товар в корзину и проверьте checkout: страна должна быть выбрана ожидаемо, налоговая строка должна соответствовать ставке, а итоговая сумма не должна противоречить карточке товара.

Повторите тест для страны без налога. Если цена на витрине стала без налога, но checkout всё равно начисляет налог, проверьте tax rates и поле страны. Если checkout показывает верный налог, но карточка товара не меняется, проверьте кеш и работу selector.

Нюанс с fixed prices

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

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

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

Матрица тестов для витрины и checkout

Создайте таблицу в документе или системе задач. В строках укажите страны, в колонках - ожидаемое отображение, фактическую цену в карточке товара, цену в корзине, налоговую строку в checkout и итог. Для каждого теста фиксируйте, использовалась ли геолокация, ручной selector или прямое изменение страны в checkout.

Проверка геолокации без догадок

Aelia рекомендует включать debug mode в WooCommerce > Settings > Aelia > Support, чтобы журнал показывал попытки определения геолокации. Проверка через VPN и приватное окно помогает создать новые записи. В журнале смотрите не только страну, но и IP-заголовки: HTTP_CLIENT_IP, HTTP_X_FORWARDED_FOR, HTTP_X_REAL_IP, REMOTE_ADDR. Если все посетители выглядят как один IP, причина может быть в reverse proxy или настройках хостинга.

После диагностики debug mode нужно выключить. Документация Aelia предупреждает, что журнал может быстро расти на сайте с трафиком. Это типичный пример настройки, которую включают только на время проверки, а не оставляют навсегда.

Рабочий журнал тестов для налоговой витрины

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

Такой журнал не должен быть громоздким. Его задача - сохранить контрольные ожидания. Если через месяц кто-то жалуется, что цена для Германии стала другой, вы открываете журнал и видите: какая цена была ожидаемой, какая страна выбиралась, по какому адресу считался налог, был ли включён fixed prices и какой suffix должен показываться. Это сильно сокращает время диагностики.

Какие контрольные случаи записать

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

В каждой строке фиксируйте не только итоговую цену. Записывайте исходную цену товара в админ-панели, режим Prices entered with tax, правило Tax Display by Country, выбранную страну, налоговую строку в checkout и итог заказа. Если используется fixed prices, добавьте колонку "фиксированная цена включена". Если fixed prices включается условно через фильтр, добавьте колонку с ожидаемым условием.

Как проверять обновления без паники

Перед обновлением WooCommerce или Aelia-плагинов сделайте тест на staging-копии. Если staging нет, выберите время с низким трафиком и подготовьте откат. После обновления пройдите журнал сверху вниз. Не меняйте несколько переменных одновременно: сначала обновление, потом проверка; только затем изменение правил, кеша или шаблона checkout. Если после обновления изменился только один контрольный случай, ищите причину в конкретной связке страны, адреса и режима отображения.

Особенно внимательно проверяйте гостевой checkout. В changelog Aelia были исправления, связанные с guest users, checkout block и Store API. Это не означает, что ваш сайт обязательно столкнётся с ошибкой, но показывает, что именно checkout-поверхность зависит от деталей реализации WooCommerce. Зарегистрированный пользователь, гость, пользователь с сохранённым адресом и покупатель с новой страной могут проходить через разные состояния формы.

Что писать в журнале после инцидента

Если покупатель сообщил о неверном налоге, не ограничивайтесь записью "исправлено". Сохраните симптом, страну, адрес, товар, активную валюту, выбранный метод доставки, тип checkout, состояние кеша и способ исправления. Через несколько таких записей вы увидите закономерности: например, проблема возникает только после выбора страны в виджете, только при shipping address, только в гостевом checkout или только после попадания страницы в кеш.

Такой журнал помогает и разработчику, и поддержке. Вместо общего сообщения "налоги не работают" вы сможете сформулировать проверяемый кейс: "для страны без ставки карточка товара показывает цену без налога, но checkout после выбора shipping country снова добавляет налог; кеш отключён; fixed prices выключен". С таким описанием проще проверить настройки WooCommerce, логи Aelia и поведение соседних плагинов.

Безопасные доработки без правки файлов плагина

Tax Display by Country допускает кастомизацию, но не всякая кастомизация нужна обычному магазину. Чем ближе правка к расчёту налогов, тем больше риск получить ошибку в заказе. Поэтому безопасная стратегия такая: внешний вид и размещение виджета можно адаптировать смелее, а программное изменение страны или fixed prices включать только при понятной причине, тестовом контуре и возможности быстро отключить код.

Что можно делать без разработчика

Администратор магазина может добавить country selector через widgets или shortcode, изменить заголовок, выбрать место вывода, настроить короткий suffix и проверить отображение на нескольких страницах. Также можно добавить простой CSS для ширины dropdown, отступов и кнопки, если тема выводит widget неаккуратно. Эти изменения обратимы и не влияют на налоговый расчёт.

Важно не использовать CSS как способ скрыть неудобную налоговую информацию. Если покупатель должен увидеть suffix или пояснение к цене, не прячьте его ради чистого дизайна. Лучше сделать текст короче и понятнее. Налоговый интерфейс должен быть аккуратным, но не скрытным.

Что отдавать разработчику

Кодовые сценарии Aelia - например, принудительная страна через woocommerce_init или условное включение fixed prices через wc_aelia_tdbc_keep_prices_fixed - стоит отдавать разработчику. В официальной KB такие примеры прямо помечены как кастомизация вне обычной поддержки. Это разумное предупреждение: код может зависеть от темы, кеша, multilingual-плагина, порядка хуков и состояния checkout.

Если разработчик добавляет snippet, попросите его сделать четыре вещи: описать цель, указать условие срабатывания, добавить способ отключения и приложить тестовую матрицу. Код не должен жить в файле родительской темы или внутри плагина. Безопаснее использовать дочернюю тему, отдельный мини-плагин или управляемый snippets-плагин, где фрагмент можно выключить без FTP.

Как не испортить SEO и индексацию цен

Налоговое отображение по стране может влиять на то, какую цену увидит поисковый робот, сервис предпросмотра или система кеширования. В KB Aelia есть пример, как задать страну для bots через код, но это уже кастомизация и её нельзя применять вслепую. Для большинства магазинов достаточно последовательной витринной логики: роботы видят нейтральный или базовый вариант, пользователи могут сменить страну, checkout подтверждает точный налог по адресу.

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

Совместимость с кешем, блоковым checkout и соседними налоговыми плагинами

Tax Display by Country находится на пересечении нескольких подсистем: WooCommerce tax settings, геолокации, cookies, checkout, темы и кеша. Поэтому большинство сложных проблем возникает не в одном плагине, а на границе между ними.

Кеш и динамические цены

Если страница товара кешируется целиком, а цена зависит от страны, кеш должен понимать эту зависимость. В противном случае первый посетитель создаст статическую версию страницы, а следующий увидит цену не для своей страны. На практике проверьте три уровня: плагин кеширования WordPress, серверный кеш хостинга и CDN. Для WooCommerce-магазинов обычно исключают корзину, checkout, account pages и динамические фрагменты. Для страницы товара решение зависит от кеш-системы: иногда можно варьировать кеш по cookie, иногда проще исключить критичные фрагменты.

Cart и checkout blocks

Современные версии WooCommerce активно используют блочные корзину и checkout. Changelog Aelia содержит несколько записей о совместимости с WooCommerce, Store API и checkout block. Это не повод бояться блоков, но повод тестировать именно тот checkout, который стоит на сайте. Если у вас кастомная тема или плагин оплаты, проверьте гостевой заказ, смену страны, shipping address и billing address отдельно.

Плагины VAT, валюты и региональных цен

Если на сайте одновременно работают Currency Switcher, EU VAT Number, Prices by Country или налоговый сервис, распределите обязанности. Tax Display by Country отвечает за показ цены по стране и связанную country selection логику. VAT-плагин может проверять номер компании и освобождать от налога. Сервис вроде Avalara может рассчитывать налоговые обязательства. Плагин региональных цен может менять саму цену товара по стране. Когда все эти задачи смешаны, ошибки трудно найти.

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

Диагностика частых проблем с налогом, страной и ценами

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

Цена выглядит неправильной после смены страны

Симптом

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

Причина и проверка

Чаще всего это связано с тем, как WooCommerce работает с ценами, введёнными с налогом. Такая цена включает налог базовой страны магазина. Когда применяется другая ставка, WooCommerce пересчитывает базу и налоговую часть. Проверьте настройку Prices entered with tax и сравните результат с примером из документации WooCommerce.

Как исправить

Если бизнес-логика требует одинаковой итоговой цены товара, протестируйте режим fixed prices в Tax Display by Country. Если одинаковая цена не нужна, оставьте стандартный пересчёт и объясните покупателю режим цены через suffix. Откатывайте fixed prices, если он ухудшает маржу или создаёт конфликт с доставкой.

Страна определяется неверно

Симптом

Посетитель из одной страны видит цены и checkout для другой страны. В тестах через VPN результат нестабилен.

Причина и проверка

IP-геолокация может ошибаться, а reverse proxy или CDN может передавать серверный IP вместо IP посетителя. Включите debug mode в WooCommerce > Settings > Aelia > Support, повторите тест в приватном окне и посмотрите IP-заголовки в журнале. Если виден один и тот же IP для разных посетителей, обратитесь к хостингу или настройте передачу реального IP.

Как исправить

Исправьте заголовки на уровне хостинга/CDN, обновите GeoIP database, дайте покупателю country selector и выключите debug mode после проверки. Не используйте геолокацию как единственный источник истины, если checkout требует точного адреса.

После выбора страны страница товара не меняется

Симптом

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

Причина и проверка

Вероятная причина - кеш страницы, который не учитывает cookie выбранной страны. Проверьте сайт в приватном окне, временно отключите оптимизацию HTML для страницы товара или исключите страницу из кеша на время теста.

Как исправить

Настройте исключение или vary-by-cookie в кеш-системе, если она это поддерживает. Если нет, выводите selector и цены на страницах, где WooCommerce обновляет фрагменты динамически, и отдельно тестируйте каталог.

Checkout показывает другой налог, чем карточка товара

Симптом

В карточке товара цена выглядит правильно, но в checkout налоговая строка меняется после ввода адреса.

Причина и проверка

WooCommerce может считать налог по billing address, shipping address или shop base address. Если правило отображения использовало одну страну, а checkout рассчитал налог по другой, появится расхождение. Проверьте Calculate tax based on и тестируйте billing и shipping отдельно.

Как исправить

Согласуйте правила Tax Display by Country с налоговой базой WooCommerce. Если налог считается по shipping country, убедитесь, что плагин и checkout не подставляют только billing country. Для блочного checkout обязательно проверяйте гостевой заказ.

GeoIP database не загружается или не обновляется

Симптом

В админ-панели появляется сообщение о невозможности скачать или найти GeoIP database.

Причина и проверка

Aelia Foundation Classes использует MaxMind GeoLite2 database. Если автоматическая загрузка не работает, проверьте доступность uploads folder, права записи и точное имя файла GeoLite2-City.mmdb. Документация Aelia описывает ручную установку в wp-content/uploads и необходимость корректных прав.

Как исправить

Исправьте права и путь uploads, установите базу вручную по инструкции Aelia/MaxMind, затем повторите тест геолокации. Не оставляйте сайт в состоянии, где страна угадывается без рабочей базы и без виджета выбора.

Когда Aelia Tax Display by Country for WooCommerce будет удачным выбором

Aelia Tax Display by Country for WooCommerce стоит использовать, если вы уже понимаете налоговую модель магазина и хотите сделать витрину более понятной для покупателей из разных стран. Его сильные стороны - отображение цены с налогом или без налога по стране, автоматическое определение страны, предварительный выбор checkout country, country selector widget, price suffix per rule и режим фиксированных товарных цен.

Перед запуском не пропускайте тесты. Проверьте настройки WooCommerce, ставки, геолокацию, кеш, виджет, корзину, checkout, письма и один реальный тестовый заказ. Если всё совпадает с вашей матрицей ожиданий, можно скачать последнюю версию Aelia Tax Display by Country for WooCommerce и переходить к внедрению на рабочем магазине с понятным планом отката.

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