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 results using templates. You can easily override the default templates from your theme to make the results look the way you want them to look.
Works best with Relevanssi
Relevanssi Live Ajax Search only provides you with live search results. To get really good results, use Relevanssi, Relevanssi Premium or Relevanssi Light. Relevanssi Live Ajax Search automatically uses Relevanssi to power the search results 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 issues at
https://github.com/msaari/relevanssi-live-ajax-search.
Installation
- Install the plugin from the WordPress plugin screen.
- Activate the plugin.
- 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 results template
-
Relevanssi Live Ajax Search uses a template loader, making it easy to replace the search results. There is a
templatesfolder in the plugin folder, which includessearch-results.php. This file is the template used to output search results. To customize the search results:- Create a folder called
relevanssi-live-ajax-searchin your theme directory. - Copy the
search-results.phpfile into the new folder. - Relevanssi Live Ajax Search will now use that file to show the results.
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 result position.
wp_dequeue_style( 'relevanssi-live-search' );This removes the actual search result styles.
- Create a folder called
-
I’m using Astra, Storefront, or Divi, and this plugin doesn’t work
-
It does, Astra search form is just designed in a way that hides the search results. 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 results 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 results. You can adjust the number as you wish.
-
I’m using WPML and get no results!
-
For some reason, the combination of Relevanssi Live Ajax Search, Relevanssi and WPML leads to problems. To solve this problem, use the
WP_Querymode of fetching the results. 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 results. This method is compatible with WPML. This method uses the
search-results-query.phptemplate instead of the defaultsearch-results.phptemplate in Relevanssi Live Ajax Search, so take note if you want to customize the template to use the right base template for your customization.
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 13 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
2.6
- Security update: This plugin could be used for blind oracle attacks to find out information on private posts. This has been blocked.
- New feature: Post type, post ID and term ID are now added to the results template as data attributes for better CSS targeting. Contributor: Marco Almeida.
- New feature: New filter hook
relevanssi_live_search_result_arrowfilters the»arrow in the search results. Contributor: Marco Almeida. - New feature: Action hooks
relevanssi_live_search_before_result,relevanssi_live_search_before_result_link,relevanssi_live_search_before_result_title,relevanssi_live_search_after_result_title,relevanssi_live_search_after_result_link,relevanssi_live_search_after_resultallow you to inject content to the search results without modifying the template. Contributor: Marco Almeida.
