Lumenare Search

Opis

Lumenare Search transforms your WordPress site’s search functionality with a powerful, fast, and user-friendly search experience. Built with performance and security in mind, it provides instant live search results, intelligent keyword matching, and comprehensive filtering options.

Key Features

  • Instant Live Search: Real-time search results appear as users type, with a dropdown showing the most relevant results
  • Predictive Keywords: Intelligent keyword suggestions based on your indexed content
  • Custom Search Index: Fast database-driven search using weighted keywords extracted from titles, excerpts, and content
  • Keyword Match Modes: Choose between matching ANY keyword (OR) for broader results or ALL keywords (AND) for precision
  • Stop Words Configuration: Exclude common words from indexing to improve relevance and performance
  • Synonyms Support: Define equivalent terms to expand search coverage and improve recall
  • Fuzzy Matching: Find results even with misspellings using configurable Levenshtein distance
  • Phrase Boosting: Boost relevance for specific phrases defined in settings
  • Filterable Results: Filter search results by categories and date ranges
  • Search Term Highlighting: Visually highlights matching terms in titles and excerpts
  • Multiple Integration Points: Replaces default WordPress search, shortcode support, and widget
  • Gutenberg Integration: Automatically replaces Gutenberg Search blocks with enhanced search
  • Security Filtering: Built-in protection against SQL injection and code injection attempts
  • Autocorrect Prevention: Disable browser/device autocorrect to preserve technical terms and brand names

How It Works

Lumenare Search creates a custom database table to store keyword indexes for fast searching. When content is published or updated, keywords are extracted from:
* Post titles (weight: 3 – highest relevance)
* Post excerpts (weight: 2 – medium relevance)
* Post content (weight: 1 – base relevance)

The plugin automatically indexes your content and keeps the index up-to-date as you publish or update posts. Search queries are processed through the custom index for fast, relevant results.

Keyword Match Modes

Match ANY (OR) – Default
* Returns results containing at least one of the search keywords
* Best for: Broad topic searches, exploratory queries, maximizing results
* Example: „Sega Master System” finds posts with „Sega” OR „Master” OR „System”

Match ALL (AND) – Precision
* Returns only results containing ALL search keywords
* Best for: Product names, specific phrases, technical queries
* Example: „Sega Master System” finds only posts with „Sega” AND „Master” AND „System”

Advanced Features

  • Stop Words: Configure which common words to exclude from indexing (e.g., „a”, „an”, „the”)
  • Synonyms: Define groups of equivalent words (e.g., „car, automobile, vehicle”)
  • Fuzzy Matching: Typo-tolerant search with configurable threshold (1-5 character differences)
  • Phrase Boosting: Define important phrases that receive relevance boosts when searched
  • Security Filtering: Automatic filtering of dangerous characters and patterns
  • Security Logging: Track filtered queries for security monitoring

Zrzuty ekranu

  • Basic search quality settings
  • Search phrase prioritization and fuzzy matching (typo-tolerance) tuning
  • Dynamic ranking feature tuning
  • Additional dynamic ranking feature tuning parameters
  • Customizing the live results box and the search results page
  • Enabling search results filters
  • Advanced search behavior configuration including autocorrect disable
  • Additional advanced plugin configuration settings for additional security
  • Search analytics tracking
  • Block-based (Twenty-Twenty Five) theme compatibility demonstration
  • „Classic”, non-block-based theme compatibility demonstration (Bootscore theme)

Bloki

Wtyczka dodaje 1 blok.

  • Lumenare Search A powerful search block with live results and fuzzy matching.

Instalacja

  1. Upload the lumenare-search folder to the /wp-content/plugins/ directory
  2. Run composer dump-autoload in the plugin directory (if Composer is available)
  3. Activate the plugin through the 'Plugins’ menu in WordPress
  4. Go to Settings > Lumenare Search to configure the plugin
  5. Click „Reindex All Content” to build the initial search index

First-Time Setup

After activation, the plugin will automatically start indexing your content. For best results, especially if you have existing content:

  1. Go to Settings > Lumenare Search
  2. Navigate to the „Index Management” tab
  3. Click „Reindex All Content” to build a complete index of all published posts

The indexing process runs in batches to avoid performance issues on large sites.

Najczęściej zadawane pytania

Does this replace WordPress’s default search?

Yes. Lumenare Search automatically replaces the default WordPress search form site-wide, including traditional search forms, Gutenberg Search blocks, and theme search forms.

Do I need to reindex after changing settings?

Most settings (like match mode, synonyms, fuzzy matching) work immediately without reindexing. However, if you change stop words or post types to search, you should reindex to apply those changes.

How does the search index work?

The plugin creates a custom database table that stores keywords extracted from your content. Keywords are weighted by location: titles get weight 3, excerpts get weight 2, and content gets weight 1. This weighting system ensures that matches in titles rank higher than matches in content.

