Описание
SearchWP не требуется, но будет использоваться, если уже установлен. Полная документация доступна на сайте searchwp.com.
SearchWP Live Ajax Search позволяет использовать в формах поиска живой AJAX-поиск. Плагин SearchWP Live Ajax Search был придуман в помощь разработчикам, а потому стремится не мешать вам в работе, но при этом его можно настраивать по своему вкусу. Плагин может работать с любой темой WordPress и использует загрузчик шаблонов для отображения результатов. Благодаря шаблонному подходу вы можете бесшовно настраивать реализацию поиска без необходимости разбираться с множеством запутанных опций.
Лучше всего работает с SearchWP (но наличие SearchWP не обязательно)
SearchWP Live Ajax Search лучше всего использовать в сочетании с SearchWP, но это не обязательно. Если SearchWP установлен и активирован, SearchWP Live Ajax Search можно настроить для использования любого из ваших поисковых движков для каждой формы поиска.
Настройка
Вы можете гибко настроить реализацию SearchWP Live Ajax Search, включая любое количество конфигураций, определяемых разработчиком. Результаты отображаются с помощью загрузчика шаблонов, что позволяет SearchWP Live Ajax Search не мешать рабочему процессу, предоставляя возможность писать шаблон вывода результатов так же, как и любой другой файл темы WordPress.
Все это осуществляется добавлением одного HTML атрибута данных (data-swplive="true"
) в поле ввода вашей формы поиска. Это происходит автоматически для всех форм поиска, созданных с помощью get_search_form()
.
Поддержка виджетов
SearchWP Live Ajax Search поставляется с виджетом, позволяющим вставлять формы живого поиска в любое место.
Скриншоты
Блоки
Этот плагин предоставляет 1 блок.
- Search Form The best WordPress search you can find.
Установка
- Загрузите плагин и извлеките файлы
- Загрузите
searchwp-live-search
в каталог~/wp-content/plugins/
- Активируйте плагин в меню «Плагины» в WordPress
- При желании можно настроить конфигурацию: полная документация
- При желании можно настроить шаблон результатов: полная документация
Часто задаваемые вопросы
-
Есть ли документация?
-
Конечно! Вот вся документация
-
Как добавить живой поиск в форму поиска?
-
SearchWP Live Ajax Search автоматически включается для всех форм поиска, созданных с помощью
get_search_form()
. Этого можно избежать с помощью следующего фильтра:add_filter( 'searchwp_live_search_hijack_get_search_form', '__return_false' );
Если вы хотите вручную включить SearchWP Live Ajax Search в произвольной форме поиска, просто добавьте следующий атрибут данных в тег
input
который вы хотите подключить:data-swplive="true"
-
Как генерируются результаты поиска?
-
По умолчанию SearchWP Live Ajax Search использует стандартный поисковый движок SearchWP, если он у вас установлен. Если SearchWP отсутствует, будут использованы стандартные результаты поиска WordPress. Если вы хотите настроить, какой поисковый движок использовать, просто добавьте следующий атрибут в тег
input
формы:data-swpengine="supplemental"
, заменив ‘supplemental’ имя нужного поискового движка. -
Как настроить шаблон результатов
-
SearchWP Live Ajax Search использует загрузчик шаблонов. В папке плагина вы найдете папку
templates
, которая содержит файлsearch-results.php
. Этот файл используется по умолчанию для вывода результатов поиска. Для настройки вывода результатов поиска просто создайте папку с именемsearchwp-live-ajax-search
в каталоге вашей темы и скопируйте в нее файлsearch-results.php
. После этого SearchWP Live Ajax Search будет использовать этот файл вместо того, который поставляется с плагином, и вы сможете настраивать его так же, как и другие файлы шаблонов темы.SearchWP Live Ajax Search также выводит два набора стилей. Основной набор стилей отвечает за правильное позиционирование контейнера с результатами поиска. Второй набор стилей управляет визуальным оформлением. Это разделение было сделано для того, чтобы обеспечить максимальную простоту настройки. Вы можете отключить стандартную «тему», удалив из очереди соответствующую таблицу стилей. Также есть возможность отключить базовые стили CSS. Более подробная информация доступна в документации.
-
Как настроить спиннер?
-
SearchWP Live Ajax Search использует фильтр —
searchwp_live_search_configs
. Он позволит вам полностью менять используемую конфигурацию. Просто добавьте новый ключ в массив, прошедший через этот фильтр, настроив значенияdefault
на то, что вам нужно.
Отзывы
Участники и разработчики
«SearchWP Live Ajax Search» — проект с открытым исходным кодом. В развитие плагина внесли свой вклад следующие участники:
Участники«SearchWP Live Ajax Search» переведён на 5 языков. Благодарим переводчиков за их работу.
Перевести «SearchWP Live Ajax Search» на ваш язык.
Заинтересованы в разработке?
Посмотрите код, проверьте SVN репозиторий, или подпишитесь на журнал разработки по RSS.
Журнал изменений
1.8.5
- Fixes integration with SearchWP Modal Search Form plugin.
1.8.4
- Adds support for SearchWP multisite search.
- Improves search results dropdown role attribute, for better accessibility.
- Adjust results width to match Gutenberg form width when the search button is inside.
- Fixes the display of the results dropdown within a custom parent element.
1.8.3
- Предотвращает проблемы с плагинами кеширования в некоторых случаях.
- Добавлена поддержка загрузки произвольного шаблона из указанного пользователем пути к каталогу.
1.8.2
- Исправлена интеграция с Relevanssi Premium.
1.8.1
- Исправлены неверные результаты при использовании произвольного шаблона живого поиска, возникавшие в некоторых случаях.
1.8.0
- Добавлены формы поиска.
- Добавлена поддержка произвольных источников поиска SearchWP.
- Улучшены существующие и добавлены новые настраиваемые параметры на страницу настройки поиска Live Ajax.
- Обновлены файлы переводов.
- Исправлено расположение ссылки на пункт «Настройки» в списке плагинов при активации SearchWP.
1.7.6
- Изменен внешний вид страницы настроек и структура меню для бесперебойной работы с текущей версией SearchWP.
1.7.5
- Изменен визуальный стиль страницы настроек админки в соответствии с текущей версией SearchWP.
1.7.4
- Исправлена ошибка, из-за которой кнопка расширенных настроек виджета в некоторых случаях исчезала, не открывая настройки.
- Исправлено переопределение содержимого тела, если в конфигурации задан пользовательский родительский элемент.
1.7.3
- Добавлена встроенная система уведомлений для получения последних обновлений от SearchWP.
1.7.2
- Добавлена совместимость с будущей версией плагина SearchWP Modal Search Form.
- Устранена проблема с устаревшей версией плагина SearchWP.
1.7.1
- Исправлены переводы плагина.
1.7.0
- В админку добавлена новая страница настроек для более легкого управления плагином.
- Введена значительная перестройка кода для повышения производительности.
1.6.3
- Улучшена очистка аргумента поля поиска ‘swpengine’.
- Стандартизированы ограничения прямого доступа в классах по всему плагину.
1.6.2
- Ограничены аргументы, передаваемые в запрос при использовании стандартного поиска WordPress.
1.6.1
- Исправления PHP Notice, представленные в версии 1.6.0
1.6.0
- Добавлена поддержка блока формы поиска в редакторе блоков (Gutenberg)
1.5.0
- Добавлена поддержка переменных запроса post_status, post_type и posts_per_page при отсутствии использования SearchWP
- Обновлен источник переводов, обновлены переводы с фиксированным текстовым доменом
- Реорганизован процесс сборки
- Обновлены зависимости пакетов
1.4.6
- Добавлена совместимость с SearchWP 4
1.4.5
- Исправлена проблема с поддержкой цитируемых фраз
- Устранена проблема с типами записей, которые исключаются из поиска при регистрации (применимо только к поискам с SearchWP)
1.4.4
- Исправлена проблема с bundle.js, возникавшая в некоторых случаях
1.4.3
- Улучшена совместимость SearchWP за счет подавления фильтров, когда SearchWP выполняет поиск
- Исправлена проблема совместимости с SearchWP Modal Search Form
1.4.2
- Исправлена ошибка (ошибка JavaScript), возникавшая при отключении спиннера в произвольной конфигурации
1.4.1
- Исправлена ошибка, из-за которой настройки спиннера могли применяться некорректно
1.4
- Удален тип записи из шаблона результатов по умолчанию
- Исправлена проблема с HTML-сущностями в строке поиска
- Обновлены источник перевода и переводы
- Обновлен процесс сборки упаковщика
- Обновления доступности (a11y), где это применимо
- Автоматически отменяются отложенные поиски при изменении поискового ввода
1.3.1
- Исправлена опечатка в вызове функции шаблона результатов
1.3.0
- Множество улучшений доступности (a11y) (благодарим @geoffreycrofte)
- Добавлено сообщение о том, что не достигнуто минимальное количество символов
- Добавлен перевод на немецкий язык (благодарим @stefan-meier)
- Добавлен перевод на польский язык (благодарим @boguslawski-piotr)
- Добавлен перевод на голландский язык (благодарим Stefan G.)
- Обновлен источник перевода
1.2.0
- Переработан и стал более простым процесс сборки
- Добавлена поддержка отладки скриптов (благодарим mgratch)
- Убрано требование к действию формы для лучшей интеграции с другим кодом (благодарим mgratch)
- Исправлена ошибка, из-за которой поиск не срабатывал при слишком быстром повторном вводе (благодарим pierrestoffe)
1.1.8
- Добавлен параметр конфигурации для предотвращения отмены AJAX при нажатии клавиши Enter
- Добавлены некоторые действия для упрощения настройки
- Добавлен фильтр для настройки расположения шаблона результатов
1.1.7
- Исправлена проблема с отсутствующим названием движка
1.1.6
- Исправлена проблема, из-за которой несколько экземпляров живого поиска на одной странице не могли использовать разные поисковые движки
1.1.5
- Исправлена проблема, при которой
results_destroy_on_blur
не применялся должным образом, если использовалась произвольная конфигурация, но это свойство не было в ней определено
1.1.4
- Добавлен ряд событий JavaScript для упрощения дальнейшего расширения/интеграции
1.1.3
- Исправлена ошибка в процессе сборки, из-за которой использовалась устаревшая версия ресурсов JavaScript плагина
1.1.2
- Результаты больше не ограничиваются встроенными типами записей
- Добавлен параметр конфигурации
results_destroy_on_blur
для предотвращения автоматического удаления окна результатов при щелчке за пределами панели результатов
1.1.1
- Исправлена ошибка, из-за которой дополнительные поисковые движки SearchWP не отображались в конфигурации виджета
- Добавлен перевод на французский язык
- Добавлен перевод на сербский язык
1.1
- Определение статусов записи по умолчанию при использовании собственного поиска WordPress
- Новый фильтр
searchwp_live_search_query_args
для управления аргументами запроса перед поиском - Исправлено смещение при размещении результатов поверх поля поиска
1.0.6
- Очистка предупреждений PHP
1.0.5
- Новое действие:
searchwp_live_search_alter_results
- Добавлена поддержка Relevanssi (на основе реализации WordPress Live Search благодаря Dave)
1.0.4
- Исправлено имя папки шаблона результатов по умолчанию на
searchwp-live-ajax-search
, как указано в документации - Улучшение: скрытие блока результатов при очищении запроса (благодарим Lennard Voogdt)
- Исправлена ошибка, из-за которой медиафайлы не отображались в результатах при интеграции с SearchWP
1.0.3
- Исправлена проблема, из-за которой возвращался ложный набор отсутствующих результатов (благодарим Lennard Voogdt)
1.0.2
- Решена проблема, из-за которой нажатие Enter/Return не позволяло передать поисковый запрос на страницу результатов
- Исправлен потенциальный ложноположительный результат для DOING_AJAX (благодарим justinsainton)
- Удален ненужный вызов get_the_ID() в шаблоне результатов по умолчанию (благодарим justinsainton)
- Добавлено экранирование для постоянной ссылки и названия типа записи в шаблоне результатов по умолчанию (благодарим justinsainton)
- Используется переведенная строка ядра WordPress вместо пользовательской (благодарим justinsainton)
- Увеличена приоритетность фильтра get_search_form для совместимости с существующими фильтрами
1.0.2
- Добавлен перевод на сербскохорватский язык (благодарим Andrijana Nikolic)
1.0.1
- Исправлена проблема с URL каталога
- Исправлена ошибка JavaScript indexOf
1.0
- Исходная версия!