Шорткод выводит поле ввода для поиска региона (города, области и т.д.). Результаты отображаются в выпадающем списке при вводе минимум двух символов. Поиск через 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_id | ID поля ввода | search_location_name |
input_class | CSS-класс поля ввода | — |
input_placeholder | Placeholder | Введите название города |
onclick | Атрибут onclick | — |
result_column_class | Класс колонки результатов | — |
result_div_id | ID элемента результатов | search_location_result |
result_div_class | Класс элемента результатов | — |
open_function | JS-функция при открытии (модалки) | — |
close_function | JS-функция при закрытии | — |
show_parent_name | Показывать родительский регион (область, край) после названия в результатах поиска: 1, 0. Пример: «Самара, Самарская область» — помогает различать города с одинаковыми названиями | 1 |
filter_parent | ID родителя, 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