Posted on

Relevanssi Premium 2.0

Relevanssi Premium 2.0!

Relevanssi Premium 2.0 has been in the works for six months. It’s finally here! The biggest new feature is the PDF content indexing: this is something that users have been asking for since Relevanssi was created, but until now I haven’t been able to provide a solution that’s good enough. Now it is finally possible.

Another big change can be found on the Relevanssi settings page. It has been rewritten and split into tabs, to make everything easier to access, understand and use. The indexing procedure is now much smoother, with no need for babysitting and repeated clicks of “Continue indexing” to index a large database. Just click “Build index” once, and that’s it – and you’ll even get an estimate of how long the process will take.

Since Relevanssi follows semantic version numbering, this means the 2.0 is a big change from 1.x and full backwards compatibility is not promised. For starters, some legacy code has been removed, and a smooth upgrade process is not promised for other than then latest 1.x versions; anything above 1.14 should be fine, but if you’re running an older version, either upgrade first to 1.16.x or remove Relevanssi Premium completely and install 2.0 from scratch. If you have lots of customizations, it’s recommended to first update to 2.0 on a staging site to see that everything works as expected. 2.0 has been tested more than any Relevanssi Premium version before, but it’s always possible something unexpected will happen.

After you update to 2.0, deactivate the plugin and reactivate it, in order to have the database structure changes take effect.

Here’s the changelog for 2.0:

  • Legacy code has been removed. If you have a version older than 1.16, update first to 1.16.x to guarantee smooth upgrade process.
  • This version includes a small database change, so if you’re updating from a previous version, after the update deactivate the plugin and then reactivate.
  • Improved indexing: no more clicking “Continue indexing” again and again!
  • Settings pages have been completely rewritten.
  • There’s documentation in the WordPress contextual help: just click Help on the top right corner.
  • Better Polylang support. A new option to remove the Polylang language filter.
  • Logs can be automatically trimmed. Old log entries are removed to save space.
  • Finally a setting to adjust content weight!
  • Excerpts can use the custom field content.
  • Highlighting in documents is changed: it now requires a highlight query parameter. This helps getting pass caching and makes the highlighting more reliable. To get the query parameter active, use relevanssi_get_permalink() to print out the permalinks on the search results templates.
  • Relevanssi added synonyms to highlighting even if synonyms were not used for searching. In some cases, synonyms were added twice.
  • The User Searches page got a makeover, too.
  • Relevanssi is automatically disabled in REST API searches.
  • Groups and Simple Membership support has been improved.
  • Sorting search results is now up to 300 times faster than before.
  • Lots of improvements all over the place.
  • New filter: relevanssi_excerpt_custom_field_content lets you modify custom field content that is used for excerpts.
  • New filter: relevanssi_punctuation_filter allows for easy modification of punctuation handling.
  • New filter: relevanssi_default_punctuation_replacement changes the default way to handle the rest of the punctuation.
  • New filter: relevanssi_search_again lets you run the search again if no results are found and to modify the parameters between search runs.
  • New filter: relevanssi_fallback allows you to do fallback searches.
  • New filter: relevanssi_page_builder_shortcodes lets you control which page builder shortcodes Relevanssi removes before building the excerpts.
  • New filter: relevanssi_optimize_excerpts makes excerpt-building faster, if you make the filter return true.
  • New query variable: set include_attachments to 0, off or false to exclude attachments from the search.

Get yours from automatic updates, or from the Download page.

Update 28.11.2017: Version 2.0 had a fatal error with older versions of PHP. The 2.0.1 update fixes that and makes the plugin safe to use on all versions of PHP. However, if you are running a PHP version older than 5.6, please update immediately, as older versions are not supported and don’t get security updates.

6 comments Relevanssi Premium 2.0

  1. Congratulations! I tested PDF search with the temporary premium add-on, it worked well, and I am excited to see it now full integrated into the plugin. Relevanssi is a powerful tool, and a useful addition to any WordPress site.

  2. It would be a good idea to recommend to users who had been testing the PDF Upload add-on to deactivate the PDF Upload add-on BEFORE upgrading to Relevanssi 2.
    I had it installed on one site, didn’t deactivate it, and the entire website became dysfunctional after upgrading (HTTP error 500, no access at all). Fortunately, I had a clone of the website, was able to restore it in 3 minutes, and then I deactivated the PDF Upload add-on, upgraded to Relevanssi 2, and everything went fine.

    1. Ah, didn’t think of that, because because that hasn’t been involved in the testing for a while now. It does have the functions with the same name, which will cause a collision.

      However, restore from backups should not be necessary, simply removing the PDF Upload plugin for example with a FTP client should fix the problem.

      1. You are right, of course. But it was also an opportunity to test if my host cloning and restoring tool is working fine – it is! What a peace of mind to have such tools available.

  3. Hello Mikko,

    I’ve been using your great plugin for several years to great success, so thanks very much. My client would like to add the ability to search the pdf content, but they’d love to see a demo of the PDF searching, is there anything available that I could show them?

    Thanks in advance for any help you could offer.

    1. Chantal, at the moment the only way to try it out is to buy a license. I’ll have to see about getting some kind of demo available, but I haven’t been able to do that yet.

Leave a Reply

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