SearchWP Live Ajax Search

Опис

Не потребує SearchWP, але буде використовувати його, якщо він доступний. Повна документація доступна на сайті searchwp.com.

SearchWP Live Ajax Search додає живий пошук на основі AJAX до вже наявних пошукових форм. Створений як найкращий друг розробника, SearchWP Live Ajax Search має на меті не заважати вам, але й водночас дозволяє проводити гнучкі налаштування. Плагін готовий до роботи з будь-якою темою WordPress і використовує власний шаблон для відображення результатів пошуку. Підхід, заснований на шаблонах, дозволяє легко налаштувати реалізацію SearchWP Live Search, не вдаючись до десятка незрозумілих параметрів.

Краще працює в парі з SearchWP (але це не обов’язково)

SearchWP Live Ajax Search найкраще використовувати в парі з SearchWP, але це не обов’язково. Якщо SearchWP встановлено і активовано, SearchWP Live Ajax Search можна налаштувати під будь-яке пошукове ядро для кожної форми.

Персоналізація

Ви можете виконати інтеграцію SearchWP Live Ajax Search на досить високому рівні, включаючи будь-яку кількість розробницьких налаштувань. За генерацію результатів пошуку відповідає окремий шаблон, що дозволяє персоналізувати SearchWP Live Ajax Search як будь-яку іншу тему WordPress.

Все працює за рахунок HTML5 дата-атрибутів (data-swplive="true") які додаються до поля вводу вашої форми пошуку. Це відбувається автоматично з коробки до будь-якої форму пошуку створеної через get_search_form().

Підтримка віджетів

SearchWP Live Ajax Search постачається з віджетами дозволяючи власнику сайта встановлювати форми пошуку де він захоче.

Скріншоти

  • SearchWP Live Ajax Search Results dropdown
  • SearchWP Live Ajax Search Settings page
  • SearchWP Live Ajax Search Forms settings page
  • SearchWP Live Ajax Search Forms embed options

Блоки

Цей плагін надає 1 блок.

  • Search Form The best WordPress search you can find.

Встановлення

  1. Завантажте плагін та розархівуйте файли
  2. Додайте searchwp-live-search до папки ~/wp-content/plugins/ на сервері
  3. Активуйте плагін через меню «Плагіни» у WordPress.
  4. За бажанням налаштуйте конфігурацію: повна документація
  5. За бажанням налаштуйте шаблон результатів: повна документація

Часті питання

Документація?

Звичайно! Повна документація

Як додати живий пошук до вже існуючої форми?

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. Якщо ви бажаєте застосувати пошукову систему, створену SearchWP, просто додайте наступний атрибут до поля вводу своєї форми: 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 — який дозволяє повністю змінювати конфігурацію. Легко додавайте нові ключі до масиву який проходить через цей фільтр, змінюючи стандартні значення на ті що треба вам.

Відгуки

