Relevanssi Live Ajax Search

Description

Relevanssi Live Ajax Search enables ajax live search for your search forms. It won’t swamp you with settings, and generally, Relevanssi Live Ajax Search works without any modifications necessary. If you want to customize it, you have complete control over how it works and what it does.

Relevanssi Live Ajax Search displays the search re’sults using templates. You can easily override the default templates from your theme to make the re’sults look the way you want them to look.

Works best with Relevanssi

Relevanssi Live Ajax Search only provides you with live search re’sults. To get really good re’sults, use Relevanssi, Relevanssi Premium or Relevanssi Light. Relevanssi Live Ajax Search automatically uses Relevanssi to power the search re’sults if Relevanssi is installed and active. However, you don’t need Relevanssi; Relevanssi Live Ajax Search also works with the default WP search.

Changes from SearchWP Live Ajax Search

Relevanssi Live Ajax Search is a fork of SearchWP Live Ajax Search. I forked it from version 1.6.1 because it looked like SearchWP Live Ajax Search wasn’t getting updates anymore. I also wanted to improve the Relevanssi compatibility.

Relevanssi Live Ajax Search drops all SearchWP compatibility. You can use SearchWP Live Ajax Search, which has built-in SearchWP ’support.

The widget has also been removed. It was unnecessary and outdated.

Relevanssi Live Ajax Search can now take over the Gutenberg core/search search form.

This plugin is on GitHub

Feel free to open up is’sues at
https://github.com/msaari/relevanssi-live-ajax-search.

Installation

  1. Install the plugin from the WordPress plugin screen.
  2. Activate the plugin.
  3. That’s it! Most of the time, that’s all you need.

If Relevanssi Live Ajax Search does not automatically attach itself to your search form, you can enable it by adding a single HTML5 data attribute (data-rlvlive="true") to the input field of your search form. You can find more information in the plugin documentation.

FAQ

How do I create a custom search re’sults template

Relevanssi Live Ajax Search uses a template loader, making it easy to replace the search re’sults. There is a templates folder in the plugin folder, which includes search-results.php. This file is the template used to output search re’sults. To customize the search re’sults:

  1. Create a folder called relevanssi-live-ajax-search in your theme directory.
  2. Copy the search-results.php file into the new folder.
  3. Relevanssi Live Ajax Search will now use that file to show the re’sults.

If you want to override the default CSS styles, you can remove them this way:

add_filter( 'relevanssi_live_search_base_styles', '__return_false' );

This filter hook removes the base styles that control the live search re’sult position.

wp_dequeue_style( 'relevanssi-live-search' );

This removes the actual search re’sult styles.

I’m using Astra and this plugin doesn’t work

It does, Astra search form is just designed in a way that hides the search re’sults. You can find solutions in the plugin documentation. The easiest solution is adding this to your theme functions.php:

add_filter( 'relevanssi_live_search_add_result_div', '__return_false' );

I want to change the number of re’sults shown

There’s a filter for that! Add this to your theme functions.php or in a code snippet:

add_filter( 'relevanssi_live_search_posts_per_page', function() { return 10; } );

This will show 10 re’sults. You can adjust the number as you wish.

I’m using WPML and get no re’sults!

For some reason, the combination of Relevanssi Live Ajax Search, Relevanssi and WPML leads to problems. To solve this problem, use the WP_Query mode of fetching the re’sults. To activate the mode, add this to your theme functions.php:

add_filter( 'relevanssi_live_search_mode', function() { return 'wp_query'; } );

This will make Relevanssi Live Ajax Search use a different method of fetching the re’sults. This method is compatible with WPML. This method uses the search-results-query.php template instead of the default search-results.php template in Relevanssi Live Ajax Search, so take note if you want to customize the template to use the right base template for your customization.

I’m using Storefront and this plugin doesn’t work

Storefront also hides the search re’sults for some reason. Use this:

add_filter( 'relevanssi_live_search_add_result_div', '__return_false' );

Reviews

Març 3, 2022
I've just installed it on my site compare.parts added the small snippet of code to the search input and it works. The autocomplete/typeahead is the same width as the input box and it just works well. I wish more plugins were made as well as Relevanssi and simple to setup. Great job.
Zenâr 27, 2022
Thanks! This is a very welcome addition to the Relevanssi family of plugins!
Read all 5 reviews

Contributors & Developers

“Relevanssi Live Ajax Search” is open source software. The following people have contributed to this plugin.

Contributors

“Relevanssi Live Ajax Search” has been translated into 8 locales. Thank you to the translators for their contributions.

Translate “Relevanssi Live Ajax Search” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.2.2

  • Fixes the relevanssi_live_search_base_styles filter hook, which was in reverse: now it works as expected and disables styles when you give it false.

1.2.1

  • Adds automatic hijack for WooCommerce product search form.

1.2.0

  • The way this plugin uses query_posts() can lead to problems (for example with WPML). It is now possible to use a new WP_Query instead, which is safer.
  • New filter hook relevanssi_live_search_mode controls which mode is used: query_posts (the default value) is the old way, any other value uses WP_Query.
  • There’s a new template file search-results-query.php. This template is used for the WP_Query method.

1.1.0

  • Improved accessibility: screen reader users get better notifications of what’s happening.
  • Improved accessibility: the default location for the search re’sults is now the next tab stop from the search form, within div#rlvlive_1.
  • Removes JQuery migration deprecation warnings.
  • The search re’sults now show the total number of re’sults found. These changes are in the default template, so if you’re using a custom template, check the default template.
  • New filter hook relevanssi_live_search_status_location controls where the total is displayed (‘before’, ‘after’ or nowhere for any other value, in which case only the screen reader status is added).
  • New filter hook relevanssi_live_search_add_result_div controls whether an extra div is added for the re’sults.
  • If Relevanssi is available, searches that find no re’sults show ‘Did you mean’ ’suggestions.

1.0.0

  • First version based on the version 1.6.1 of SearchWP Live Ajax Search.