README

Search Manager for Craft CMS

Advanced multi-backend search management for Craft CMS with BM25 ranking, analytics, caching, query rules, promotions, and a frontend search widget.

License

This is a commercial plugin licensed under the Craft License. It will be available on the Craft Plugin Store soon. See LICENSE.md for details.

⚠️ Pre-Release

This plugin is in active development and not yet available on the Craft Plugin Store. Features and APIs may change before the initial public release.

Features

• 7 Search Backends — MySQL, PostgreSQL, Redis, File (built-in), plus Algolia, Meilisearch, Typesense
• BM25 Ranking — Industry-standard relevance scoring with configurable parameters
• Search Operators — Phrase search, NOT, wildcards, field-specific, per-term boosting, boolean operators
• Fuzzy Matching — Typo tolerance with n-gram similarity
• Multi-Language — Stop words and localized boolean operators in 12 languages (EN, PT, IT, ES, FR, NO, NL, SV, DE, DA, JA, AR)
• Highlighting & Snippets — Highlight matched terms and show contextual excerpts
• Autocomplete — Search-as-you-type suggestions with separate caching
• Query Rules — Synonyms, section/category/element boosting, filtering, redirects
• Promotions — Pin elements to fixed positions in search results
• Analytics — Track queries, devices, geo-location, performance, content gaps
• Caching — Multi-layer caching with cache warming after rebuilds
• Frontend Widget — CMD+K search modal (WCAG 2.1 AA, keyboard navigation, theming)
• Native Search Replacement — Optionally replace Craft's built-in search
• REST API — Search and autocomplete endpoints for headless/mobile apps
• Pending Syncs CP — Operator surface for the L3 sync buffer: triage failures, retry, purge, and watch the queue drain live from the Control Panel
• API Keys — Generate scoped keys (per-index, per-referrer, expiry, hit caps, rate limits) for the public search, autocomplete, and analytics tracking endpoints. Plaintext shown once; only the HMAC-SHA256 hash is stored. Enable Require API Key to enforce keys via the X-Search-Manager-Key header; per-key rate limiting returns 429 when a key exceeds its search/autocomplete requests-per-minute cap
• Privacy-First — IP hashing, subnet masking, async geo-lookup, GDPR-friendly

Requirements

• Craft CMS 5.0+
• PHP 8.2+
• Logging Library 5.0+ — optional, install in CP for logs

Installation

Via Composer

composer require lindemannrock/craft-search-manager

php craft plugin/install search-manager

php craft search-manager/security/generate-salt

Using DDEV

ddev composer require lindemannrock/craft-search-manager

ddev craft plugin/install search-manager

ddev craft search-manager/security/generate-salt

Documentation

Full documentation is available in the docs folder.

Support

• Issues: GitHub Issues
• Email: support@lindemannrock.com

License

This plugin is licensed under the Craft License. See LICENSE.md for details.

Developed by LindemannRock