Changelog

Categories: Security, Feature, Fix, Perf, Admin, Deps.

[2.2.1] - 2026-08-10

Fix

• Category pages no longer all return the same products: cached listings are keyed per category, filter set and customer group.
• Layered navigation filters and product ranking now survive a cache hit instead of coming back empty.
• Cached results are cleared when the catalog is reindexed, a product changes or a category is saved — no more stale listings until the cache expires.
• Products are no longer left behind in the index when a deletion and an update overlap.

Perf

• Full page cache restored across the whole storefront: a search block was disabling it on every frontend page, not just on search and category pages.
• Search no longer writes a log line per request, which filled log files on busy catalogs.

[2.1.2] - 2026-08-07

Deps

• PHP 8.5 certified — constraint widened to >=8.1 <8.6.

[2.1.1] - 2026-07-09

Fix

• Installation no longer fails during setup:di:compile: three catalog attribute mappers still carried an outdated signature.

[2.1.0] - 2026-07-08

Feature

• Layered navigation now works with Meilisearch: every "filterable in navigation" dropdown attribute is indexed so its facet returns the matching products.

[2.0.0] - 2026-07-07

Feature

• Compatible with Magento / Mage-OS 2.4.9 through walkwizus 1.0.70 and the Meilisearch PHP v2 SDK.

Fix

• Indexing writes documents again: a full reindex used to report success while pushing nothing to Meilisearch.
• Category and search pages return products again instead of coming back empty.
• Price-per-customer-group and category indexing overrides apply again after the upstream code was relocated.

Deps

• Requires walkwizus/magento2-module-meilisearch ^1.0.70 and meilisearch/meilisearch-php ^2.0.0-beta.6. The Meilisearch SDK v2 is still pre-release, so the consuming project must allow its beta stability.

[1.12.8] - 2026-06-30

Fix

• Category pages always show their products: when a category's position sort is missing from the search index, the proxy automatically retries without it instead of returning an empty page.

[1.12.7] - 2026-06-29

Fix

• Accents now display correctly in autocomplete and search results: the search proxy decodes leftover HTML entities (such as é for é) in indexed text — no reindex needed.

[1.12.6] - 2026-06-24

Fix

• Products kept available by a manual stock override or a backorder are no longer indexed as out of stock.

[1.12.5] - 2026-06-05

Deps

• PHP 8.4 deprecation cleanup — explicit-nullable params across constructors. No behavior change.

[1.12.4] - 2026-06-05

Deps

• Marketing documentation refreshed to list PHP 8.4 in the supported PHP range.

[1.12.3] - 2026-06-05

Deps

• PHP 8.4 certified — constraint widened to >=8.1 <8.5.

[1.12.2] - 2026-05-28

Fix

• Adapter no longer crashes when Meilisearch returns a facet that isn't marked as filterable — it falls back to a safe empty result instead of throwing.

[1.12.1] - 2026-05-28

Fix

• Autocomplete prices respect customer VAT settings again. calculateDisplayPrice reapplies the tax-inclusive / tax-exclusive rule per customer, so the price shown in the autocomplete matches the cart and product page.

[1.12.0] - 2026-05-28

Fix

• Bundle product prices in autocomplete and search now match the storefront. The price mapper computes the rendered bundle price (option selections + price view) instead of only the base price.

[1.11.0] - 2026-05-28

Fix

• Bundle products whose description is stored as an array no longer cause "Array to string conversion" warnings during reindex — the description truncate helper handles both shapes.

[1.10.34] - 2026-05-27

Feature

• Autocomplete now exposes hasSearchedTerm, noResults and showAutocomplete Knockout observables, so themes can render a real "no results" state and keep the autocomplete container visible while loading.

[1.10.33] - 2026-05-12

Admin

• Admin dashboard widget code extracted to companion module wimakeit/module-meilisearch-engine-admin-dashboard. The main module is now installable on stores that don't use wimakeit/module-admin-dashboard.

Deps

• To keep the Meilisearch indexer/health widget on the admin dashboard, install wimakeit/module-meilisearch-engine-admin-dashboard alongside this module.

[1.10.32] - 2026-05-11

Feature

• wmi_stock_status is now part of the partial-sync field map — stock status changes propagate to Meilisearch incrementally instead of waiting for a full reindex.

