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

Шорткод WT_LOCATION_SEARCH

Шорткод выводит поле ввода для поиска региона (города, области и т.д.). Результаты отображаются в выпадающем списке при вводе минимум двух символов. Поиск через AJAX.

История: с версии 1.11 Pro.

Назначение

  • Поиск региона по названию
  • Интеграция с выбором локации (JavaScript, поддомен, директория)
  • Совместно с шорткодом wt_locations — переменные оформления берутся из [wt_locations]

Синтаксис

[wt_location_search]

или с аргументами:

[wt_location_search input_id="city_search" input_placeholder="Город" show_parent_name="0"]

Аргументы

АргументОписаниеПо умолчанию
input_idID поля вводаsearch_location_name
input_classCSS-класс поля ввода
input_placeholderPlaceholderВведите название города
onclickАтрибут onclick
result_column_classКласс колонки результатов
result_div_idID элемента результатовsearch_location_result
result_div_classКласс элемента результатов
open_functionJS-функция при открытии (модалки)
close_functionJS-функция при закрытии
show_parent_nameПоказывать родительский регион (область, край) после названия в результатах поиска: 1, 0. Пример: «Самара, Самарская область» — помогает различать города с одинаковыми названиями1
filter_parentID родителя, active_parent_id, active_country_id

Результаты поиска

По умолчанию в результатах к названию региона добавляется родительский регион (например, «Самара, Самарская область»). Это управляется атрибутом show_parent_name.

Взаимодействие с [wt_locations]

[wt_location_search] выводит только поле ввода. Оформление списка (тег, тип перехода, URL) задаётся переменными, которые выводит [wt_locations]. Размещайте оба шорткода на одной странице.

Примеры

Базовое использование

[wt_location_search]

Кастомный ID и placeholder

[wt_location_search input_id="city_search" input_placeholder="Введите город"]

Интеграция с модальным окном

[wt_location_search input_id="city_search" open_function="openCityModal" close_function="closeCityModal"]

Скрыть имя родителя

[wt_location_search show_parent_name="0"]

Поиск только среди городов области (ID 123)

[wt_location_search filter_parent="123"]

Поиск среди соседей текущего региона

[wt_location_search filter_parent="active_parent_id"]

Технические детали

  • Обработчик: WtGtShortcode::shortcodeLocationSearch()
  • Файл: modules/WtGtShortcode/WtGtShortcode.php
  • JavaScript: js/wt-location.js
  • AJAX action: search_location
MAX