Использование оператора USER_COUNTRY в uCoz

Оператор $USER_COUNTRY$ — один из самых полезных инструментов в шаблонах uCoz, когда нужно управлять выводом контента в зависимости от страны, из которой пользователь заходит на сайт. Он подставляет двухсимвольный международный код страны в формате ISO 3166-1 alpha-2, определённый по IP посетителя.

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

Как работает $USER_COUNTRY$

Оператор выводит код страны, например:

• US
• UA
• PL
• DE
• FR
• RU

Использование в условии:

<?if($USER_COUNTRY$=="US")?>...<?endif?>

Это стандартная проверка равенства, которая работает во всех шаблонах модулей uCoz.

Где взять список кодов стран ISO

Полный перечень всех международных кодов:

• https://www.iso.org/obp/ui/#search
• https://www.iban.com/country-codes

Коды используются только в двухсимвольном формате.

Важное примечание о возможной некорректности работы

Геоданные определяются по IP. Если трафик проходит через прокси, оператор $USER_COUNTRY$ может показывать не реальную страну посетителя, а страну узла, через который идёт трафик.

Когда возможны искажения:

• Cloudflare работает в режиме прокси (оранжевая иконка)
• DDoS-Guard стоит перед сайтом
• любой CDN, который подменяет реальный IP посетителя
• пользователь использует VPN, корпоративную сеть или мобильные NAT-сети

Последствия:

• посетитель из США может отображаться как RU
• посетитель из Германии может отображаться как NL
• гео-логика условий может срабатывать неправильно

Это нужно учитывать при создании условий.

Основные примеры условий

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

<?if($USER_COUNTRY$=="US")?>
 ... содержимое ...
<?endif?>

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

<?if($USER_COUNTRY$!="RU")?>
 ... содержимое ...
<?endif?>

Показать блок для нескольких стран

<?if(
 $USER_COUNTRY$=="UA" ||
 $USER_COUNTRY$=="PL"
)?>
 ... содержимое ...
<?endif?>

Скрыть блок для набора стран

<?if(
 $USER_COUNTRY$!="RU" &&
 $USER_COUNTRY$!="BY" &&
 $USER_COUNTRY$!="KZ"
)?>
 ... содержимое ...
<?endif?>

Создать условие под регион (например Европа)

<?if(
 $USER_COUNTRY$=="DE" ||
 $USER_COUNTRY$=="PL" ||
 $USER_COUNTRY$=="FR" ||
 $USER_COUNTRY$=="IT"
)?>
 ... европейский вариант блока ...
<?endif?>

Практические варианты использования

Персональные уведомления по стране

<?if($USER_COUNTRY$=="US")?>
<div class="note">
 Доставка в США временно приостановлена.
</div>
<?endif?>

Локализованный баннер

<?if($USER_COUNTRY$=="PL")?>
<img src="/banners/promo-pl.jpg" alt="">
<?endif?>

Ограничение контента для отдельных стран

<?if(
 $USER_COUNTRY$!="RU" &&
 $USER_COUNTRY$!="BY"
)?>
 ... контент ...
<?endif?>

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

<?if($USER_COUNTRY$=="DE")?>
<div class="local-hint">
 Вам может подойти немецкая версия сайта.
</div>
<?endif?>

Гео-акции и спецпредложения

<?if($USER_COUNTRY$=="UA")?>
<div class="promo">
 Спецпредложение для посетителей из Украины.
</div>
<?endif?>

Ограничение способов оплаты

<?if($USER_COUNTRY$!="US")?>
<div class="payment-warning">
 Этот способ оплаты недоступен в вашей стране.
</div>
<?endif?>

Изменение оформления по стране

<?if($USER_COUNTRY$=="JP")?>
<style>
body {
 background-image: url(/themes/japan.jpg);
}
</style>
<?endif?>

Локализованные тексты и подсказки

<?if($USER_COUNTRY$=="FR")?>
<div>
 Контент на французском языке.
</div>
<?else?>
<div>
 Английская версия текста.
</div>
<?endif?>

Итог

Оператор $USER_COUNTRY$ — удобный и мощный инструмент для гео-таргетинга внутри шаблонов uCoz. Он позволяет:

• выводить разные блоки для разных стран
• ограничивать доступ к части контента
• адаптировать внешний вид под регион
• показывать акции и уведомления по гео
• менять тексты в зависимости от страны
• защищать сайт от определённых регионов

Главное учитывать, что при использовании Cloudflare, DDoS-Guard и других прокси-систем оператор может выводить не реальную страну пользователя, а страну узла прокси. В таких ситуациях условия будут работать иначе, чем ожидалось.