Lifecycle cleanup on deactivate\/uninstall, password-protected post skip, pagination fix, CSV formula hardening, Recent Searches column hooks, autosuggest localization, and task pane fixes. See DOCS.md.<\/p>","1.5.2":"
Bug fixes and added a new hook.<\/p>","1.5.1":"
Search forms are discovered by CSS selector; extend the list with Hybrid\/semantic search and embedder management are now built into Index Settings, plus draggable searchable-field ordering and analytics for hybrid queries. See DOCS.md.<\/p>","1.4.0":" Tabbed Index Settings: filterable fields, custom ranking rules, dictionary, typo tolerance, raw JSON viewers, plus batched bulk indexing and new More developer hooks (indexing\/search gates, client factory, autosuggest results, admin tabs), optional highlighting, autosuggest thumbnails, analytics metadata, Hybrid listing, indexing fix for embedder setups. See DOCS.md.<\/p>","1.2.1":" Upgrades page updates; task pane fix for multi-tenant Meilisearch.<\/p>","1.2.0":" Logs screen and expanded hooks \/ Analytics CSV export and retention cleanup.<\/p>","1.0.3":" Optional AJAX autosuggest under Search Settings.<\/p>","1.0.0":" Initial release.<\/p>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":3},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3474753,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3474753,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0","1.0.1","1.0.2","1.1.0","1.1.1","1.1.2","1.2.0","1.2.1","1.3.0","1.4.0","1.5.0","1.5.1","1.5.2","1.6.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3670935,"resolution":"1","location":"assets","locale":"","width":307,"height":486},"screenshot-10.png":{"filename":"screenshot-10.png","revision":3670935,"resolution":"10","location":"assets","locale":"","width":595,"height":634},"screenshot-11.png":{"filename":"screenshot-11.png","revision":3670935,"resolution":"11","location":"assets","locale":"","width":592,"height":634},"screenshot-12.png":{"filename":"screenshot-12.png","revision":3670935,"resolution":"12","location":"assets","locale":"","width":954,"height":881},"screenshot-13.png":{"filename":"screenshot-13.png","revision":3670935,"resolution":"13","location":"assets","locale":"","width":954,"height":879},"screenshot-14.png":{"filename":"screenshot-14.png","revision":3670935,"resolution":"14","location":"assets","locale":"","width":917,"height":887},"screenshot-15.png":{"filename":"screenshot-15.png","revision":3670935,"resolution":"15","location":"assets","locale":"","width":490,"height":904},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3670935,"resolution":"2","location":"assets","locale":"","width":961,"height":878},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3670935,"resolution":"3","location":"assets","locale":"","width":958,"height":867},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3670935,"resolution":"4","location":"assets","locale":"","width":592,"height":634},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3670935,"resolution":"5","location":"assets","locale":"","width":593,"height":637},"screenshot-6.png":{"filename":"screenshot-6.png","revision":3670935,"resolution":"6","location":"assets","locale":"","width":595,"height":636},"screenshot-7.png":{"filename":"screenshot-7.png","revision":3670935,"resolution":"7","location":"assets","locale":"","width":592,"height":637},"screenshot-8.png":{"filename":"screenshot-8.png","revision":3670935,"resolution":"8","location":"assets","locale":"","width":591,"height":633},"screenshot-9.png":{"filename":"screenshot-9.png","revision":3670935,"resolution":"9","location":"assets","locale":"","width":590,"height":631}},"screenshots":{"1":"Index Settings Dashboard - Manage post type indexes, view document counts, and trigger indexing operations","2":"Index Configuration Modal - Tabbed settings for ranking rules, searchable\/filterable fields, synonyms, stop words, dictionary, typo tolerance, and hybrid search embedders","3":"Connection Settings - Configure Meilisearch URL and API keys with connection testing","4":"Search Settings - Configure post type search weights for federated search, enable AJAX autosuggest, and set the class selector for which forms receive predictive search","5":"Task Drawer - Monitor Meilisearch tasks with status, timing, and error details","6":"Live Search Preview - Test search queries directly from the admin panel","7":"Search Analytics - Dashboard, privacy\/retention settings, CSV export of analytics data"}},"plugin_section":[],"plugin_tags":[2275,274822,4073,230825,944],"plugin_category":[45],"plugin_contributors":[222622],"plugin_business_model":[],"class_list":["post-261956","plugin","type-plugin","status-publish","hentry","plugin_tags-developer","plugin_tags-extendable","plugin_tags-hooks","plugin_tags-meilisearch","plugin_tags-search","plugin_category-ecommerce","plugin_contributors-jtgraham38","plugin_committers-jtgraham38"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/scry-search\/assets\/icon-128x128.png?rev=3474753","icon_2x":"https:\/\/ps.w.org\/scry-search\/assets\/icon-256x256.png?rev=3474753","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/scry-search\/assets\/screenshot-1.png?rev=3670935","caption":"Index Settings Dashboard - Manage post type indexes, view document counts, and trigger indexing operations"},{"src":"https:\/\/ps.w.org\/scry-search\/assets\/screenshot-2.png?rev=3670935","caption":"Index Configuration Modal - Tabbed settings for ranking rules, searchable\/filterable fields, synonyms, stop words, dictionary, typo tolerance, and hybrid search embedders"},{"src":"https:\/\/ps.w.org\/scry-search\/assets\/screenshot-3.png?rev=3670935","caption":"Connection Settings - Configure Meilisearch URL and API keys with connection testing"},{"src":"https:\/\/ps.w.org\/scry-search\/assets\/screenshot-4.png?rev=3670935","caption":"Search Settings - Configure post type search weights for federated search, enable AJAX autosuggest, and set the class selector for which forms receive predictive search"},{"src":"https:\/\/ps.w.org\/scry-search\/assets\/screenshot-5.png?rev=3670935","caption":"Task Drawer - Monitor Meilisearch tasks with status, timing, and error details"},{"src":"https:\/\/ps.w.org\/scry-search\/assets\/screenshot-6.png?rev=3670935","caption":"Live Search Preview - Test search queries directly from the admin panel"},{"src":"https:\/\/ps.w.org\/scry-search\/assets\/screenshot-7.png?rev=3670935","caption":"Search Analytics - Dashboard, privacy\/retention settings, CSV export of analytics data"},{"src":"https:\/\/ps.w.org\/scry-search\/assets\/screenshot-8.png?rev=3670935","caption":""},{"src":"https:\/\/ps.w.org\/scry-search\/assets\/screenshot-9.png?rev=3670935","caption":""},{"src":"https:\/\/ps.w.org\/scry-search\/assets\/screenshot-10.png?rev=3670935","caption":""},{"src":"https:\/\/ps.w.org\/scry-search\/assets\/screenshot-11.png?rev=3670935","caption":""},{"src":"https:\/\/ps.w.org\/scry-search\/assets\/screenshot-12.png?rev=3670935","caption":""},{"src":"https:\/\/ps.w.org\/scry-search\/assets\/screenshot-13.png?rev=3670935","caption":""},{"src":"https:\/\/ps.w.org\/scry-search\/assets\/screenshot-14.png?rev=3670935","caption":""},{"src":"https:\/\/ps.w.org\/scry-search\/assets\/screenshot-15.png?rev=3670935","caption":""}],"raw_content":"\n Scry Search wires Meilisearch into WordPress the way you'd want it on a client project: fast keyword search, optional AI\/semantic (hybrid) search, and a big extension surface \u2014 without ripping out your theme.<\/p>\n\n Docs (start here):<\/strong> DOCS.md on GitHub<\/a> \u2014 every filter\/action, args, return values, when it fires, plus the You get over 40 PHP hooks<\/strong> ( This is the important bit:<\/p>\n\n Admin-side tuning is a different story: ranking, searchable\/filterable fields, synonyms, typo tolerance, hybrid embedders, federated weights, etc. are all in wp-admin (see below). You\u2019re not stuck editing Meilisearch JSON by hand \u2014 you\u2019re just not locked into a plugin-owned results page.<\/p>\n\n Under the hood we hook Need native WP search for one query? Keyword search is the baseline. Hybrid search is built into the core plugin (not a separate SKU): Meilisearch blends full-text ranking with vector similarity so \"fuzzy intent\" queries still hit the right posts\/products.<\/p>\n\n Per index, under Index Settings \u2192 Configure Index \u2192 Hybrid Search<\/strong>:<\/p>\n\n Same Most of Meilisearch\u2019s knobs are in WordPress \u2014 you don\u2019t need to curl the instance for day-to-day tuning.<\/p>\n\n Connection<\/strong> \u2014 URL, admin key, optional search-only key, connection test.<\/p>\n\n Index Settings<\/strong> (tabbed dialog per post type):<\/p>\n\n Search Settings<\/strong> \u2014 federated post-type weights (e.g. products above blog posts), optional AJAX autosuggest (with optional form class targeting), optional matched-term highlighting ( Ops<\/strong> \u2014 task pane, Logs, Search Analytics (see For developers<\/strong>).<\/p>\n\n You can go live from these screens alone. Hooks kick in when a project needs something the UI doesn\u2019t cover.<\/p>\n\n These are the only front-end UI pieces the plugin ships, and both are off by default. Your theme\u2019s results page stays yours either way.<\/p>\n\n Autosuggest<\/strong> \u2014 Search Settings toggle. The front-end runtime finds forms via CSS selectors (defaults: Highlighting<\/strong> \u2014 optional matched-term markup in results \/ autosuggest (class Each registered post type can get its own Meilisearch index (posts, pages, WooCommerce: select Full hook reference + JS API:<\/strong> DOCS.md on GitHub<\/a><\/p>\n\n 45 PHP hooks<\/strong> documented there (filters + actions). Names below; args\/returns\/timing in the docs. Call sites tagged Task pane<\/strong> \u2014 drawer on plugin admin screens for Meilisearch tasks on indexes this plugin owns: status, duration, errors, paginated history. Shared Meilisearch instances won\u2019t dump unrelated tasks. Useful when bulk indexing stalls or a settings update fails silently.<\/p>\n\n Error \/ debug logs<\/strong> \u2014 Scry Search \u2192 Logs. Debug and Error levels, filterable viewer, DB-backed newest-first with load-more, API keys\/tokens redacted before storage, retention + daily cleanup (or clean on demand). Hook Search analytics<\/strong> \u2014 Scry Search \u2192 Search Analytics. Dashboard with summary metrics, charts, and recent searches; optional IP anonymization \/ omit identifying fields; retention with WP-Cron cleanup; CSV export (admin-only, nonce-protected). Extend rows with Filters \u2014 indexing \/ documents:<\/p>\n\n Filters \u2014 settings:<\/p>\n\n Filters \u2014 search \/ client:<\/p>\n\n Filters \u2014 autosuggest \/ admin \/ analytics \/ logs \/ window:<\/p>\n\n Actions:<\/p>\n\n JS:<\/strong> Code lives under Self-hosting is first-class.<\/strong> Paste any Meilisearch URL and keys into Connection Settings \u2014 Docker, bare metal, VPS, or local dev all work the same way. Pick post types, index, ship.<\/p>\n\n When you'd rather not run the search engine itself, ScryWP<\/a> is managed hosting built for WordPress. What you get upfront:<\/p>\n\n That's the managed value: less infrastructure to operate, not a different product. Choose ScryWP when ops time or handoff complexity isn't where you want to spend budget. Choose self-host or local when you need full control, compliance boundaries, or an offline sandbox.<\/p>\n\n Paste URL + keys, pick post types, index. Done.<\/p>\n\n Don't want to operate Meilisearch yourself? ScryWP Search<\/a> runs the engine for you \u2014 kept patched, monitored, and maintained \u2014 so search isn't another server to babysit. Self-hosting and local dev stay fully supported; see Managed hosting (ScryWP)<\/strong> below.<\/p>\n\n Hooks\/docs: DOCS.md or GitHub<\/a>. Issues and questions: same repo or JG Web Development<\/a>.<\/p>\n\n\n You can complete the whole flow from wp-admin without custom code. Hooks are there when you need them.<\/p>\n\n\n Deactivating clears the plugin's daily cron jobs (analytics and log cleanup) so they stop running while the plugin is inactive. Your settings, API keys, custom tables, and Meilisearch indexes are left in place \u2014 reactivating restores normal operation and re-schedules cron.<\/p>\n\n Deleting the plugin (uninstall) removes the two custom database tables ( No for live saves \u2014 published posts with a password are skipped before indexing. Use 45 documented Yes. Connect Meilisearch, pick post types, index, tune ranking\/synonyms\/weights\/hybrid\/autosuggest from wp-admin. Bring a developer when you need behavior the screens don't cover.<\/p><\/dd>\n Optional. Keyword search works without it. Hybrid is in core when you want vector similarity alongside full-text \u2014 configure embedders per index, reindex, same results templates.<\/p><\/dd>\n No. We don\u2019t own your results page \u2014 your theme (or builder) still displays posts from No. Forms and scry_ms_window_localized<\/code>, and optionally limit autosuggest by form class. See DOCS.md.<\/p>","1.5.0":"scry_ms_*<\/code> hooks. See DOCS.md.<\/p>","1.3.0":"window.scrySearch<\/code> (see DOCS.md).<\/p>","1.1.2":"window.scrySearch<\/code> JS API. Same file ships in the plugin zip.<\/p>\n\nscry_ms_*<\/code>) covering indexing, documents, index settings, federated search, autosuggest, analytics, logs, and the front-end runtime. Call sites are marked in source. If you can install a plugin and paste API keys, you can run it without writing code. If you ship WordPress for a living, you can bend it without forking.<\/p>\n\nNo theme changes. Not glued to a results UI.<\/h4>\n\n
\n
search.php<\/code> (or whatever your theme \/ builder uses) still renders the results.<\/li>\nsearchform.php<\/code>, Elementor\/Divi\/Beaver search widgets \u2014 they still POST to WordPress; we intercept the query.<\/li>\n<\/ul>\n\nposts_pre_query<\/code>, run the search in Meilisearch, and hand WordPress normal WP_Post<\/code> objects. Same loop, same template tags, same pagination assumptions your theme already has.<\/p>\n\nscry_ms_should_search<\/code>.<\/p>\n\nBuilt-in semantic \/ hybrid search<\/h4>\n\n
\n
WP_Query<\/code> path as keyword search. No second endpoint, no alternate results page. Reindex after embedder changes so vectors exist. Analytics can record hybrid usage in search_metadata<\/code>.<\/p>\n\nWhat you configure in wp-admin<\/h4>\n\n
\n
post_date_unix<\/code>, taxonomy IDs (taxonomies.<name>.id<\/code>), and more for facets \/ advanced filters<\/li>\nattribute:asc<\/code> \/ attribute:desc<\/code><\/li>\n.scry-ms-highlight<\/code>).<\/p>\n\nAutosuggest + highlighting (optional front-end extras)<\/h4>\n\n
#adminbarsearch<\/code>, form[role=\"search\"]<\/code>, including the core Search block). Debounced AJAX, same indexes as full search. Optional form class if you only want typeahead on specific forms. Thumbnails when a featured image exists. Extend discovery selectors with scry_ms_window_localized<\/code> \u2014 details in DOCS.md. Shape data with scry_ms_autosuggest_results<\/code> or markup with scry_ms_autosuggest_results_rendered<\/code>.<\/p>\n\n.scry-ms-highlight<\/code>). Style it in your theme; we don\u2019t force a look.<\/p>\n\nIndexes and federation<\/h4>\n\n
product<\/code>, CPTs). Federated multi-search merges them with your Search Settings weights \u2014 not a home-rolled PHP merge.<\/p>\n\nproduct<\/code>, pick product fields\/meta, set weights if you also search posts\/pages. Catalog search upgrades; theme and checkout stay as they are.<\/p>\n\nOps: indexing<\/h4>\n\n
\n
For developers<\/h4>\n\n
\/\/@HOOK: scry_ms_\u2026<\/code> in source.<\/p>\n\nscry_ms_log_message<\/code> if you need to divert or annotate lines.<\/p>\n\nscry_ms_analytics_event_to_insert<\/code> (non-column keys go into search_metadata<\/code>, including hybrid usage when enabled).<\/p>\n\n\n
scry_ms_should_index<\/code>, scry_ms_should_delete<\/code>, scry_ms_index_prepare_document<\/code><\/li>\nscry_ms_index_names<\/code>, scry_ms_index_searchable_attributes<\/code>, scry_ms_index_filterable_attributes<\/code>, scry_ms_index_filterable_fields<\/code><\/li>\nscry_ms_index_typo_tolerance<\/code>, scry_ms_index_ranking_rules<\/code>, scry_ms_index_fields<\/code>, scry_ms_index_meta_keys<\/code><\/li>\nscry_ms_bulk_index_query_args<\/code>, scry_ms_bulk_index_batch_size<\/code><\/li>\n<\/ul>\n\n\n
scry_ms_index_settings_ajax<\/code>, scry_ms_index_settings_backup<\/code><\/li>\nscry_ms_index_ranking_rules_before_update<\/code>, scry_ms_index_searchable_attributes_before_update<\/code><\/li>\nscry_ms_index_synonyms_before_update<\/code>, scry_ms_index_stop_words_before_update<\/code><\/li>\nscry_ms_index_filterable_attributes_before_update<\/code>, scry_ms_index_dictionary_before_update<\/code>, scry_ms_index_typo_tolerance_before_update<\/code><\/li>\n<\/ul>\n\n\n
scry_ms_should_search<\/code>, scry_ms_meilisearch_client<\/code><\/li>\nscry_ms_multi_search_index_names<\/code>, scry_ms_multi_search_query_params<\/code>, scry_ms_multi_search_query<\/code>, scry_ms_multi_search_queries<\/code><\/li>\nscry_ms_multi_search_federation<\/code>, scry_ms_multi_search_raw_results<\/code>, scry_ms_multi_search_final_results<\/code><\/li>\n<\/ul>\n\n\n
scry_ms_autosuggest_query<\/code>, scry_ms_autosuggest_results<\/code>, scry_ms_autosuggest_results_rendered<\/code>, scry_ms_autosuggest_localized<\/code><\/li>\nscry_ms_admin_pages<\/code>, scry_ms_analytics_event_to_insert<\/code>, scry_ms_analytics_recent_searches_columns<\/code>, scry_ms_analytics_recent_searches_column<\/code>, scry_ms_log_message<\/code>, scry_ms_window_localized<\/code><\/li>\n<\/ul>\n\n\n
scry_ms_after_index_document<\/code>, scry_ms_after_delete_document<\/code>, scry_ms_after_bulk_index<\/code>, scry_ms_after_create_index<\/code><\/li>\nscry_ms_index_settings_restore<\/code>, scry_ms_index_update_settings<\/code>, scry_ms_index_settings_sections_ui<\/code><\/li>\n<\/ul>\n\nwindow.scrySearch<\/code> (handle scry_ms_window-script<\/code>). Wait for scrySearchReady<\/code>. Forms from windowLocalized.searchFormSelectors<\/code>; filter scry_ms_window_localized<\/code> to add selectors (e.g. form.my-search<\/code>). Per-form pre\/post submit + AJAX hooks for custom front-end behavior.<\/p>\n\nfeatures\/<name>\/<\/code>. Prefer a search-only key on the front; the client factory supports admin vs search.<\/p>\n\nManaged hosting (ScryWP)<\/h4>\n\n
\n
scry_ms_*<\/code> hooks behave the same as self-host.<\/li>\n<\/ul>\n\nHosting options<\/h4>\n\n
\n
Fits what you already have<\/h4>\n\n
\n
search.php<\/code> \/ results markup \u2014 unchanged<\/li>\nsearchform.php<\/code>, core search block\/widget, page-builder search boxes<\/li>\nWP_Query<\/code> or REST if you build one<\/li>\n<\/ul>\n\nGet Managed Hosting from ScryWP<\/h3>\n\n
Requirements<\/h3>\n\n
\n
Support<\/h3>\n\n
\n
wp-content\/plugins\/<\/code> or via Plugins \u2192 Add New).<\/li>\nadd_filter( 'scry_ms_\u2026' )<\/code>.<\/li>\n<\/ol>\n\n\n
What happens when I deactivate or uninstall?<\/h3><\/dt>\n
scry_ms_search_analytics<\/code>, scry_ms_logs<\/code>), all scry_ms_*<\/code> options (connection keys, embedder secrets, index backups, etc.), and any remaining scheduled cron events. It does not delete indexes or documents on your Meilisearch server.<\/p><\/dd>\nWill password-protected posts be indexed?<\/h3><\/dt>\n
scry_ms_should_index<\/code> on bulk reindex (or always) if you need the same rule there. Already-indexed protected posts stay in Meilisearch until you reindex\/wipe.<\/p><\/dd>\nWhat makes this developer-friendly?<\/h3><\/dt>\n
scry_ms_*<\/code> hooks, call sites marked in source, shared client filter, and a real docs file \u2014 not a marketing PDF. Plus the tooling you\u2019d actually use on a site: task pane for Meilisearch jobs, error\/debug logs, and search analytics (dashboard + CSV). Start here: DOCS.md<\/a>. Optional window.scrySearch<\/code> if you need front-end glue. No forced search results UI.<\/p><\/dd>\nCan non-developers use it?<\/h3><\/dt>\n
Do I need semantic \/ AI search?<\/h3><\/dt>\n
Do I have to use a frontend UI from the plugin?<\/h3><\/dt>\n
WP_Query<\/code>. Ranking, fields, synonyms, typo tolerance, hybrid, weights, etc. are configured in wp-admin. Autosuggest and highlighting are the optional front-end extras; leave them off and you\u2019re indexing + query routing only.<\/p><\/dd>\nDo I need to change my theme?<\/h3><\/dt>\n
search.php<\/code> (or equivalent) keep working. We swap the query engine, not the markup. Page-builder search boxes that hit WordPress search work the same way.<\/p><\/dd>\nWhat is Meilisearch?<\/h3><\/dt>\n