Relevanssi replaces the default search with a partial-match search that sorts results by relevance. It also indexes comments and shortcode content.
|Author:||Mikko Saari (profile at wordpress.org)|
|WordPress version required:||4.8.3|
|WordPress version tested:||5.2.2|
|Added to WordPress repository:||30-06-2009|
|Total downloads:||2 657 542|
|Active installs:||100 000+|
Click to start download
Relevanssi replaces the standard WordPress search with a better search engine, with lots of features and configurable options. You’ll get better results, better presentation of results – your users will thank you.
This is the free version of Relevanssi. There’s also Relevanssi Premium, which has added features. For more information about Premium, see Relevanssi.com.
Do note that using Relevanssi may require large amounts (hundreds of megabytes) of database space (for a reasonable estimate, multiply the size of your
wp_posts database table by three). If your hosting setup has a limited amount of space for database tables, using Relevanssi may cause problems. In those cases use of Relevanssi cannot be recommended.
- Search results sorted in the order of relevance, not by date.
- Fuzzy matching: match partial words, if complete words don’t match.
- Find documents matching either just one search term (OR query) or require all words to appear (AND query).
- Search for phrases with quotes, for example “search phrase”.
- Create custom excerpts that show where the hit was made, with the search terms highlighted.
- Highlight search terms in the documents when user clicks through search results.
- Search comments, tags, categories and custom fields.
- Multisite friendly.
- bbPress support.
- Adjust the weighting for titles, tags and comments.
- Log queries, show most popular queries and recent queries with no hits.
- Restrict searches to categories and tags using a hidden variable or plugin settings.
- Index custom post types and custom taxonomies.
- Index the contents of shortcodes.
- Google-style “Did you mean?” suggestions based on successful user searches.
- Support for WPML multi-language plugin and Polylang.
- Support for s2member membership plugin, Members, Groups and Simple Membership.
- Advanced filtering to help hacking the search results the way you want.
- Search result throttling to improve performance on large databases.
- Disable indexing of post content and post titles with a simple filter hook.
Premium features (only in Relevanssi Premium)
- Indexing attachment content (PDF, Office, Open Office).
- Improved spelling correction in “Did you mean?” suggestions.
- Searching across multiple sites in the same multisite installation.
- Search and index user profiles.
- Search and index taxonomy term pages (categories, tags, custom taxonomies).
- Search and index arbitrary columns in wp_posts MySQL table.
- Assign weights to any post types and taxonomies.
- Assign extra weight to new posts.
- Let the user choose between AND and OR searches, use + and – operator (AND and NOT).
- Export and import settings.
- WP CLI commands.
- Related posts.
Relevanssi in Facebook
You can find Relevanssi in Facebook.
- Cristian Damm for tag indexing, comment indexing, post/page exclusion and general helpfulness.
- Marcus Dalgren for UTF-8 fixing.
- Warren Tape for 2.5.5 fixes.
- Mohib Ebrahim for relentless bug hunting.
- John Calahan for extensive 4.0 beta testing.
Excerpts and highlights
You can find solutions and answers at the Relevanssi Knowledge Base.
Answers to many common problems can be found from the contextual menu. Just click “Help” in the top right corner of your WordPress admin dashboard on the Relevanssi settings page.
Relevanssi doesn’t work
If you the results don’t change after installing and activating Relevanssi, the most likely reason is that you have a call to
query_posts() on your search results template. This confuses Relevanssi. Try removing the
query_posts() call and see what happens.
Searching for words with ampersands or hyphens doesn’t work
Please read Words with punctuation can’t be found. This is a Relevanssi feature, but you can fix it from Relevanssi indexing settings.
Where are the user search logs?
See the top of the admin menu. There’s ‘User searches’.
Displaying the relevance score
Relevanssi stores the relevance score it uses to sort results in the $post variable. Just add something like
to your search results template inside a PHP code block to display the relevance score.
Did you mean? suggestions
Relevanssi offers Google-style “Did you mean?” suggestions. See “Did you mean” suggestions in the Knowledge Base for more details.
What is tf * idf weighing?
It’s the basic weighing scheme used in information retrieval. Tf stands for term frequency while idf is inverted document frequency. Term frequency is simply the number of times the term appears in a document, while document frequency is the number of documents in the database where the term appears.
Thus, the weight of the word for a document increases the more often it appears in the document and the less often it appears in other documents.
What are stop words?
Each document database is full of useless words. All the little words that appear in just about every document are completely useless for information retrieval purposes. Basically, their inverted document frequency is really low, so they never have much power in matching. Also, removing those words helps to make the index smaller and searching faster.
- Remove notice about undefined index.
- Adding a missing file.
- New feature: Multi-phrase searches now respect AND and OR operators. If multiple phrases are included in an OR search, any posts with at least one phrase will be included. In AND search, all phrases must be included.
- New feature: Admin search has been improved: there’s a post type dropdown and the search is triggered when you press enter. The debug information has a
divtag around it with the id
debugging, so you can hide them with CSS if you want to. The numbering of results also makes more sense.
- New feature: The date parameters (
m) are now supported.
- New feature: New filter hook
relevanssi_indexing_limitfilters the default number of posts to index (10). If you have issues with indexing timing out, you can try adjusting this to a smaller number like 5 or 1.
- New feature: Support for Paid Membership Pro added.
- New feature: WordPress SEO support, posts marked “noindex” in WordPress SEO are no longer indexed by Relevanssi by default.
- Removed feature: qTranslate is no longer supported.
- Major fix: Tax query searching had some bugs in it, manifesting especially into Polylang not limiting the languages correctly. Some problems with the test suites were found and fixed, and similar problems won’t happen again.
- Minor fix: Admin search only shows editing options to users with enough capabilities to use them.
- Minor fix: Phrase searching now uses filterable post statuses instead of a hard-coded set of post statuses.
- Minor fix: The plugin action links were missing on the Plugins page list, they’re back now.
- Minor fix: Search terms with slashes won’t cause errors anymore.
- Minor fix: Relevanssi admin pages have been examined for accessibility and form labels have been improved in many places.
relevanssi_get_term_taxonomy()function is deprecated and will be removed at some point in the future.
- New feature: The search form shortcode has a new parameter
dropdownwhich can be used to add a category dropdown, like this:
- New feature: Relevanssi can now use the contents of the PDF files indexed with WP File Download.
- New filter:
relevanssi_indexing_tokenscan be used to filter the tokens (individual words) before they are indexed.
- Removed filter:
relevanssi_default_meta_query_relationdid not have any effect anymore.
- Changed behaviour: The default taxonomy relation was set to AND in 4.1.4, but wasn’t properly applied before. Now it is really switched.
- Changed behaviour: New post types have been added to list of forbidden post types Relevanssi won’t show as indexing options (ACF, TablePress and WooCommerce).
- Major fix: Tax query processing has been completely refactored, eliminating all sorts of bugs, especially with various edge cases.
- Major fix: Gutenberg block indexing only worked with the Gutenberg plugin enabled. It now works with WP 5.0 built-in Gutenberg as well. If you use Gutenberg blocks, reindex to get all the block content in the index.
- Major fix: Excerpt-building and highlighting did not respect the “Keyword matching” setting. They do now, and the excerpts should be better now.
- Major fix: AND searches needed queries that could get too long for the database to handle. This has been fixed and optimized.
- Major fix: Taxonomy term subquery relations didn’t work; now they are applied.
- Minor fix: iOS uses curly quotes by default, and that didn’t work as a phrase operator. Now phrase operator works with curly quotes and straight quotes.
- Minor fix: The Did you mean broke with search terms longer than 255 characters.
- Minor fix: Phrases with numbers and one word like “team 17” didn’t work, because numbers weren’t counted as words.