What are stop words and why should I configure them?

Stop words are common words (like „a”, „an”, „the”, „is”, „are”) that don’t add meaningful search value. Excluding them from the index reduces index size, improves search speed, and focuses results on meaningful content words.

How do synonyms work?

Synonyms allow you to define groups of equivalent words. When a user searches for any word in a group, results containing any synonym from that group will also be found. For example, if you define „car, automobile, vehicle” as synonyms, searching for „car” will also find posts with „automobile” or „vehicle”.

What is fuzzy matching?

Fuzzy matching allows users to find results even with misspellings. For example, searching „computr” will match „computer”. The threshold setting (1-5) controls how many character differences are allowed. Higher thresholds are more permissive but may return less relevant results.

Can I use this with custom post types?

Yes. In Settings > Lumenare Search > General Settings, you can select which post types to include in search results. The plugin supports posts, pages, and any custom post types that are publicly queryable.

How do I add the search form to my theme?

The plugin automatically replaces default WordPress search forms. You can also:
* Use the shortcode: [lumenare_search]
* Add the „Lumenare Search” widget to any widget area
* Use get_search_form() in your theme templates

Is this plugin secure?

Yes. The plugin follows WordPress security best practices:
* All user input is sanitized and validated
* SQL queries use prepared statements
* AJAX requests are protected with nonce verification
* Built-in security filtering protects against SQL injection and code injection
* All output is properly escaped

Does this work with caching plugins?

The live search dropdown uses AJAX requests that bypass most caching. The full search results page can be cached normally. If you use page caching, the search form and dropdown will still work correctly.

What happens to my search index when I deactivate the plugin?

The search index table remains in your database when you deactivate the plugin. When you reactivate, the index will still be there. The index is only removed when you uninstall the plugin.

Recenzje

Wtyczka nie ma jeszcze żadnej recenzji.

Kontrybutorzy i deweloperzy

„Lumenare Search” jest oprogramowaniem open source. Poniższe osoby miały wkład w rozwój wtyczki.

Zaangażowani

Rejestr zmian

1.1.3

  • Fixed core/search block parameters not applying on frontend
  • Added match quality boosting: exact keyword matches score 3x, prefix matches 2x, substring matches 1x
  • Fixed search term highlighting for prefix matches (e.g., „word” now highlights inside „WordPress”)
  • Fixed garbage keyword suggestions caused by HTML elements concatenating during content cleaning
  • Added keyword length filtering to prevent long concatenated tokens from appearing in suggestions
  • Note: A full reindex is recommended after upgrading to clean up any existing malformed keywords

1.1.21

  • Fixed bug where database schema upgrades only ran on plugin activation, not on file updates
  • Note: After upgrading, a full reindex is required to rebuild the search index

1.1.2

  • Added live search results caching – clicking back into search input re-displays cached results without new AJAX request
  • Added modern Gutenberg block with 4 variations (Default, Compact, Expanded, Icon Toggle) replacing legacy widget
  • Added block editor InspectorControls for configuring search appearance
  • Added expandable icon-only search variation for minimal UI footprint
  • Fixed fuzzy search now finds misspelled words regardless of starting letter (prioritized candidate retrieval)
  • Improved ARIA accessibility attributes for search dropdown elements

1.1.1

  • Added canonical keyword storage to preserve original capitalization from content
  • Improved keyword suggestions with proper spacing and capitalization
  • Added URL component filtering to prevent indexing raw URLs.
  • Generic word boundary detection that works across different sites and content types
  • Note: Reindexing recommended after upgrade to populate canonical keywords and remove URL components

1.1.0

  • Improve admin ability to fine-tune search results
  • Add analytics and search query tracking feature

1.0.2

  • Improve compatibility with non-block themes

1.0.1

  • Add option to show search icon
  • Strip shortcodes, HTML and other block editor patterns from search index, queries and results

1.0.0

  • Initial release
  • Live search with dropdown results
  • Keyword indexing system with weighted relevance (title: 3, excerpt: 2, content: 1)
  • Category and date filtering
  • Widget and shortcode support
  • Admin settings panel with comprehensive options
  • Keyword match mode – Choose between ANY (OR) or ALL (AND) keyword matching
  • Configurable stop words for noise reduction and improved relevance
  • Configurable synonyms for expanded search coverage
  • Fuzzy matching (typo tolerance) with configurable Levenshtein distance threshold
  • Autocorrect prevention to preserve technical terms and brand names
  • Search term highlighting with context-aware excerpt extraction
  • Phrase boosting for defined important phrases
  • Gutenberg Search block integration (automatic replacement)
  • Security filtering and logging
  • Full WordPress coding standards compliance
  • PSR-4 autoloading architecture
  • Secure: nonce verification, input sanitization, output escaping, prepared SQL