Quick Install<\/strong><\/p>\n\n\n- Upload the plugin files to the
\/wp-content\/plugins\/loupe-search<\/code> directory, or install the plugin through the WordPress plugins screen directly<\/li>\n- Activate through the 'Plugins' menu in WordPress<\/li>\n<\/ul><\/li>\n
Post-Installation<\/strong><\/p>\n\n\n- Visit Settings > Loupe Search to configure<\/li>\n
- Click 'Reindex' to build the initial search index (runs in batches to avoid timeouts)<\/li>\n<\/ul><\/li>\n
Updates<\/strong><\/p>\n\n\n- Plugin updates are handled automatically by WordPress.org.<\/li>\n<\/ul><\/li>\n<\/ol>\n\n\n
\nHow does it handle updates to posts?<\/h3><\/dt>\nThe search index automatically updates when content is created, modified, or deleted.<\/p><\/dd>\n
Will it slow down my site?<\/h3><\/dt>\nNo. Loupe Search uses a separate, optimized search index and doesn't impact your main database performance.<\/p><\/dd>\n
Can I customize what content is searchable?<\/h3><\/dt>\nYes, using filters you can control exactly what content gets indexed and how it's searched.<\/p><\/dd>\n
Does it work with custom post types?<\/h3><\/dt>\nYes, you can select which post types to include in the Settings page or via filters.<\/p><\/dd>\n
How do I reindex on large sites?<\/h3><\/dt>\nUse Settings > Loupe Search > Reindex (batched), or run via WP-CLI:<\/p>\n\n
\nwp loupe-search reindex<\/code><\/li>\nwp loupe-search reindex --post-types=post,page --batch-size=1000<\/code><\/li>\n<\/ul><\/dd>\nHow do I use advanced search operators?<\/h3><\/dt>\n\nHello World<\/code> will search for posts containing Hello<\/code> or<\/strong> World<\/code>.<\/li>\n\"Hello World\"<\/code> will search for posts containing the exact phrase Hello World<\/code>.<\/li>\nHello -World<\/code> will search for posts containing Hello<\/code> but not World<\/code>.<\/li>\n<\/ul><\/dd>\nWhat are the technical requirements?<\/h3><\/dt>\n\n- PHP 8.3 or higher<\/li>\n
- SQLite 3.35+ (required by Loupe)<\/li>\n
- PHP extensions: pdo_sqlite, intl, mbstring<\/li>\n
- WordPress 6.9+<\/li>\n<\/ul><\/dd>\n\n<\/dl>\n\n\n
1.2.4<\/h4>\n\n\n- Changed: The minimum PHP version is now 8.3. The plugin's dependencies already required PHP 8.2\/8.3, so the previously advertised 8.1 requirement was not accurate.<\/li>\n
- Security: The public search REST route and search ability now scope the query itself to public post types, so hit totals and facet counts can no longer reveal indexed non-public content.<\/li>\n
- Changed: The plugin's options moved off the
wp_<\/code> prefix, which is reserved for WordPress core. Existing settings are migrated automatically on first load.<\/li>\n- Changed: The settings screen moved to
options-general.php?page=loupe-search<\/code>.<\/li>\n- Removed: The 12-hour cache in front of the public search route. Caching every query from an unauthenticated route could grow the options table without bound.<\/li>\n
- Removed: Third-party command line entry points and build config from the release package.<\/li>\n
- Removed: The unused language-detection n-gram databases from the release package, which drops it from 197 MB to 25 MB.<\/li>\n
- Fixed: The indexer stripped tags using a deprecated filter name.<\/li>\n
- Added: The
loupe_search_max_cacheable_query_length<\/code> filter (default 128) bounds which queries are written to the result cache.<\/li>\n<\/ul>\n\n1.2.3<\/h4>\n\n\n- Changed: Updated the plugin screenshots to reflect the current settings UI.<\/li>\n
- Changed: Corrected the screenshot descriptions to match the current Search Behavior tab.<\/li>\n<\/ul>\n\n
1.2.2<\/h4>\n\n\n- Security: Public REST search endpoints and the search abilities now only return results from public post types.<\/li>\n
- Security: Field settings now sanitize the nested post-type and field-name keys.<\/li>\n
- Changed: Updated the bundled Loupe search engine to 1.0.1 (compound-word decomposition, improved excerpt cropping).<\/li>\n
- Removed: The bundled plugin update checker library; updates are served by WordPress.org.<\/li>\n
- Fixed: Admin help-tab styles are now enqueued instead of printed in an inline style tag.<\/li>\n
- Fixed: Removed a broken documentation link and excluded development\/test folders from the release package.<\/li>\n<\/ul>\n\n
1.2.1<\/h4>\n\n\n- Fixed: The
loupe_search_post_types<\/code> filter now applies everywhere. It was only applied when resolving the front-end search scope, so the indexer, the REST API and the WordPress Abilities kept using the raw settings value. The settings screen still shows the stored option.<\/li>\n- Fixed: Uninstalling now deletes the plugin's options and cached search results, on every site of a multisite network. Previously only the index directories were removed.<\/li>\n
- Fixed: Removed a bootstrap short-circuit that skipped plugin initialization on REST requests whose path did not start with
\/wp-json\/wp-loupe<\/code>.<\/li>\n- Fixed: The Composer package is now
soderlind\/loupe-search<\/code>, and its PSR-4 prefix is no longer over-escaped.<\/li>\n- I18n: Regenerated
loupe-search.pot<\/code>. It now includes the ability and highlighting strings added in 1.2.0, and the plugin URI no longer points at the old repository.<\/li>\n- Removed: The unused
WP_Loupe_Migration<\/code> class and WP_Loupe_Utils::is_post_indexable()<\/code>.<\/li>\n- Documentation: Added an architecture guide and a docs index, and corrected the filter, rename and migration guides.<\/li>\n<\/ul>\n\n
1.2.0<\/h4>\n\n\n- Added: REST search now supports opt-in highlighting and cropping. Send
attributesToHighlight<\/code> and\/or attributesToCrop<\/code> (field names or [\"*\"]<\/code>) to the POST \/search<\/code> endpoint; each hit then includes a _formatted<\/code> object with matched terms wrapped in tags and\/or cropped snippets. Tag\/marker and length are configurable via highlightStartTag<\/code>, highlightEndTag<\/code>, cropLength<\/code>, and cropMarker<\/code>. Highlight tags are sanitized to a safe allowlist.<\/li>\n- Changed: WordPress Abilities are now registered as
loupe-search\/search<\/code> and loupe-search\/get-post<\/code> under the loupe-search<\/code> category. The legacy wp-loupe\/search<\/code> and wp-loupe\/get-post<\/code> abilities remain registered as deprecated aliases and will be removed in a future major release.<\/li>\n<\/ul>\n\n1.1.1<\/h4>\n\n\n- Fixed: Front-end search now works when a public, searchable post type (e.g. attachments) is not indexed. Previously the plugin bailed out and fell back to WordPress's default search, returning no Loupe results.<\/li>\n<\/ul>\n\n
1.1.0<\/h4>\n\n\n- Changed: Developer filters now use the
loupe_search_*<\/code> prefix.<\/li>\n- Changed: REST namespace is now
loupe-search\/v1<\/code>; WP-CLI command is now wp loupe-search<\/code>; the index folder is now wp-content\/loupe-search-db<\/code> (existing installs keep using wp-loupe-db<\/code> if present).<\/li>\n- Deprecated: The
wp_loupe_*<\/code> filters, the wp-loupe\/v1<\/code> REST namespace, the wp wp-loupe<\/code> CLI command, and the wp-loupe-db<\/code> folder name are deprecated but still work for backward compatibility; they will be removed in a future major release.<\/li>\n<\/ul>\n\n1.0.0<\/h4>\n\n\n- Added: Redesigned settings screen with Dashboard, Fields, and Search Behavior tabs.<\/li>\n
- Added: Dashboard showing per-post-type index health, a reindex panel with a progress bar and Cancel button, and a system status check for required PHP extensions.<\/li>\n
- Added: REST endpoint
GET \/wp-json\/wp-loupe\/v1\/index-status<\/code> returning index health for configured post types.<\/li>\n- Changed: Replaced the Select2 post-type dropdown with an accessible native checkbox picker.<\/li>\n
- Changed: Field configuration for each post type is now shown in collapsible accordions.<\/li>\n
- Changed: Updated the contextual help tabs to match the redesigned settings screen and removed references to controls that no longer exist.<\/li>\n
- Removed: Select2 dependency and its bundled assets.<\/li>\n
- Removed: Auto-update settings toggle; per-plugin auto-updates are now handled by WordPress core.<\/li>\n<\/ul>\n\n
0.8.5<\/h4>\n\n\n- Added: WordPress Abilities API integration (WordPress 6.9+) registering
wp-loupe\/search<\/code> and wp-loupe\/get-post<\/code> abilities for native AI agent and automation discovery.<\/li>\n- Changed: Lowered minimum PHP requirement to 8.1; raised minimum WordPress to 6.9.<\/li>\n
- Changed: Prepared for the WordPress.org plugin directory; updates are now handled by WordPress.org.<\/li>\n
- Removed: Experimental MCP (Model Context Protocol) server, token service, and WP-CLI token commands (replaced by the WordPress Abilities API).<\/li>\n
- Removed: GitHub-based plugin updater.<\/li>\n<\/ul>\n\n
0.8.4<\/h4>\n\n\n- Changed: Updated PHP dependencies to
loupe\/loupe<\/code> 0.13.12, phpunit\/phpunit<\/code> 12.5, and pestphp\/pest<\/code> 4.5.<\/li>\n- Changed: Updated JavaScript tooling dependencies and lockfile to address open dependency advisories.<\/li>\n
- Changed: PHPUnit configuration and legacy test method names were updated for PHPUnit 12 compatibility.<\/li>\n<\/ul>\n\n
0.8.3<\/h4>\n\n\n- Fixed:
should_intercept_query()<\/code> validates all public searchable post types are indexed before intercepting generic searches.<\/li>\n- Changed: Added DocBlocks for methods in search hooks, token service, and indexer classes.<\/li>\n<\/ul>\n\n
0.8.2<\/h4>\n\n\n- Changed: Enhanced README with WP Loupe compatibility note.<\/li>\n
- Changed: Updated dev dependencies (
basic-ftp<\/code> 5.0.5 \u2192 5.2.0).<\/li>\n<\/ul>\n\n0.8.1<\/h4>\n\n\n- Fixed: Search hooks now activate for AJAX requests (e.g., live search), resolving missing results in AJAX-powered search forms.<\/li>\n
- Fixed: Pagination respects the query
posts_per_page<\/code> variable before falling back to the global option.<\/li>\n- Fixed:
should_intercept_query()<\/code> intercepts AJAX search requests, not only main queries.<\/li>\n- Changed: Search engine retrieves up to 1 000 hits per post type before client-side paging to prevent truncated result sets.<\/li>\n
- Changed: Updated PHP and JavaScript dependencies.<\/li>\n<\/ul>\n\n
0.8.0<\/h4>\n\n\n- Added: Batched reindexing to avoid admin request timeouts on large sites.<\/li>\n
- Added: Admin-only maintenance REST endpoint:
POST \/wp-json\/wp-loupe\/v1\/reindex-batch<\/code>.<\/li>\n- Added: WP-CLI command for batched reindexing:
wp wp-loupe reindex<\/code>.<\/li>\n- Added: Pest test runner (dev) alongside PHPUnit.<\/li>\n
- Changed: Reindexing is triggered via a separate admin UI button (not tied to saving settings).<\/li>\n<\/ul>\n\n
0.7.0<\/h4>\n\n\n- Added: Search API guide with hook-based field preparation examples (facets, geo, sorting).<\/li>\n
- Added: Filter
wp_loupe_is_safely_sortable_meta_{$post_type}<\/code> to override meta sortability decisions.<\/li>\n- Fixed: Geo-point meta fields are treated as sortable-safe for distance sorting.<\/li>\n<\/ul>\n\n
0.6.0<\/h4>\n\n\n- Added: Split search engine (side-effect free) from front-end hooks to avoid REST\/MCP side effects.<\/li>\n
- Added: Advanced REST search API via POST
\/wp-json\/wp-loupe\/v1\/search<\/code> (JSON filters, facets, geo, sorting).<\/li>\n- Removed: Bundled UI integration (block\/shortcode\/search form override). Build your own UI using the REST API.<\/li>\n
- Changed: Upgraded
loupe\/loupe<\/code> to 0.13.4 and tightened runtime requirements checks.<\/li>\n- Fixed: Reindexing now safely rebuilds\/migrates indexes across Loupe schema upgrades.<\/li>\n
- Fixed: Guarded against empty
wp_loupe_db_path<\/code> filter values.<\/li>\n<\/ul>\n\n0.5.7<\/h4>\n\n\n- Added: Always expose core WordPress fields (
post_title<\/code>, post_content<\/code>, post_excerpt<\/code>, post_date<\/code>, post_modified<\/code>, post_author<\/code>, permalink<\/code>) in REST field discovery and settings UI even if unchecked for indexing.<\/li>\n- Changed: Field discovery flow now starts with mandatory core fields then merges schema & meta keys for stable UI state.<\/li>\n
- Fixed: Previous changelog typo (\"dependecies\" -> \"dependencies\").<\/li>\n<\/ul>\n\n
0.5.6<\/h4>\n\n\n- Changed: Updated dependencies to latest versions<\/li>\n<\/ul>\n\n
0.5.5<\/h4>\n\n\n- Added: Settings toggle to enable or disable automatic plugin updates (defaults enabled).<\/li>\n
- Added: Schema manager unit test validating baseline
post_date<\/code> only.<\/li>\n- Added: Updated translation template with new settings strings.<\/li>\n
- Changed: Simplified baseline schema to only include mandatory
post_date<\/code>; per-post-type field settings now applied cleanly.<\/li>\n- Changed: Readme wording trimmed to reduce promotional language.<\/li>\n
- Fixed: Structural mismatch in default schema logic preventing accurate field inheritance.<\/li>\n<\/ul>\n\n
0.5.4<\/h4>\n\n\n- Added: Automatic plugin update infrastructure (filter-based) with constant opt-out.<\/li>\n
- Added: Migration ensuring mandatory
post_date<\/code> field exists after Loupe upgrade; conditional reindex strategy (immediate for small sites, scheduled for large).<\/li>\n- Fixed: Publishing\/indexing error caused by missing SQLite
post_date<\/code> column.<\/li>\n- Internal: Post-date migration triggers safe reindex path based on site size.<\/li>\n<\/ul>\n\n
0.5.3<\/h4>\n\n