Разделы документации

Шорткод WT_GEOTARGETING

Шорткод wt_geotargeting — базовый инструмент геотаргетинга в бесплатной версии плагина WT Geotargeting. Он сравнивает условия в атрибутах шорткода с данными геолокации по IP и в зависимости от результата выводит или скрывает вложенный контент.

В расширенной версии плагина (WT Geotargeting Pro) рекомендуется по возможности переходить на более гибкий шорткод wt_location, но wt_geotargeting по-прежнему может использоваться для простых сценариев и обратной совместимости.

Назначение

  • Условный вывод контента на основе города, региона, округа и страны посетителя (по данным IP-геолокации).
  • Простая маршрутизация контактов: разные телефоны, адреса или заголовки для разных городов/регионов.
  • Вывод технических данных геолокации (IP, страна, город, координаты) без написания PHP-кода.

Синтаксис

[wt_geotargeting Атрибут="Значение атрибута" Атрибут_2="Значение атрибута 2" ...]Выводимый контент[/wt_geotargeting]

Шорткод без атрибутов

Шорткод без атрибутов не выводит контент — он возвращает пустую строку. Использование [wt_geotargeting]...[/wt_geotargeting] без условий не имеет смысла: для показа контента обязательно нужны либо условия (city_show, region_show и т.п.), либо атрибут get, либо пара type + default="true" в группе.

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

[wt_geotargeting city_show="Москва"]Контент только для Москвы[/wt_geotargeting]

Показать всем (через default в группе type)

[wt_geotargeting type="phone" default=true]8-800-000-0000[/wt_geotargeting]

С атрибутом get

[wt_geotargeting get="city"]Ваш город[/wt_geotargeting]

Атрибуты

АтрибутОписаниеПримерПо умолчанию
typeТип контента. Объединяет группу условий (например, телефон).type="phone"
city_showСовпадение городаcity_show="Москва"
city_not_showНесовпадение городаcity_not_show="Рязань"
region_showСовпадение региона/областиregion_show="Самарская область"
region_not_showНесовпадение регионаregion_not_show="Московская область"
district_showСовпадение округаdistrict_show="Приволжский федеральный округ"
district_not_showНесовпадение округаdistrict_not_show="Центральный федеральный округ"
country_showСовпадение страны (ISO Alpha-2)country_show="RU"
country_not_showНесовпадение страныcountry_not_show="UA"
defaultЗначение по умолчанию для группы typedefault="true"false
getВывод значения: ip, country, city, region, district, lat, lngget="city"

Особенности country_show / country_not_show

При использовании IpGeoBase указывайте код страны в формате Alpha-2 (RU, UA, KZ). Справочно: классификатор стран.

Примеры

Несколько телефонов для разных городов

[wt_geotargeting type="phone" city_show="Рязань"]8(4912) 37-13-82[/wt_geotargeting]
[wt_geotargeting type="phone" city_show="Москва"]8(499) 503-53-26[/wt_geotargeting]
[wt_geotargeting type="phone" default=true]8-800-496-0000[/wt_geotargeting]

Мобильные телефоны по региону

[wt_geotargeting type="phone_mobile" region_show="Самарская область"]8-927-867-6525[/wt_geotargeting]
[wt_geotargeting type="phone_mobile" region_show="Московская область"]8-936-689-8579[/wt_geotargeting]

Один из нескольких заголовков по городу

Выводится один из четырёх заголовков в зависимости от города посетителя; при отсутствии совпадений — общий приветственный текст:

[wt_geotargeting type="title" city_show="Волгоград"]Приветствуем жителей Волгограда![/wt_geotargeting]
[wt_geotargeting type="title" city_show="Казань"]Приветствуем жителей Казани![/wt_geotargeting]
[wt_geotargeting type="title" city_show="Москва"]Приветствуем жителей Москвы![/wt_geotargeting]
[wt_geotargeting type="title" default=true]Приветствуем посетителей нашего сайта![/wt_geotargeting]

Использование в PHP (шаблон темы)

Шорткоды можно размещать в исходном коде шаблона WordPress внутри do_shortcode():

<?php
echo do_shortcode('[wt_geotargeting type="title" city_show="Москва"]Приветствуем жителей Москвы![/wt_geotargeting]');
?>

Вывод данных о регионе посетителя

IP: [wt_geotargeting get="ip"]
Страна: [wt_geotargeting get="country"]
Город: [wt_geotargeting get="city"]
Регион: [wt_geotargeting get="region"]
Округ: [wt_geotargeting get="district"]
Широта: [wt_geotargeting get="lat"]
Долгота: [wt_geotargeting get="lng"]

Использование в виджетах

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

[wt_geotargeting type="phone_header" city_show="Москва"]8(499)...[/wt_geotargeting]
[wt_geotargeting type="phone_widget" city_show="Москва"]8(499)...[/wt_geotargeting]
[wt_geotargeting type="phone_footer" city_show="Москва"]8(499)...[/wt_geotargeting]

Рекомендации

  • Для простых условий по IP — шорткод wt_geotargeting удобен.
  • Для Pro с регионами сайта — используйте wt_location и WT::$location (PHP-функции).
MAX