Relevanssi – A Better Search

Descrição

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.

Key features

  • 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.

Advanced features

  • 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.

Thanks

  • 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.

Imagens de tela

  • Overview page
  • Indexing settings
  • Searching settings
  • Logging settings
  • Excerpts and highlights
  • Synonym settings
  • Stopword settings

Instalação

  1. Install the plugin from the WordPress plugin screen.
  2. Activate the plugin.
  3. Go to the plugin settings page and build the index following the instructions there.
  4. That’s it!

Relevanssi uses the standard search form and doesn’t usually need any changes in the search results template.

If the search does not bring any results, your theme probably has a query_posts() call in the search results template. That throws Relevanssi off. For more information, see The most important Relevanssi debugging trick.

Uninstalling

To uninstall the plugin remove the plugin using the normal WordPress plugin management tools (from the Plugins page, first Deactivate, then Delete). If you remove the plugin files manually, the database tables and options will remain.

FAQ

Base de conhecimento

You can find solutions and answers at the Relevanssi Knowledge Base.

Contextual help

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

echo $post->relevance_score

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.

Avaliações

Search Box Never found

All of the features seem to work as advertised. However, there is no mention of actually how to do a search. As in where do I type in the search item? And I never found it. Finally gave up.

Great UX => Findability

The way Relevanssi enables findability within a site is the most powerful component you can add to a user's search experience. Synonyms and the ability to look intelligently within custom types and fields (to name a few) just opens up the content in a way that native search does not. This allows us, for example, to easily add words in a custom post field that is reflective of a user's natural language — an important consideration for e-commerce and directory sites. Search is a powerful navigational tool in itself and crafting its construct is part of the "invisible" care and attention that we can put into our products to provide exceptional and relevant experiences (for both our clients, and their customers). Relevanssi helps us control this relevance in balance with a client's business decision to never give a user a dead-end of no results. No results are bad, but irrelevant results can be worse. The unexpected, swift and selfless support form the author, Mikko, was also a life saver on our last project when we needed that extra bit of genius to make the project great with a very specific query.

Excellent plugin

It does all I need and more! Support is great, the knowledge base is also very helpful providing quick solutions for most of my problems. Plugin is lightweight and easy to configure. Tested with large databases, indexing over 10,000 pages with no problem.

Brilliant search plugin with amazing support

I bought this for a client that wanted the ability to search in PDFs. The plugin works well with no configuration. I have needed some specific help with understanding how search works and Mikko has been amazing with his prompt, helpful responses.

Essential for UX

Relevanssi is an absolute must-have if you want to offer a better user experience on your WordPress website, because we all know how important a good search function is (and how bad the standard WordPress search is). I strongly suggest to go for the Premium version that offers PDF search and much more. Support is excellent, even for help with non-standard features. Thanks Mikko!
Leia todas as 229 avaliações

Contribuidores e desenvolvedores

“Relevanssi – A Better Search” é um software com código aberto. As seguintes pessoas contribuíram para este plugin.

Contribuidores

“Relevanssi – A Better Search” foi traduzido para 6 localidades. Obrigado aos tradutores por suas contribuições.

Traduzir “Relevanssi – A Better Search” para o seu idioma.

Interessado no desenvolvimento?

Navegue pelo código, dê uma olhada no repositório SVN ou assine o registro de desenvolvimento via RSS.

Registro de alterações

4.1.4

  • EXISTS and NOT EXISTS didn’t work for taxonomy terms in searches.
  • WPML post type handling has been improved. If post type allows fallback for default language, Relevanssi will support that.
  • Relevanssi now reminds you to set up automatic trimming for the logs. It’s a really good idea, otherwise the logs will become bloated, which will hurt search performance.
  • The Groups posts filter is only applied to public posts to avoid drafts being shown to people who shouldn’t see them.
  • The posts_per_page query variable didn’t work; it’s now added to the introduced query variables so that it works.
  • Relevanssi won’t log empty queries anymore.
  • The default tax query relation was switched from OR to AND to match the WP_Query default behaviour.
  • When used with WP 5.1, Relevanssi will now use wp_insert_site instead of the now-deprecated wpmu_new_blog.
  • Multisite blog creation is handled better in WP 5.1+.
  • Relevanssi now supports Restrict Content Pro permissions.

4.1.3

  • Improvements to meta key sorting.
  • Relevanssi settings page won’t let you exclude categories you have restricted the search to.
  • Members plugin compatibility has been improved: it’s only used if the ‘content permissions’ feature has been enabled.
  • The excerpt settings page was a bit buggy.
  • Slimstat analytics is now added to the blocked shortcodes list.
  • New filter: relevanssi_search_form works exactly like get_search_form, but only applies to the Relevanssi shortcode search forms.
  • New JetPack taxonomies and post types have been added to the block list so they won’t appear in Relevanssi settings.

4.1.2

  • Choosing “CSS Style” for highlighting was not possible. That is now fixed.
  • Gutenberg reusable block indexing was fatally broken with the latest Gutenberg version. That has been updated.
  • Relevanssi now by default respects the WooCommerce “exclude from search” setting.
  • post__not_in still didn’t work properly, it does now.
  • New filter: relevanssi_comparison_order can be used to define the sorting order when sorting the results by post type.
  • “Did you mean” process included a very slow query. It is now cached, leading in some cases to massive performance improvements (we’re talking about several seconds here).
  • Highlights inside code and similar blocks are handled better now.

4.1.1.2

  • Fixes the broken User searches page.

4.1.1.1

  • Adding the missing Gutenberg compatibility file.

4.1.1

  • Relevanssi can now index Gutenberg reusable blocks. (This functionality broke once already before release, so that can happen, since Gutenberg is still in very active development.)
  • The post__in and post__not_in parameters didn’t work, and are now fixed. post_parent__in and post_parent__not_in are also improved.
  • You can use named meta queries for sorting posts. Meta query sorting is improved in other ways as well.
  • Log export didn’t work properly.
  • Adding stopwords from the common word list has been fixed.
  • The relevanssi_get_words_having filter hook is now also applied to the free version Did you mean queries.
  • New filters: relevanssi_1day and relevanssi_7days can be used to adjust the number of days for log displays, so instead of 1, 7 and 30 days you can have anything you want.

4.1.0.1

  • Actually working admin search.

4.1

  • New feature: You can now export the search log as a CSV file.
  • New feature: Admin Search page allows you to perform searches in WP admin using Relevanssi.
  • New filter: relevanssi_admin_search_capability can be used to adjust who sees the admin search page.
  • New filter: relevanssi_entities_inside_pre and relevanssi_entities_inside_code adjust how HTML entities are handled inside pre and code tags.
  • Numeric meta values (meta_value_num) are now sorted as numbers and not strings.
  • Pinned posts have $post->relevanssi_pinned set to 1 for debugging purposes, but you can also use this for styling the posts in the search results templates.
  • The Did you mean feature has been toned down a bit, to make the suggestions slightly less weird in some cases.
  • Post parent parameters now accept 0 as a value, making it easier to search for children of any post or posts without a parent.
  • Polylang compatibility has been improved.
  • Phrases with apostrophes inside work better.
  • The relevanssi_excerpt filter hook got a second parameter that holds the post ID.
  • Custom field sorting actually works now.
  • WP Search Suggest compatibility added.