18.12.2023 1 reply
Great job to the developer! This is amazing. The customization options have been thought through incredibly well.
16.05.2023
data-swpengine attribute was exactly what I was looking for, I've should come here much earlier 🙂
25.03.2022
This is the exact plugin I need in every way. The user experience is perfect. I love the customization. And it pretty much just works out of the box. The problem (and this is a big one) is that the ajax call busts the cache, so every time you type in a query it hits the database (even if it's the same query you made a second ago). I've tried everything I can think of to subvert this, including more time than I care to admit messing with wordpress core caching rules and tinkering with the default ajax configuration in wordpress. I can see why some people would want to bust the cache every time, but this should be configurable for those of us who are willing to accept a little stale content in return for blazing performance. I'm kinda on the fence over whether autocomplete search is even necessary when the lag is 2-3 seconds.
Прочитати всі 32 відгуки

Учасники та розробники

“SearchWP Live Ajax Search” — проект з відкритим вихідним кодом. В розвиток плагіну внесли свій вклад наступні учасники:

Учасники

“SearchWP Live Ajax Search” було перекладено на 5 локалізацій. Дякуємо перекладачам за їх роботу.

Перекладіть “SearchWP Live Ajax Search” на вашу мову.

Цікавитесь розробкою?

Перегляньте код, перегляньте сховище SVN або підпишіться на журнал розробки за допомогою RSS.

Журнал змін

1.8.2

  • Fixes integration with Relevanssi Premium.

1.8.1

  • Fixes incorrect results when using a Live Search custom template in some cases.

1.8.0

  • Adds Search Forms.
  • Adds support for SearchWP custom search sources.
  • Improves existing and adds new customizations to the Live Ajax Search settings page.
  • Updates translation files.
  • Fixes Settings link location in the plugins list when SearchWP is activated.

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 помилки представлені в 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

  • Fixes an issue with quoted phrase support
  • Fixes an issue with post types that are excluded from search when registered (applies only to searches with SearchWP)

1.4.4

  • Fixes an issue with bundle.js in some cases

1.4.3

  • Improves SearchWP compatibility by suppressing filters when SearchWP performs the search
  • Compatibility fix with SearchWP Modal Search Form

1.4.2

  • Fixes an issue (JavaScript error) when a custom configuration disables the spinner

1.4.1

  • Fixes an issue that may have prevented spinner customizations from being applied correctly

1.4

  • Removes post type from default results template
  • Fixes an issue with HTML entities in search string
  • Updates translation source and translations
  • Updates bundler build process
  • Updates a11y where applicable
  • Automatically cancels pending searches when search input is changed

1.3.1

  • Fixes typo in results template function call

1.3.0

  • Many a11y improvements (props @geoffreycrofte)
  • Adds message when minimum characters have not been reached
  • Added German translation (props @stefan-meier)
  • Added Polish translation (props @boguslawski-piotr)
  • Added Dutch translation (props Stefan G.)
  • Updated translation source

1.2.0

  • Reworked build process to be more straightforward
  • Support script debugging (props mgratch)
  • Remove form action requirement to better integrate with other code (props mgratch)
  • Fixed an issue that prevented search from firing when re-entered too fast (props pierrestoffe)

1.1.8

  • Added configuration option to prevent AJAX cancellation when Enter key is pressed
  • Added some actions to make customization easier
  • Added filter to customize location of results template

1.1.7

  • Fixed an issue with missing engine name

1.1.6

  • Fixed an issue that prevented multiple live search instances on a single page from using different engines

1.1.5

  • Fixed an issue where results_destroy_on_blur was not properly applied if a custom configuration was used but that property was not defined in the custom configuration

1.1.4

  • Added a number of JavaScript events to facilitate further extension/integration

1.1.3

  • Fixed an issue with the build process which introduced an outdated version of the plugin JavaScript assets

1.1.2

  • No longer limit results to built in post types
  • Added results_destroy_on_blur config option to prevent automatic removal of results window when clicking outside results pane

1.1.1

  • Fixed an issue that prevented SearchWP Supplemental engines from showing up in the Widget config
  • Added French translation
  • Added Serbian translation

1.1

  • Define default post statuses when using WordPress native search
  • New filter searchwp_live_search_query_args to manipulate query args before searches
  • Fixed an offset when positioning results on top of the search field

1.0.6

  • PHP Warning cleanup

1.0.5

  • New action: searchwp_live_search_alter_results
  • Adds Relevanssi support (based on Dave’s WordPress Live Search’s implementation)

1.0.4

  • Corrected the default results template folder name to be searchwp-live-ajax-search as is in the documentation
  • Improvement: hide the results box when query is emptied (props Lennard Voogdt)
  • Fixed an issue with Media not showing in results when integrated with SearchWP

1.0.3

  • Fixed an issue where a false set of no results would be returned (props Lennard Voogdt)

1.0.2

  • Resolved an issue where hitting Enter/Return prevented the search query from being passed to the results page
  • Fixed potential false positive for DOING_AJAX (props justinsainton)
  • Removed unnecessary call to get_the_ID() in the default results template (props justinsainton)
  • Added escaping to permalink and post type name in the default results template (props justinsainton)
  • Utilize a WordPress core translated string instead of a custom one (props justinsainton)
  • Increase the priority for the get_search_form filter so as to accommodate existing filters

1.0.2

  • Added Serbo-Croatian translation (props Andrijana Nikolic)

1.0.1

  • Fixed a directory URL issue
  • Fixed an indexOf JavaScript error

1.0

  • Initial release!