Установка и настройка плагина belingoGeo

Плагин выбора городов belingoGeo можно установить через стандартный функционал wordpress, с помощью «Загрузить плагин», выберите архив плагина и нажмите «Установить», потом «Активировать».

После этого, в месте, где Вы хотите вывести ссылку с текущим городом, например в шапке, размещаем «Ваш город: <?php echo do_shortcode('[belingogeo_select_city]')?>”, данный шорткод отобразит ссылку с текущим городом, при клике откроется всплывающее окно со списком городов, так же шорткод инициирует определение города по различным параметрам.

 Всплывающее окно с городами в плагине belingoGeoПодтверждение найденного города belingoGeo

Описание всех настроек плагина BelingoGeo

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

Список городов в плагине belingoGeoРедактирование города в плагине belingoGeo

Шорткоды можно использовать в тексте страниц, записей, товаров. В title и meta тегах, в opengraph разметке. В шаблонах, с помощью функции do_shortcode().

Как сортировать города в плагине belingoGeo?

 

Список шорткодов:

[belingogeo_select_city] – основной шорткод для внедрения плагина во фронтенд сайта. Выводит текущий выбранный город, в виде ссылки. При клике появляется окошко выбора города. Так же, в шорткоде есть всплывающее окошко, которое подтверждает город. Есть дополнительный параметр «show», нужен для отображения шорткода на различных устройствах.

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

[belingogeo_select_city show="mobile"] — отобразит шорткод только в моб. версии.

[belingogeo_select_city show="desktop"] — отобразит шорткод только в десктоп версии.

 

[belingogeo_city_field] – универсальный шорткод, с помощью него можно вывести любую мету города, например можно с помощью плагина ACF добавить дополнительное поле и вывести его в шаблоне. Использование: [belingogeo_city_field field="название поля"]

Предустановленные названия полей:

city_name — Выведет название города (Москва)

city_slug — Выведет ярлык города (moskva)

city_padej1 — Название текущего выбранного города в предложном падеже, берётся из соответствующего поля.

city_padej2 — Название текущего выбранного города в дательном падеже, берётся из соответствующего поля

city_padej3 — Название текущего выбранного города в родительном падеже, берётся из соответствующего поля

city_phone — Телефон текущего выбранного города, берётся из соответствующего поля

city_address — Адрес текущего выбранного города, берётся из соответствующего поля

Как создать дополнительное поле для города в плагине belingoGeo?

 

[belingogeo_city_content] – это контентный шорткод, позволяющий в зависимости от указанного города вывести любое произвольное содержимое. Использование: [belingogeo_city_content city="moskva"]Контент для города Москва[/belingogeo_city_content], если Вы хотите вывести текст, который должен отобразиться без выбранного города, можно указать так: [belingogeo_city_content]Контент по умолчанию[/belingogeo_city_content]

 

Устаревшие шорткоды:

Эти шорткоды считаются устаревшими, пока ещё они работают, но в будущем будут удалены, не рекомендуются к применению.

[select_city] – основной шорткод для внедрения плагина во фронтенд сайта. Выводит текущий выбранный город, в виде ссылки. При клике появляется окошко выбора города. Так же, в шорткоде есть всплывающее окошко, которое подтверждает город.

[city] – вывод название текущего выбранного города в именительном падеже (Москва). В случае, если по каким-то причинам выбранный или запрошенный город не найден в базе, выведет пустое значение.

[widget_city] – вывод название текущего выбранного города в именительном падеже (Москва). В отличие от [city], если город не найден в базе, выведет город по умолчанию.

[city_padej1] – название текущего выбранного города в предложном падеже, берётся из соответствующего поля в панели администратора.

[city_padej2] – название текущего выбранного города в дательном падеже, берётся из соответствующего поля в панели администратора.

[city_padej3] – название текущего выбранного города в родительном падеже, берётся из соответствующего поля в панели администратора.

[city_phone] – телефон текущего выбранного города, берётся из соответствующего поля в панели администратора. Можно например вставить в шапку и телефон будет меняться, при изменении города.

[city_address] – адрес текущего выбранного города, берётся из соответствующего поля в панели администратора. Аналогично телефону можно например вставить в контактах и он будет меняться в зависимости от выбранного города.

[city_field] – универсальный шорткод, с помощью него можно вывести любую мету города, например можно с помощью плагина ACF добавить дополнительное поле и вывести его в шаблоне. Использование: [city_field field=”название поля”]

[city_content] – это контентный шорткод, позволяющий в зависимости от указанного города вывести любое произвольное содержимое. Использование: [city_content city=”moskva”]Контент для города Москва[/city_content].

[cities_addon_contacts] — шорткод, выводит данные из блока «Дополнительные точки», html и стилистику вывода Вы можете редактировать скопировав файл templates /cities_addon_contacts.php  в belingoGeo, в папке с Вашей темой.

 

Кастомизация внешнего вида:

Скопируйте папку templates, в папку с Вашей темой, переименуйте папку в belingogeo

Теперь, весь внешний вид всех всплывающих окошек выбора города и виджетов, можно настраивать в Вашей теме, в папке belingogeo

Возможно, Вам будет интересно