Opensolr Changelog — Recent Updates & Improvements

Drupal Module Apr 24, 2026

Fix Drupal Facet Mapping Saves Apply Instantly via Render Cache Tag Invalidation
Saving a new Facet Mapping now takes effect immediately — no drush cr required. Render cache tags are invalidated on save so every cached node and commerce product page re-renders with the newly-mapped opensolr:* meta tags on next view.

Fix WordPress Plugin Fix: Sanitize Callback No Longer Strips Saved Facet Mappings
Facet Mapping saves persist correctly. A legacy sanitize callback in the WordPress plugin was silently stripping every saved row under the sanitize_option_opensolr_settings filter — saves looked successful but the data never made it to the database. Fixed: the callback now handles the new rich mapping shape AND auto-promotes any legacy rows on first save.

Fix Image and File Facet Mappings Now Emit Real URLs Instead of Attachment IDs
Image and File field mappings now emit a real URL instead of the bare attachment ID. Mapping a Drupal field_image or a WordPress meta that stores an attachment ID (ACF image field with Return Format = ID, _thumbnail_id, custom image_attachment_id) now resolves to a working public URL. Guarded against numeric SKU/price fields being silently rewritten.
Fix Multi-Valued Facet Mappings Fixed: Crawler and Ingestion Now Produce Identical Documents
Multi-valued field mappings work correctly end-to-end. Drupal taxonomy terms, ACF Checkbox/Select-multiple/Relationship/Gallery arrays, and WooCommerce attributes (all stored differently — multi-row vs serialized-array) now all emit as one <meta property="opensolr:X_sm"> tag per value. The Web Crawler aggregates repeated tags into a Solr array, matching what real-time ingestion already writes — so crawler and ingestion produce identical documents.

Fix Search Page Fix: showPicker SecurityError in Cross-Origin Iframes Silently Handled
Fixed a JavaScript SecurityError thrown when the Opensolr search page is embedded inside a cross-origin iframe. Browsers block showPicker() calls from cross-origin frames; the call is now wrapped in a try/catch so the browser restriction is silently handled instead of surfacing as an uncaught exception that could disrupt other search functionality on the host page.
Fix Four Search Parameter Fixes: Wildcard Highlighting, hl.q, Stats and Currency Facets
Fixed four search parameter bugs across all platforms. (1) Wildcard searches (*:*) no longer send any highlighting parameters to Solr — highlighting on a catch-all query is meaningless and wastes server cycles. (2) The Solr highlight query (hl.q) was incorrectly set to *:* instead of the real search terms, so highlighted snippets never matched actual keywords. (3) A hardcoded stats=true / stats.field=price_f block was attached to every query even for non-commerce indexes. (4) currency_s was hardcoded into the facet field list regardless of whether the index has that field. All four are fixed in Opensolr, the Drupal module, and the WordPress plugin.

Fix Custom Minimum Match Values No Longer Truncated by the XSS Filter
Fixed custom Minimum Match values not saving. Values containing the less-than character (e.g. 2<95% 5<90% 8<80%) were silently truncated to just the first number because the global XSS filter stripped the < before the value reached the save handler. The tuning form now reads the raw request body for this field — custom mm presets save and apply correctly.

Fix WordPress Plugin: Sitemap Registration Fix, Setup Progress Modal, WooCommerce Meta Tags
Fixed WordPress plugin Save & Connect not registering the sitemap URL with the crawler, and Save & Start Fresh not deleting the previous index. Also added full-screen progress modal with step-by-step status and error reporting during setup, and improved product meta tag injection for WooCommerce (BreadcrumbList, price, currency, product categories).

Fix Opensolr Search for Drupal 3.3.3: Sitemap Registration on Save and Connect Fixed
Fixed Drupal module Save & Connect not registering the sitemap URL with the crawler. The sitemap is now registered on every Save & Connect and Save & Start Fresh. Also fixed Save & Start Fresh not deleting the previous index before creating a new one. Released as 3.3.3.

Fix Data Ingestion API Fix: PHP 8 Issue Caused Empty Responses on All Endpoints
Fixed Data Ingestion API endpoints returning empty responses. A PHP 8 compatibility issue in the API layer caused all ingestion, embedding, and AI endpoints to silently fail. Restored full functionality for ingest, embed, ai_summary, and all related API calls.

Fix Query Elevation Controls Restored on the Hosted Search Page With Instant Effect
Fixed Query Elevation controls not appearing on the hosted search page. Token-based authentication now accounts for CAPTCHA verification time, and elevation settings take effect immediately after toggling (previously required up to 10 minutes due to caching).

Fix Drupal Query Elevation: Remove Button No Longer Shows Without Elevation Rules
Fixed Query Elevation REMOVE button appearing on results with no elevation rules. Visibility now controlled via CSS class specificity instead of inline styles, fixing conflicts between button display and hide states.

Fix Duplicate Document Fix: URI Normalization Unifies Web Crawler and Data Ingestion IDs
Fixed duplicate documents when using both Web Crawler and Data Ingestion on the same index. URIs are now normalized (trailing slash stripped) before computing the document ID, so both methods produce the same document instead of duplicates.

Fix Drupal Module Safari and iOS Fixes: Show-More Buttons, Slider Loading, and Z-Index
Safari and iOS compatibility — fixed show-more buttons, async noUiSlider loading, expand dialog z-index above Drupal toolbar, mobile overflow handling. Show-more dialogs now use event delegation for reliable touch behavior.

Fix Web Crawler Date Indexing Fix: Timezone Offsets Now Strictly Converted to UTC
Fixed date indexing errors caused by timezone offsets (e.g. +03:00) in date fields. All dates are now strictly converted to UTC before sending to Solr. Added a final safety gate — any date that doesn't match the exact Solr format is dropped rather than causing an indexing error.

Fix More Reliable Search Highlighter Fixes Keyword Highlighting in Short Title Fields
Fixed search result highlighting — switched to a more reliable highlighter that correctly highlights keywords in short fields like titles. Also added text_t (structured text) to highlighted fields for richer snippets.