Version 3.0.5 of SearchWP has been released and is a suggested update for all active license holders. There are a couple of enhancements and changes that should be discussed:

You can now paste in a comma separated list of Stopwords into the Stopword input and SearchWP will automatically create separate Stopwords for you. This will help when you’d like to import a list of Stopwords directly into the interface.

Partial matching has been changed slightly in version 3.0.5. In version 3.0 partial matching was implemented in such a way that it only applied when exact matches were not found. This went against the implementation of LIKE Terms and Fuzzy Matches (the Extensions that SearchWP absorbed in version 3.0) so this behavior has been reversed. When partial matching is enabled SearchWP will now search for partial matches regardless if there are exact matches. You can utilize the searchwp_partial_matches_lenient filter to restore the behavior from version 3.0 if you’d like.

The third party libraries used by SearchWP have been reorganized and updates. There are two reasons for this: primarily there was a security notice related to TCPDF which is a library used by SearchWP for PDF parsing/indexing. This security issue was not exploitable given SearchWP’s implementation as it relied on a malicious actor uploading a specific file type which needed to then be used in the creation of a PDF using TCPDF. SearchWP does not generate PDFs nor does it facilitate file uploads. While this exploit does not directly relate to SearchWP it is important to remain updated. The second reason for reorganizing these dependencies is an effort to circumvent an issue with plugin updates in certain Windows server environments.

The full changelog for version 3.0.5 is as follows:

• [New] Pasting of comma separated Stopwords will create individual Stopwords from the list
• [Fix] Conditional disabling of partial matches per engine by using provided filter
• [Fix] Prevent missing exact matches when finding partial matches
• [Improvement] Post types that are excluded from search during registration are now listed out
• [Improvement] When Metrics is installed the engine configuration Search Statistics link is correct
• [Change] Enabling partial matches no longer gives exact matches full priority, short circuiting on exact matches is now opt in via filter
• [Change] Third party dependencies have been reorganized to reduce file path which should help to avoid issues on certain Windows servers
• [Update] Translation source
• [Update] PHP version compatibility
• [Update] Dependency update which brings additional PHP compatibility
• [Security] TCPDF security update (which as evaluated could NOT have been exploited)

SearchWP 3.0.4 is a bug fix and small improvement release that is a suggested update for all active license holders. Full changelog:

• [Improvement] Handling of multiple word highlighting
• [Improvement] Better restriction during indexing
• [Fix] Issue with Advanced Custom Fields repeater detection
• [Fix] Better handling of cached data
• [Fix] Prevent unwanted indexer activity when using searchwp_indexed_post_types
• [Change] Removal of ACF field references is now opt-in
• [Change] searchwp_lenient_accents now applies during searches as well
• [New] Filter searchwp_lenient_accents_on_search to allow refined control over leinient accent treatment

Version 3.0.2 of SearchWP has been made available to all active license holders. This release fixes a couple of bugs/regressions introduced in version 3.0. Full changelog:

• [Fix] Fixes an issue with checking for unused meta keys when configuring search engines
• [Fix] Fixes a potential issue with searchwp_short_circuit being incorrectly overridden
• [Fix] Fixes an issue with synonyms not working as expected

Version 3.0.1 of SearchWP is now available which includes a small fix as outlined in the changelog:

• [Fix] Fixes an issue that may prevent Custom Fields from appearing in engine configuration

SearchWP version 3.0 has been made available to all active license holders. There are a few big changes in this release that you should be aware of:

• Rebuilt the Advanced settings screen
• Stopword management
• Integrated a number of extensions
• Rebuilt the Stats screen
• First party Advanced Custom Field support
• Support for Gutenberg blocks (introduced in WordPress 5.0)
• Improvements to SWP_Query
• Bug fixes

Here’s a quick (3 minute video) going over a few of the UI updates, followed by a more detailed breakdown of what’s new/changed in version 3.0!

Advanced Settings Screen

The Advanced tab of the SearchWP settings screen has been rebuilt and modernized in many ways, take a look!