[1.10.31] - 2026-05-10

Feature

• New Enable Debug Logging toggle (Stores → Configuration → Wimakeit → Meilisearch Engine → General), off by default. 9 hot paths (reindex queue cron, task cleanup, cache observer, multisearch controller, searchable updater, search cache, sync state, search adapter, partial sync) emit info/debug/notice/warning only when the toggle is on; error/critical always log.

Perf

• Production stores stop emitting tens of thousands of trace lines per day in var/log/system.log once the toggle is left off.

Deps

• Requires wimakeit/module-core 3.0.9+ for the shared debug logger virtual type.

[1.10.30] - 2026-05-08

Admin

• Admin menu group standardized — module appears under a top-level Wimakeit_MeilisearchEngine entry with a Settings child that opens directly on the configuration section.
• Config section path renamed from wimakeit_meilisearch to wimakeit_meilisearch_engine for consistency with the other Wimakeit modules. A data patch migrates existing core_config_data rows automatically on setup:upgrade — no manual reconfiguration needed.

[1.10.29] - 2026-04-29

Deps

• Certified PHP 8.1 → 8.3 support. Composer php constraint tightened to >=8.1 <8.4.
• Fixed implicit-nullable parameter declarations flagged by PHP 8.4-rc deprecation notices.

[1.10.28] - 2026-04-23

Fix

• Category listings on stores with HT catalog prices (tax/calculation/price_includes_tax=0) now apply VAT correctly. Block\CustomerGroup::isPriceIncludingTax() returns the real Tax\Model\Config::priceIncludesTax() instead of a hard-coded true, so both TTC and Anowave TaxSwitch HT toggles render correct prices on autocomplete and live-search.
• New ViewModel\Ssr preference applies the same tax rule server-side so SSR HTML of category and search listings matches the client-side rendering. Index stays raw (no risk of double-taxation elsewhere).

[1.10.27] - 2026-04-23

Fix

• Reverted 1.10.26 (VAT applied at index time). That approach would have caused double-taxation on autocomplete and live-search paths, which apply VAT client-side. Prices are back to being indexed HT when the catalog is configured as HT — VAT is applied in the theme override instead.

[1.10.22] - 2026-04-16

Fix

• Empty product grids on pages with a price facet (e.g. /fr/nos-libraires/<name>) fixed. IndexSettingsUpdater now registers price_<groupId> for every customer group as both filterable and sortable, so Meilisearch accepts the facet query the adapter builds.

[1.10.16] - 2026-03-19

Fix

• Category page filters, sorting and pagination work again. The isSsrMode() check in search.js was disabling JS subscriptions on SSR-rendered category pages — now SSR initial state is used for first render only, while JS handles dynamic user interactions.
• Loading spinner no longer stays stuck on SSR pages (added searchState.isLoading(false) after init).
• Autocomplete hitsPerPage now respects catalog/frontend/grid_per_page instead of a hard-coded fallback.

[1.8.7] - 2026-02-24

Feature

• Progress bar support during Meilisearch sync — new progressCallback parameter on syncBatch() and syncFromCsv() for real-time CLI feedback.

Fix

• SKU values are now consistently handled as strings throughout SyncStateManager and PartialSyncService to prevent PHP type errors.
• getIndexName() correctly resolved (was incorrectly calling resolve()).

[1.8.6] - 2026-02-24

Fix

• Added string casting on SKU in SyncStateManager iteration loops (preloadHashes, updateHashBatch, getChangedSkus, deleteHashes).
• Added string casting on SKU in PartialSyncService::syncBatch().

[1.8.5] - 2026-02-24

Fix

• Index name resolver: switched from resolve() to getIndexName() for compatibility with Walkwizus MeilisearchBase.

[1.8.4] - 2026-02-24

Fix

• SyncStateManager::hasChanged(), getStoredHash(), updateHash() now accept string|int for the SKU parameter with internal string casting.

[1.8.3] - 2026-02-24

Fix

• PartialSyncService::buildPartialDocument() accepts int|string for entityId (matches what fetchPairs returns).

[1.8.2] - 2026-02-24

Fix

• Replaced non-existent ClientManager with ConnectionManager from Walkwizus MeilisearchBase.

[1.8.0] - 2026-02-23

