Posted on

Premium 2.16 / Free 4.14

Relevanssi Premium 2.16.0 is a major release that adds new, exciting features. The most interesting new tool is click tracking, which grants you extra insight into what the search users are doing. Some of these features are also available in the matching free Relevanssi version 4.14.0. The new User searches page should be a delight!


  • There was a single comma that made Relevanssi Premium 2.16.7 incompatible with PHP versions 7.2 or earlier. Relevanssi is supposed to be compatible with PHP 7+, so this version restores PHP 7 compatibility. (That said, do move on to PHP 8. The affected PHP versions are no longer officially supported and are not safe to use in the long run.)

2.16.7 / 4.14.7

  • Premium. Minor fix: The relevanssi_index_taxonomies_args filter hook should’ve been removed from use long time ago, but it was still in use in some cases, and thus relevanssi_hide_empty_terms didn’t always work, depending on how the terms were indexed. Now the filter use is consistent and relevanssi_hide_empty_terms is always used.
  • The synonym settings page now alerts if the synonyms aren’t active because of the AND search.


  • Premium. Minor fix: The translations would show up as requiring update, even after the update. This is now fixed.
  • Premium. Minor fix: Pinning didn’t work with numeric keywords.

2.16.5 / 4.14.6

  • Security fix: Extra security checks for AJAX actions.

2.16.4 / 4.14.5

  • Security fix: Any registered user could empty the Relevanssi index by triggering the index truncate AJAX action. That is no longer possible.
  • New feature: The searchform shortcode has a new parameter, ‘checklist’, which you can use to create taxonomy checklists.
  • New feature: New filter hook relevanssi_post_type_archive_ok allows controlling whether individual post type archives are indexed or not.
  • New feature: You can now set the API key with the constant RELEVANSSI_API_KEY. If the constant is set, the API key settings disappear on the Relevanssi settings page.
  • Changed behaviour: The relevanssi_related_output_objects filter hook has been removed. It was unnecessary: it simply isn’t useful to filter a function return value, because you can modify it without a filter hook.
  • Changed behaviour: The relevanssi_search_form filter hook has an additional parameter which has the shortcode attributes.
  • Changed behaviour: The relevanssi_search_again parameter array has more parameters the filter can modify.
  • Changed behaviour: The relevanssi_show_matches filter hook gets the post object as the second parameter.
  • Changed behaviour: The relevanssi_term_add_data filter hook now runs also when individual terms are modified. Previously it only run when all terms were indexed.
  • Translations: Relevanssi Premium is now professionally translated to German and Spanish.

2.16.3 / 4.14.3, 4.14.4

  • Security: Removes a XSS vulnerability from the user searches page.
  • Makes the relevanssi_orderby filter hook work better with array format parameters.
  • Fixes problems with highlighting related to upper-case search terms and multiline HTML tags.
  • Click tracking codes are no longer added to URLs for non-logged users and bots.
  • Image attachments could get indexed even when the indexing was blocked from the settings.

2.16.2 / 4.14.2

  • Removes unnecessary database calls from admin pages.
  • Improves Oxygen compatibility.

2.16.1 / 4.14.1

  • 2.16.1 fixes broken post query insights page.
  • 4.14.1 fixes white screen of death from a missing file.

New features

  • Premium. Click tracking lets you track the way the users click different posts from the search results pages. Enable the click tracking from the Logging settings to see it in effect.
  • Premium. Proximity sorting lets you sort posts by geographical distance. See the knowledge base for details on how this works.
  • New filter hook relevanssi_render_blocks controls whether Relevanssi renders blocks in a post or not. If you are having problems updating long posts with lots of blocks, having this filter hook return false for the post in question will likely help, as rendering the blocks in a long post can take huge amounts of memory.
  • The searchform shortcode has a new parameter, post_type_boxes, which creates a checkbox for each post type you list in the value. For example [searchform post_type_boxes='*post,page'] would create a search with a checkbox for post and page post types, with post pre-checked.
  • You can now have multiple dropdowns in one searchform shortcode. Anything that begins with ‘dropdown’ is considered a dropdown parameter, so you can do [searchform dropdown_1='category' dropdown_2='post_tag'] for example.
  • New filter hook relevanssi_search_params lets you filter search parameters after they’ve been collected from the WP_Query.
  • New filter hook relevanssi_excerpt_post lets you make Relevanssi skip creating excerpts for specific posts.

Changed behaviour

Minor fixes

  • Stopwords weren’t included in the exported options; they are now.
  • Relevanssi won’t let you adjust synonyms and stopwords anymore if you use Polylang and are in ‘Show all languages’ mode.
  • New parameter for relevanssi_tokenize() introduces the context (indexing or search query). The relevanssi_extract_phrases() is only used on search queries.
  • Premium. When you deactivate the Related posts feature from the settings, the related post caches for posts are flushed.
  • In some languages, iOS uses „“ for quotes. Relevanssi now understands those for the phrase operator.
  • Premium. You can now choose ‘user’ post type in the admin search post type dropdown.
  • Premium. The debugging page now lets you debug user profiles and taxonomy terms.
  • Highlighting is improved by a more precise HTML entity filter, thanks to Jacob Bearce.
  • Fixes problems with the WP-Members compatibility.
  • Premium. The relevanssi_premium_tokenizer filter hook now gets the context (indexing or searching) as a parameter.
  • Stops Relevanssi from blocking the admin search for WooCommerce coupons and other WooCommerce custom post types.
  • Premium. Searching for a stemmed word with the AND search didn’t find correct results.

The update is available as an automatic update, and you can also get it from the Downloads page. The free version is available from the WordPress plugin repository.

Leave a Reply

Are you a Relevanssi Premium customer looking for support? Please use the Premium support form.

Your email address will not be published. Required fields are marked *