Yes. Once configured, the plugin provides a complete search experience at \/opensolr-search<\/code> with faceted navigation, autocomplete, highlighting, and more.<\/p><\/dd>\nDoes it work with WooCommerce?<\/h3><\/dt>\nYes. The plugin automatically detects WooCommerce products and indexes them with prices, categories, SKUs, and structured product data.<\/p><\/dd>\n
What about multilingual sites?<\/h3><\/dt>\nThe plugin supports WPML and Polylang. When a multilingual plugin is active, search results are automatically filtered to the current language.<\/p><\/dd>\n
How does indexing work?<\/h3><\/dt>\nTwo methods: (1) The Web Crawler fetches your pages from the sitemap and indexes the content. (2) Data Ingestion pushes content directly from WordPress to Solr, with real-time sync on post save\/delete and bulk async ingestion.<\/p><\/dd>\n
Where are search queries processed?<\/h3><\/dt>\nAll search queries are sent directly from the visitor's browser to the Opensolr cloud infrastructure. This means zero search load on your WordPress server.<\/p><\/dd>\n
Can I opt out of click\/query tracking?<\/h3><\/dt>\nYes. The Analytics toggle in the plugin settings disables all query and click logging. With Analytics disabled, nothing is written to the plugin's local analytics tables. IP addresses are always SHA-256 hashed before storage regardless of this setting \u2014 raw IPs are never stored.<\/p><\/dd>\n\n<\/dl>\n\n\n
1.0.21<\/h4>\n\n\n- Fix: File \/ Document \/ Audio \/ Video media mappings now emit a real public\nURL instead of the bare attachment ID. Previous versions only resolved\nIMAGE attachments \u2014 mapping a PDF \/ DOCX \/ MP4 \/ MP3 attachment ID through\nFacet Mapping silently kept the integer in Solr. Now any image, video,\naudio, or known document MIME (PDF \/ DOC \/ DOCX \/ XLS \/ XLSX \/ PPT \/ PPTX\n\/ ODT \/ ODS \/ TXT) auto-resolves to its public URL.<\/li>\n
- Fix: ACF \"Image Array\" \/ \"File Array\" return format no longer pollutes\nSolr with a mix of id + alt + title + url + width + height. The flatten\npass now detects the ACF attachment shape and emits ONE value per row \u2014\nthe
url<\/code> if present, otherwise the ID<\/code> (which then resolves through the\nnormal attachment-URL pipeline). Single-mode AND multi-mode mappings both\nproduce clean URL values.<\/li>\n- Fix: Values that are already URLs (
http:\/\/\u2026<\/code> \/ https:\/\/\u2026<\/code>) pass through\nunchanged \u2014 covers ACF \"Return Format = URL\" + hand-rolled custom-field\npatterns. Previously the resolver only fired on numeric IDs, leaving\neverything else as-is, which was already correct for URLs but is now\ndocumented and explicit.<\/li>\n<\/ul>\n\n1.0.20<\/h4>\n\n\n- New: Date-range quick presets on facet sidebar \u2014 every date_range facet\nnow renders three pill buttons (Today \/ Last Week \/ Last Month) above the\nFrom\/To inputs. One click fills both dates and submits the facet form \u2014 no\nmore opening the native date picker twice for common queries. Uses LOCAL\ndate components (not toISOString) so \"Today\" stays today in every timezone.<\/li>\n
- New: Data Ingestion tab \u2014 live \"Total: N documents\" tally and dynamic\nper-type counts. Check or uncheck a content type and the number next to\nthat type flips between its real count and 0, with the grand total at the\nbottom of the fieldset updating instantly. Mirrors the Drupal module's\ningestion UX. Include attached files toggle also contributes to the total.<\/li>\n<\/ul>\n\n
1.0.19<\/h4>\n\n
First public release since 1.0.14. Rolls up every intermediate deploy.\n* New: Facet Mapping form now matches the Drupal module \u2014 Solr Field\n Name + Solr Type dropdown + Display Label. Pick a WP field and the\n Solr Type auto-fills from the detected suffix; stem auto-fills from\n the WP field name. Type hints shown next to every entry in the\n WordPress Field dropdown (post_tag \u2192 multi, string; price \u2192 single,\n float; etc.).\n* New: WordPress Field dropdown shows every indexable source, not just\n a handful of postmeta keys. Core post columns (post_title,\n post_content, post_excerpt, post_date, post_status, post_type,\n post_author), ALL postmeta (underscore-prefixed included \u2014\n _price\/_sku\/_stock\/_thumbnail_id are now mappable), register_meta()\n keys, every public taxonomy, all pa<\/em>* WooCommerce attribute\n taxonomies, plus synthetic featured_image_url and gallery_image_urls.\n* New: Core post columns and WC synthetic aggregates resolve end-to-end\n in both ingestion and tag emission.\n* Fix: Facet Mapping saves no longer silently drop every row. The\n sanitize callback hooked via register_setting() expected the legacy\n flat scalar shape and called is_scalar($dst) on each value \u2014 every\n row in the new rich {wp_field, meta_name, field_type, label,\n solr_field} shape was failing the check and being stripped under\n sanitize_option_opensolr_settings. Callback now accepts both shapes.\n* Fix: Multi-valued mappings stored as serialized arrays in a single\n postmeta row (ACF Checkbox \/ Select multi \/ Relationship \/ Gallery\n fields, WooCommerce attributes) now emit one per value and\n serialize as Solr arrays. Both emission and ingestion paths flatten\n across both WP storage patterns (multi-row AND single-row-with-array).\n* Fix: Admin scripts self-invalidate on every deploy via filemtime()\n cache-busting. Previously OPENSOLR_VERSION-based cache-busting meant\n every intermediate fix shipped to disk without browsers refetching.\n* Fix: Facet Mapping table always renders at least one empty row so\n the admin has a visible slot to click into.\n* Fix: + Add Field Mapping button no longer collides with the\n placeholder row's index.\n* Fix: Backend stem fallback \u2014 save handler derives the Solr Field\n Name from the WP field name when left empty, preventing silent row\n drops on incomplete input.<\/p>\n\n1.0.14<\/h4>\n\n\n- Fix: image-field Facet Mappings now emit a real image URL. Previously,\nmapping a meta key that stores an attachment ID (ACF image field\nreturning \"ID\",
_thumbnail_id<\/code>, custom image_attachment_id, etc.) to\na Solr field emitted the bare integer as the meta content \u2014 useless\nas an image source. Both ingestion and meta-tag emission now\nauto-resolve numeric values to wp_get_attachment_url()<\/code> when the ID\npoints at a valid image attachment. SKU, price, and other numeric\nfields are untouched (guarded by wp_attachment_is_image()<\/code>).<\/li>\n<\/ul>\n\n1.0.13<\/h4>\n\n\n- Fix: Persistent Filters \"Exclude\" mode was silently saved as \"Include\".\nThe register_setting() sanitize callback used a
op: include\/exclude<\/code>\nshape that didn't match the mode: +\/-<\/code> shape the admin form writes\nand the query builder reads, so any -<\/code> (Exclude) selection was\noverwritten with the default on save. Existing stuck filters need to\nbe re-saved after upgrading to pick up the correct mode.<\/li>\n<\/ul>\n\n1.0.12<\/h4>\n\n\n- New: combobox autocomplete on \"Solr field for result image\" in Search\nDisplay. Focusing the input drops down the full alphabetical list of\nSolr fields indexed on your site (from the Luke handler); typing\nfilters by case-insensitive substring match. Keyboard navigation\n(arrows + Enter) and mouse picking supported. New admin-only REST\nendpoint
\/opensolr\/v1\/luke-fields<\/code> with a manage_options<\/code>\npermission_callback feeds the list. JS and CSS enqueued via\n wp_enqueue_script \/ wp_enqueue_style<\/code> (no inline tags); URL and\nnonce passed via wp_localize_script<\/code>; all output escaped; DOM-based\nrendering avoids innerHTML. Plain typing still works for field names\nthat aren't indexed yet.<\/li>\n<\/ul>\n\n1.0.11<\/h4>\n\n\n- New: \"Solr field for result image\" input in Search Display settings.\nDefault
og_image<\/code>. Lets admins point result thumbnails at any\nsingle-valued Solr field they've mapped through Facet Mapping\n(WordPress post meta, WooCommerce gallery, custom URL field, etc.).\nApplies to the search results page, the AI Reader modal, and the\nAI Reader metadata endpoint. Multi-valued sources normalized to the\nfirst element. Empty or non-alphanumeric input falls back to og_image.<\/li>\n<\/ul>\n\n1.0.10<\/h4>\n\n\n- Fixed: Facet Mapping entries targeting multi-valued Solr fields\n(
_sm<\/code>\/_fm<\/code>\/_im<\/code>\/_dtm<\/code>) now work correctly with both the Web Crawler\nand Data Ingestion paths. Previously the ingest path was broken entirely\nfor field mappings (reading config keys the admin UI never wrote), and\nthe meta-tag emission concatenated array values into a single\ncomma-joined string. Now:\n\n\n- Ingest parses the suffix out of
solr_field<\/code> to determine multi vs\nsingle, and writes arrays directly to Solr.<\/li>\n- Meta-tag emission writes one
<meta property=\"opensolr:X_sm\"><\/code> tag\nper value so the Opensolr crawler can aggregate them back into an\narray (DOM order preserved).<\/li>\n- Hardcoded emissions for
product_images_sm<\/code> and variable product\nattribute *_sm<\/code> fields updated to the same repeated-tag pattern.\nPairs with a crawler update that aggregates repeated opensolr:*<\/code> tags.<\/li>\n<\/ul><\/li>\n<\/ul>\n\n1.0.9<\/h4>\n\n\n- Security: register_setting() sanitize_callback now applies per-field\nsanitization (sanitize_text_field, sanitize_email, absint, float clamping,\nstrict enum allowlists, recursive array sanitization for facets \/ filters \/\ncontent type lists). Previous callback only merged input, relying on\ncaller-side sanitization.<\/li>\n
- Security: REST \/queue-stats endpoint now requires manage_options. The\nendpoint feeds the Data Crawler admin UI (live preview counts for arbitrary\ncontent-type overrides), so it's an admin-configuration surface and should\nnot be public.<\/li>\n
- Compliance: JSON-LD structured-data blocks (WebSite SearchAction, Article,\nBreadcrumbList) now output via wp_print_inline_script_tag() instead of\nechoing raw tags. Same XSS protection (JSON_HEX_TAG | JSON_HEX_AMP\nprevents script breakout) \u2014 just routed through WordPress's official helper.<\/li>\n
- Dependency: Chart.js bundled library updated from 4.5.0 to 4.5.1.<\/li>\n<\/ul>\n\n
1.0.7<\/h4>\n\n\n- New: Lexical Only search mode in Search Tuning \u2192 Search Mode. Explicit\nopt-out from vector \u2014 no embedding API call is made, search runs straight\nthrough the lexical edismax path. Useful for deterministic BM25 ranking,\navoiding embed API latency, or users on plans without vector who want\nexplicit control instead of the implicit server-side fallback.<\/li>\n
- New: When Lexical Only is selected, the Minimum Relevance Score slider\nauto-zeros itself. That threshold is calibrated for the combined hybrid\nscore and would filter out every result in pure lexical mode. Backend\nforces the value to 0 on save and at query time; JS zeroes the slider\nlive the moment the radio is picked. A yellow note explains the coupling.<\/li>\n
- Change: Lexical-only fallback now uses defType=edismax + raw q (idiomatic\nSolr style) instead of q={!bool should=$lexicalQuery}. Same behavior,\ncleaner in the Query Inspector, matches the opensolr search_lexical()\nmethod for cross-platform consistency.<\/li>\n
- Change: Plugin version bumped so browsers pick up the new admin-ui JS\nhandler for the bool_mode radios.<\/li>\n<\/ul>\n\n
1.0.5<\/h4>\n\n\n- New: Minimum Relevance Score slider in Search Tuning. Drops results whose\ncombined {!bool}(lexical + vector) score falls below the threshold, cleaning\nnoise from facet counts and result totals. Applied as a Solr frange\npost-filter on the hybrid score. Needed because the {!func}-wrapped lexical\nside of the {!bool} matches every doc (score 0 for non-lexical hits) and\nKNN topK returns N candidates regardless of cosine similarity \u2014 without this\nfilter numFound balloons to the entire base filter set and facet counts get\npolluted. Default 0.3; legitimate matches easily clear it. Slider moves in\n0.1 increments, 0 disables the filter.<\/li>\n
- Change: Plugin version bumped so browsers pick up the new admin-ui JS.\nWithout the bump, cached old JS had no listener for the new slider and its\nlive label wouldn't update while dragging.<\/li>\n<\/ul>\n\n
1.0.4<\/h4>\n\n\n- Improvement: The Semantic \u2194 Lexical Balance slider is now a true balance dial.\nPreviously it just scaled the qf\/pf field-weight boosts linearly (same effect\nas lowering the weights themselves). The lexical score is now reshaped via\npow(BM25 + 1, lexical_weight) - 1, so the slider changes the SHAPE of the\nlexical contribution curve, not just its magnitude:\n\n
\n- 1.0 = linear (full BM25, named entities dominate)<\/li>\n
- 0.5 = sqrt-like compression (balanced, new default)<\/li>\n
- 0.2 = heavy compression (vector takes over)<\/li>\n
- 0.1 = lexical almost off<\/li>\n<\/ul><\/li>\n
- Change: Default Title field weight raised from 0.03 to 0.1 and default\nSemantic \u2194 Lexical Balance raised from 0.20 to 0.50. These defaults work\nbetter with the new pow reshape across a wide range of corpora.<\/li>\n
- Removed: Misleading \"field weights are automatically overridden to 0\"\nbanner in Search Tuning \u2014 no longer applies after the hybrid ranking fix\nin 1.0.3.<\/li>\n<\/ul>\n\n
1.0.3<\/h4>\n\n\n- Fix: Hybrid search ranking ignored query keywords. In vector hybrid mode the\nlexical qf was hardcoded to zero, so proper nouns, product names and other\nspecific terms contributed nothing to scoring \u2014 results were ranked purely\non semantic similarity, which pushed near-duplicate neighbours ahead of exact\nmatches. Field weights from Search Tuning now apply alongside the KNN vector\nscore as designed.<\/li>\n<\/ul>\n\n
1.0.2<\/h4>\n\n\n- Fix: Filters button on mobile search page now toggles the facet sidebar\n(class-name mismatch between template, CSS and JS \u2014 JS was listening on\nthe old selectors left over from an earlier refactor).<\/li>\n<\/ul>\n\n
1.0.1<\/h4>\n\n\n- Plugin-review compliance pass (no functional changes):<\/li>\n
- Moved all inline
<script><\/code> and <style><\/code> blocks into enqueued .js<\/code> and .css<\/code> files (wp_enqueue_script \/ wp_enqueue_style \/ wp_localize_script)<\/li>\n- Refactored all $wpdb->prepare() calls to inline placeholders (fixes Plugin Check InterpolatedNotPrepared + UnfinishedPrepare warnings)<\/li>\n
- Tightened JSON-LD output escaping: JSON_HEX_TAG | JSON_HEX_AMP to prevent any possible breakout<\/li>\n
- esc_url_raw \u2192 esc_url wherever a URL is written into an output context<\/li>\n
- Added opt-out for local analytics logging (Search Display \u2192 Analytics toggle)<\/li>\n
- Documented every external service, endpoint and data flow in the \"External services\" section above<\/li>\n
- Updated bundled libraries: Chart.js 4.5.0, marked 15.0.12, SortableJS 1.15.6<\/li>\n<\/ul>\n\n
1.0.0<\/h4>\n\n\n- Initial release<\/li>\n
- Hybrid vector + keyword search<\/li>\n
- Faceted navigation with list, slider, date range, and hierarchical widgets<\/li>\n
- AI Hints and AI Reader streaming<\/li>\n
- Autocomplete with query suggestions<\/li>\n
- WooCommerce product support<\/li>\n
- Web Crawler and Data Ingestion indexing<\/li>\n
- Search analytics with CTR tracking<\/li>\n
- Query Elevation (pin\/exclude results)<\/li>\n
- Persistent admin filters<\/li>\n
- Multilingual support (WPML, Polylang)<\/li>\n
- Dark theme<\/li>\n
- Embeddable search widget mode<\/li>\n
- Meta tag and JSON-LD injection for SEO<\/li>\n
- XML sitemap generation<\/li>\n<\/ul>","raw_excerpt":"Powerful hybrid vector + keyword search powered by Opensolr. AI-powered search, faceted navigation, autocomplete, analytics, and WooCommerce support.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/300315","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=300315"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/opensolr"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=300315"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=300315"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=300315"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=300315"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=300315"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=300315"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}