Feature

• Partial Sync Service: send only changed fields (stock, price, status) to Meilisearch instead of full documents. Drastically reduces indexing load on ERP-driven imports.
• SyncStateManager performs hash-based change detection to skip unchanged products.
• New PartialSyncConfig admin section.

Admin

• Sync now uses partial updates for stock/price changes; full reindex only when needed.

[1.6.4] - 2026-02-23

Fix

• Search proxy UTF-8 error fixed via sanitizeUtf8() to handle malformed characters in Meilisearch responses (prevents JSON serialization errors).
• Search proxy SearchQuery conversion fixed ("Call to a member function toArray() on array") by converting frontend JSON arrays to proper Meilisearch\Contracts\SearchQuery objects.
• Double tax on prices fixed (e.g. 20.05 → 21.25). Meilisearch stores TVAC, so priceIncludesTax now always returns true in CustomerGroup block.

Admin

• Simplified calculateDisplayPrice() in product.js — prices are passed through (Meilisearch already stores TVAC).

[1.6.3] - 2026-02-19

Feature

• Meilisearch Search Proxy — new controller /meilisearch/search/multisearch routes autocomplete searches through Magento, so the backend cache is truly shared across all users/browsers. Configurable via Admin → Search Cache → "Use Search Proxy" (on by default). Falls back to direct Meilisearch if the proxy fails.

Admin

• Autocomplete JS now calls the Magento proxy by default; direct Meilisearch call remains the fallback.

[1.6.2] - 2026-02-19

Fix

• Backend cache now shared across users/browsers. SearchCacheService was using a generic CacheInterface instead of the dedicated meilisearch_search cache type — switched to FrontendPool so the cache type is honored. Respects bin/magento cache:enable meilisearch_search.

[1.6.1] - 2026-02-19

Feature

• Multi-level cache system with configurable TTL. Frontend localStorage cache (default 5 min, max 100 queries) for autocomplete; backend Magento cache (default 15 min) shared across users; native Magento cache type meilisearch_search so the standard cache management UI and CLI work.
• New admin Autocomplete Behavior group: Minimum Characters (default 3) and Debounce delay (default 500 ms).
• New Debug section with "Throw On Error" — surfaces search errors to users instead of silent empty results (development only).
• New admin button to manually flush the Meilisearch backend cache.

Security

• API key validation in RetryableApiClient rejects placeholder values (CHANGE_ME, YOUR_API_KEY, etc.).
• Search errors no longer expose stack traces by default.

Perf

• Optimized task polling with exponential backoff (250 ms initial, 3 s max).
• Model\Config has a bounded in-memory cache (MAX_CACHE_SIZE 100) for parsed config values.
• DescriptionTruncatePlugin::truncateHtml() rewritten with early exits and fewer string operations.

Fix

• Unbounded memory leak in Observer\ReindexProductAfterSave (static $processedProductIds now capped at 1000).
• ObjectManager anti-pattern in SearchAdapter\ResponseFactory replaced with proper factory injection.
• N+1 queries in Cron\ProcessReindexQueue replaced with batch product preload and attribute caching.
• Reflection in SafeIndexerPlugin and SaveIndexValidatorPlugin replaced with injected SearchIndexNameResolver.
• Silent search failures in SearchAdapter\Adapter get user-facing error messages (gated by debug mode).

[1.4.7] - 2026-02-06

Feature

• New Document Content admin group: toggle Include Description on/off and set Description Max Length (default 150 chars). Truncates at word boundary, strips HTML, normalizes whitespace.
• DescriptionTruncatePlugin on AttributeMapper::map() removes or truncates description/short_description depending on config.

Fix

• Synced system.xml with upstream — restored the missing autocomplete_limit field and layered_navigation group.

Perf

• Index size optimization: descriptions can be excluded entirely or trimmed to reduce Meilisearch index footprint.

[1.3.14] - 2026-01-20

Deps

• Composer patch for Walkwizus SettingsManager to fix return-type compatibility with meilisearch-php 1.16.x (reverts return types to array).

[1.3.11] - 2026-01-19

Fix

• SkipWalkwizusIndexerPlugin return type fixed from void to IndexerInterface (resolves "Return value must be of type IndexerInterface, null returned" during catalogsearch_fulltext reindex).
• Plugin re-added to di.xml (was missing from source module).