The entire interface was re-thought from the ground up based on common use cases. The goal was to modernize the interface based on lessons learned from rebuilding the engine configuration interface in version 2.9.

Stopword Management

One of the biggest changes made to the Advanced settings screen is the inclusion of Stopword management. Stopwords are an important part of any search engine setup, and SearchWP 3.0 makes it much easier for you to manage your Stopwords. Prior to version 3.0 the only way to customize this list was through a hook, but now:

• Localized defaults are used upon installation of SearchWP
• Stopword suggestions are made based on the content of your site
• Actions to sort/remove/restore Stopwords

Beyond implementing a localized list of default stopwords, SearchWP 3.0 will suggest additional stopwords based on the content of your site.

This will help to further optimize your index resulting in faster searches with more relevant results!

Find out more

Integrated Extensions

SearchWP’s Extensions have been a big contributor to its adoption. Certain Extensions were built as future features by design, and the time has come to directly integrate some of the most popular Extensions directly into SearchWP itself. The following Extensions have been deprecated in favor of their core counterparts:

• Term Synonyms
• Term Highlight
• Manage Ignored
• LIKE Terms
• Fuzzy Matches

Term Synonyms have been directly integrated into the Advanced settings screen, and the UI has been improved in a number of ways as well:

Synonym management in SearchWP

Term Highlight has been integrated as a Setting that can be enabled with a single tick of a checkbox, managing ignored terms has been moved directly into the Stats screen (more on that in a bit), and partial matches has been improved in a number of ways as well.

Prior to SearchWP 3.0 there were two Extensions to help with partial matches; LIKE Terms and Fuzzy Matches. They both did different things, but at first glance it was very confusing as to why you’d use one over the other, or both for that matter. Partial matches have been directly integrated into SearchWP 3.0, and the details of the implementation have been made available in the documentation for that feature.

Rebuilt Stats Screen

Search statistics have always been an important part of the data provided by SearchWP to site owners. Being able to monitor what your visitors are actively searching for can be a big help in determining what content changes to make on your site. The existing stats screen hadn’t changed much since version 1.0 and with the need to integrate management of ignored terms and the ability to reset the statistics it was time to rebuild and modernize it.

The charting library has been updated and UI rebuilt in a more modern way which will make stats review a much more pleasant experience going forward. If you’re looking to get more out of your search stats, be sure to check out the Metrics extension!

Advanced Custom Fields Support

SearchWP has always considered custom fields to be first party content, and many SearchWP users are big fans of Advanced Custom Fields. The documentation for SearchWP mentions ACF a lot, and as of SearchWP 3.0 the Custom Fields dropdown will now automatically support “repeatable” fields by utilizing SearchWP’s ability to partially match meta keys:

Adding a repeatable entry will include all sub-fields of that repeatable ACF field, saving you the trouble of adding individual sub-fields. This functionality has been supported by SearchWP but prior to 3.0 you needed to use your own hooks to explicitly add support for partial meta key matches.

SearchWP 3.0 will also remove ACF reference fields (the fields with the same meta key but prefixed with an underscore) to clean things up for you.

Gutenberg Block Parsing

By default SearchWP 3.0 will parse content that has been input using blocks (a.k.a. Gutenberg) as introduced in WordPress 5.0. For the time being there is no way to give individual blocks specific weights, all of the content generated from parsing the block will be index as it was entered into the main post content.

If you would prefer that SearchWP not parse your blocks, you can add this hook to a custom plugin or your theme’s functions.php:

If you feel that giving control over individual blocks would be useful in an upcoming version of SearchWP please send over your input!

Improvements to SWP_Query

The goal of SWP_Query was to mimic WP_Query so as to save you trouble when migrating from a traditional WordPress Loop for search results.

As of SearchWP version 3.0, SWP_Query now supports a more traditional Loop like so:

These new methods should make it easier for everyone to take advantage of what SWP_Query has to offer!

Bug Fixes and Improvements

There were a number of bug fixes and performance optimizations rolled into SearchWP 3.0 as well, here’s the full changelog:

• [New] Advanced Settings screen rebuilt and optimized
• [New] searchwp_legacy_advanced_settings filter controls whether the legacy Advanced Settings screen is used
• [New] Integrated stopword management on the Advanced Settings screen
• [New] Default stopwords for the following locales: CS, DA, DE, EN, ES, FI, GA, IT, NL, PL, PT, RO, RU, SV, TR
• [New] Suggested stopwords based on existing site content
• [New] Integrated Term Synonyms and improved management UI (extension is now deprecated)
• [New] Integrated Term Highlight (extension is now deprecated)
• [New] Integrated LIKE Terms and Fuzzy Matches (extensions are now deprecated)
• [New] Adds setting to parse Shortcodes during indexing (e.g. UI for searchwp_do_shortcodes)
• [New] SWP_Query now has the following methods: have_posts, rewind_posts, the_post, next_post allowing for a more traditional Loop
• [New] Custom Fields dropdown now supports meta groups
• [New] Automatic UI for “repeatable” field groups in Advanced Custom Fields
• [New] Statistics screen rebuilt and optimized
• [New] Management of ignored searches is now built in to the Stats screen
• [New] Resetting of statistics is now built in to the Stats screen
• [New] searchwp_statistics_popular_days_{$days} filter allows overriding of popular search queries
• [New] searchwp_legacy_stats filter controls whether the legacy Advanced Settings screen is used
• [New] searchwp_results_found_posts filter allows modification of SearchWP’s found posts
• [New] searchwp_results_max_num_pages filter allows modification of SearchWP’s maximum number of pages
• [New] Support for programmatic license management. See SearchWP_License class
• [New] Adds (dismiss-able) notice during admin searches when admin searches are not hijacked by SearchWP
• [New] Adds support for WordPress’ block editor during indexing (blocks will be parsed prior to indexing)
• [Fix] Adds support for results limiting when parent attribution is enabled
• [Fix] Better handling of emoji during indexing
• [Fix] Prevent pattern whitelist matches from being counted twice
• [Fix] Prevent data mutation when creating multiple supplemental engines at once
• [Change] Indexing emoji is now opt-in using the searchwp_index_emoji filter

Version 2.9.17 of SearchWP includes a fix for delta updates that in some cases caused extensive resource usage, it is a recommended update for all active license holders.

Full changelog:

• [Improvement] Better handling of post status and comment triggers of delta updates, reducing significant overhead in some cases

Version 2.9.16 of SearchWP is now available for all active license holders. In this release SWP_Query received a few updates and a number of fixes have been put in place.

Full changelog:

• [Fix] Fixes an issue that prevented proper respect of searchwp_background_deltas
• [Fix] Fixes an issue with debug log permissions in some cases
• [Fix] Fixes an issue where Custom Field keys were not accurately retrieved in older versions of WordPress
• [Fix] Fixes settings screen JavaScript error in IE11
• [Fix] Fixes an issue preventing the application of searchwp_search_query_order
• [Improvement] Notes the requirement that the index must be rebuilt after ticking checkbox to remove minimum character count
• [New] Adds post_status parameter to SWP_Query
• [New] Adds order parameter to SWP_Query
• [New] Adds limited orderby parameter to SWP_Query

SearchWP version 2.9.15 is available to all active license holders. This is a maintenance and bug fix release, but it also improves the debug log in a number of ways which will reduce some friction when receiving support.

Full changelog:

• [Fix] Fixes an issue where in some cases delta update requests were not processed correctly
• [Fix] PHP Warning cleanup
• [Improvement] The debug log generation process has been improved and the debug log more streamlined/readable
• [New] New filter searchwp_debug_detailed to control whether detailed items are logged when debugging is enabled

Version 1.0.3 of Metrics has been released. It is primarily a performance release and is recommended to all Metrics users. Full changelog:

• [Improvement] Improves performance when generating Insights
• [New] Settings button now has its own capability
• [New] New filter searchwp_metrics_capability_settings to modify the Settings button capability

Enjoy!

Redirects has been updated to version 1.1, it now sorts your redirects in alphabetical order after saving. This will make management of the Redirects themselves a bit easier.