[1.3.6] - 2026-01-09

Fix

• SafeIndexerPlugin reflection error resolved by reading the property from BaseIndexerHandler instead of the interceptor (was failing during reindex with "Property searchIndexNameResolver does not exist").

[1.3.5] - 2026-01-08

Fix

• .block.filter .filter-content max-width 100% on mobile.

[1.3.4] - 2026-01-08

Fix

• Mobile filter button visibility (display: flex !important).
• Z-index hierarchy fixed: button (900), overlay (999), popup (1000).
• .filter-option padding set to 5px.
• noUiSlider handle positioning fixed (top: -3px, 20 px size).
• Desktop hide rule loosened so the mobile override applies properly.

[1.3.3] - 2026-01-08

Feature

• Mobile Filter Popup: floating "Filters" button fixed to the bottom of the screen, badge counter for active filters, slide-in popup from the right (85% width, max 340 px), dark overlay with click-to-close and Escape-key support, sticky footer with "Apply Filters" button, iOS scroll lock with position restoration.
• Override of Walkwizus facets.html template with full mobile popup structure.

Admin

• Refactored layer-navigation styles: clear desktop/mobile separation, CSS custom property --header-height, transform/visibility for smooth animations.

[1.3.1] - 2026-01-08

Feature

• Smart pagination JS: ellipsis-style page numbers as a Knockout.js override of the Walkwizus pagination component.
• Full styles for layered navigation (checkbox, swatch, price slider).

Fix

• Pagination was rendering every page number instead of using ellipsis.

[1.3.0] - 2026-01-08

Feature

• New IndexHealthMonitor service to detect missing attributes.
• New SettingsBackupService for automatic backup/restore of index settings (stored in var/meilisearch_backups/).
• New IndexSettingsValidator to verify settings were actually saved on Meilisearch.
• New RetryableApiClient HTTP client with exponential backoff and retry.
• New SaveIndexValidatorPlugin validates index health after every saveIndex to catch silent failures.
• New CLI Health Check command (wimakeit:meilisearch:health): check health, create backups (--backup), list backups (--list-backups), restore (--restore=…).
• Configurable Maximum Results admin setting (was hard-coded to 10 000).
• Smart pagination with ellipsis, jump-to-page dropdown for >10 pages, item-count display, responsive design.
• Translation files for en_US, fr_FR, nl_NL, es_ES covering all UI strings.

Security

• escapeFilterValue() in Mapper.php prevents filter injection.
• escapeHtml() in product.js prevents XSS on autocomplete render.
• SSL verification (CURLOPT_SSL_VERIFYPEER) enabled in RetryableApiClient.
• File-permission checks in SettingsBackupService before writing.
• All settings changes logged with full context for audit.

Perf

• Layered-navigation facet config (labels, options) cached in memory per store.
• CleanTasksCommand and CleanTasks cron switched to RetryableApiClient (replaces raw cURL).

Fix

• Settings no longer silently lost during cleanIndex (auto-backup + auto-restore).
• Attribute updates validated to ensure they were actually persisted.
• Strict comparison for swatch type checks.
• Division-by-zero in jitter calculation fixed.

[1.0.6] - 2026-01-08

Fix

• SafeIndexerPlugin return types corrected (must return IndexerInterface, not void). Prevents "Return value must be of type IndexerInterface, null returned" during indexation.

[1.0.2] - 2025-12-15

Fix

• Removed hard dependency on Anowave\TaxSwitch in the CustomerGroup block — prevents errors when that module is not installed.

[1.0.0] - 2024-12-15

Feature

• Initial release.
• Custom Meilisearch search adapter for Magento 2.
• Enhanced autocomplete frontend (6-product grid) with image, name, SKU, price, AJAX Add-to-Cart.
• Partial SKU search (sku_parts field).
• Dynamic attribute management (searchable / filterable / sortable from admin).
• Auto-configuration of Magento attributes ("Use in Search = Yes" toggled automatically).
• New CLI wimakeit:meilisearch:sync-settings.
• Customer-group-based pricing (price_<group>) in autocomplete and listings.
• Custom ranking rules support.

Deps

• Requires walkwizus/magento2-module-meilisearch.