Skip to main content

Changelog

1.2.1 (2026-10-26)

Improvements

  • Product Finder can now be installed alongside Mirasvit core 2.0, so it no longer blocks upgrading the other Mirasvit extensions on your store that need core 2.0.

1.2.0 (2026-10-15)

Features

  • Hyvä support now ships with the extension — The companion package mirasvit/module-finder-hyva is gone: the finder block, its dropdown and label filters and the Product Finder widget now work on Hyvä from Product Finder itself, styled to look as they did with the companion package. There is no second package to find and keep in step, and on a Luma store the Hyvä part simply stays dormant. Composer removes the companion package by itself when you upgrade.

Improvements

  • The finder runs one lightweight script on Luma and Hyvä alike, without jQuery, RequireJS or Alpine. Horizontal finders on Luma now use the store's standard dropdowns instead of the chosen.js ones.
  • Finder import shows a clear "The file could not be imported" message when an unexpected error occurs, and writes the details to the exception log instead of showing a raw technical error in the admin. The message is translated into every shipped language.
  • Admin labels in the finder settings use sentence case: URL configuration, Update unrequired filter options and the Finder configuration ACL permission.
  • ⚠️ Hyva_MirasvitFinder is gone, not renamed — You only need to act if you referenced it yourself: in a custom di.xml, a layout file, or a deployment script that enables modules by name.
  • ⚠️ If you copied a finder template into your theme, copy it again — Luma and Hyvä now share Mirasvit_Finder::finder/horizontal.phtml, finder/vertical.phtml, filter/dropdown.phtml, filter/label.phtml and js.phtml. An override at a Hyva_MirasvitFinder:: path is simply not read, and an older Luma copy that loads Mirasvit_Finder/js/finder or chosen.js no longer works.
  • ⚠️ On Hyvä, rebuild your theme's Tailwind CSS after upgrading — Run bin/magento hyva:config:generate, then rebuild styles.css. Until then the finder shows unstyled: filters stack in a column and label filters look like plain text. If your theme's CSS is built in CI or a deployment pipeline, updating the module alone is not enough, so run that build too.

Fixed

  • The Product Finder widget works on Hyvä — A finder inserted as a CMS widget showed "Finder not found" instead of the finder. Luma was unaffected.
  • Finder results stay on the store view you searched from — A finder with a destination URL such as /tyres.html sent shoppers on a store view that has its code in the URL (for example /hyva/) to the default store view.
  • SEO-friendly finder URLs on a store view with its code in the URL — With Friendly URLs on, a result page such as /hyva/tyres/finder/width-115&profile-70.html answered 404 Page Not Found.
  • Browser Back after a search — Going back no longer shows filter options for an earlier selection, and the result page no longer loads twice.
  • Label filters on Luma — They now mark required filters with an asterisk, keep their selection when the options refresh, restore the last selection on return, and open from the keyboard. The choice is readable inside a finder with a coloured background (it was white on white in a finder with white text), and the option panel opens right under its field and stays within its column.
  • Loading spinner no longer hangs — If loading filter options failed (for example after a network hiccup), the spinner kept spinning and the filters stayed disabled. The finder now recovers, and choosing the same value again retries the request.
  • Option names with special characters on Hyvä — Names such as Tote® now read "Tote®" after the filter options refresh, just as on first page load.
  • Horizontal finders with five filters on Luma — The fifth filter now gets a proper column instead of shrinking to its content with its label wrapping under the option panel.

1.1.48 (2026-09-30)

Improvements

  • Internal compatibility updates for the upcoming Mirasvit core 2.0.

1.1.47 (2026-09-14)

Fixed

  • Finder filters now work on stores running Elasticsearch 8 or Amasty Elasticsearch OpenSearch.
  • Deleting a product now removes it from the Finder, so it no longer appears in the Finder grid or export.
  • Finder rules that exclude an attribute value now correctly keep products that have no value set for that attribute.
  • Finder filter options with the value "0" are no longer dropped.
  • Finder attribute filters now work on Adobe Commerce stores that use content staging.

1.1.46 (2026-08-21)

Fixed

  • Fixed the product finder sometimes showing the wrong products for a selected filter combination.

1.1.45 (2026-05-21)

Fixed

  • Fixed widget.xml XSD validation error ("attribute 'translate' is not allowed" on widget); the translate attribute now lives on the child label/description elements where Magento's widget.xsd declares it. Resolves admin libxml errors and lets the Product Finder widget register correctly on the Content → Widgets page.

1.1.44 (2026-05-19)

Improvements

  • Localized to 15 core e-commerce locales (ar, cs, de, es, fr, it, ja, nl, pl, pt-BR, pt-PT, sv, tr, uk, zh-Hans)

1.1.43 (2025-12-04)

Fixed

  • Fixed filter showing incorrect options after using the browser back button

1.1.42 (2025-11-11)

Fixed

  • Fixed finder not resolving correctly when "Friendly URLs" is enabled and the finder has a custom URL key

1.1.41 (2025-10-09)

Fixed

  • Fixed filter URL key not updating automatically when changing the linked attribute on an existing filter

1.1.40 (2025-09-22)

Improvements

  • Added compatibility with Magento Commerce (Enterprise Edition) indexer

1.1.39 (2025-08-22)

Fixed

  • Fixed PHP 8.4 compatibility — resolved deprecated fgetcsv parameter handling and implicit nullable parameter warnings

1.1.38 (2025-06-18)

Fixed

  • Fixed admin permission (ACL) tree structure so Finder permissions appear correctly under the parent menu

1.1.37 (2025-06-18)

Fixed

  • Fixed widget ID conflict with Mirasvit Form Builder — the finder widget now uses a unique identifier

1.1.36 (2025-06-16)

Improvements

  • Improved WCAG 2.2 AA accessibility for all finder templates — added ARIA labels, roles, and keyboard navigation support

Fixed

  • Fixed finder description not displaying on the storefront
  • Fixed unescaped HTML output in admin import templates

1.1.35 (2025-02-06)

Features

  • Update Unrequired Filter Options — new configuration option to automatically refresh non-required filter dropdowns based on the selection in the following filter

1.1.34 (2024-12-17)

Fixed

  • Fixed optional (non-required) filters incorrectly restricting results when left unselected

1.1.33 (2024-10-21)

Improvements

  • Replaced Font Awesome spinner with a lightweight inline SVG loader, removing the external font dependency

Fixed

  • Fixed filter label translations not applying on the storefront

1.1.32 (2024-08-08)

Fixed

  • Fixed filters showing options for products outside the current category — empty categories now correctly display no filter options

1.1.31 (2024-07-15)

Improvements

  • ⚠️ Increased name column length in mst_finder_filter_option table to support longer option values

Fixed

  • Fixed filter options being incorrectly restored from browser local storage instead of fetching fresh data

1.1.30 (2024-06-06)

Improvements

  • Added server-side caching for filter option AJAX requests, reducing page load on repeated visits

1.1.29 (2024-06-06)

Improvements

  • Filter dropdowns are now visually disabled with a loading indicator during AJAX requests to prevent conflicting selections

1.1.28 (2024-06-03)

Improvements

  • Added a loading spinner while filter options are being fetched via AJAX

1.1.27 (2024-06-03)

Improvements

  • Reduced the number of AJAX requests when selecting filter options — sequential selections are now batched

1.1.26 (2024-03-06)

Fixed

  • Fixed imported products disappearing from finder results after reindex

1.1.25 (2023-11-08)

Fixed

  • Fixed indexer regression introduced in 1.1.24 that caused some filter options to not appear

1.1.24 (2023-11-08)

Improvements

  • Added compatibility with Magento 2.4.6 search request handling

Fixed

  • Fixed filters not applying correctly on the results page in certain configurations

1.1.23 (2023-10-11)

Improvements

  • Improved compatibility with Magento 2.4.6 filter applier service

1.1.22 (2023-10-05)

Fixed

  • Fixed filter option sort order not being applied correctly in dropdowns

1.1.21 (2023-10-04)

Fixed

  • Fixed filters not applying on Magento 2.3 with Elasticsearch 6
  • Fixed filter options not loading correctly from browser cache

1.1.20 (2023-10-03)

Fixed

  • Fixed "Sort Mode" setting having no effect on filter option ordering

1.1.19 (2023-08-28)

Fixed

  • Fixed AJAX filter response returning a JSON object instead of an array when option keys are non-sequential
  • Fixed dependency injection error for CombineFactory in condition rules

1.1.18 (2023-06-12)

Improvements

  • Added compatibility with OpenSearch search engine

Fixed

  • Fixed "JSON Parse error: Unexpected identifier" when filter response contained malformed data

1.1.17 (2023-05-30)

Fixed

  • Fixed error during CSV import when a row contains fewer columns than expected
  • Fixed error on import listing page when filter data is incomplete

1.1.16 (2023-05-19)

Fixed

  • Fixed Reset button not clearing all filter selections

1.1.15 (2023-05-12)

Fixed

  • Fixed SQL error "You cannot define a correlation name 'tbl_category_ids' more than once" when using product conditions

1.1.14 (2023-03-15)

Fixed

  • Fixed PHP 8.2 compatibility — resolved deprecated dynamic property warnings in condition query builder

1.1.13 (2023-02-21)

Fixed

  • Fixed finder URL key resolution on multi-store setups returning incorrect store-specific URLs

1.1.12 (2023-02-17)

Fixed

  • Fixed error during sample data installation when filter options reference missing data

1.1.11 (2023-02-17)

Fixed

  • Fixed error "FilterOptionService::getName() must be of the type string, null returned" during import of options with empty names
  • Fixed raw PHP code displaying in the admin "Template .phtml" setting instead of the template selector

1.1.10 (2023-02-07)

Fixed

  • Fixed attribute label translation for multi-store indexer

1.1.9 (2023-02-02)

Improvements

  • ⚠️ Added data patch to migrate legacy filter option format — runs automatically on upgrade

Fixed

  • Fixed attribute labels not being translated on the storefront for attribute-based filters

1.1.8 (2023-02-02)

Improvements

  • Added compatibility with Magento 2.4.6 Elasticsearch configuration

Fixed

  • Fixed label-style multi-select filters not submitting selected values correctly
  • Fixed search engine type detection failing for certain Elasticsearch configurations

1.1.7 (2023-01-20)

Fixed

  • Fixed filter settings not saving correctly in the admin panel
  • Fixed "Undefined array key finder_id" warning when applying filters
  • Fixed duplicate filter URL keys being allowed — URL keys are now enforced as unique per finder

1.1.6 (2022-11-02)

Fixed

  • Fixed JavaScript loading order causing finder to initialize before dependencies are ready

1.1.5 (2022-10-18)

Fixed

  • Fixed filters not applying to catalog results when "Friendly URLs" is enabled (follow-up fix for edge cases)

1.1.4 (2022-10-07)

Fixed

  • Fixed filters not applying to catalog page when "Friendly URLs" is enabled and the filter URL key differs from the attribute code

1.1.3 (2022-10-07)

Fixed

  • Fixed "Front controller reached 100 router match iterations" error when multiple finders exist
  • Fixed filters with identical names across different finders interfering with each other

1.1.2 (2022-08-12)

Fixed

  • Fixed CSV import validation not catching malformed rows, leading to silent data errors

1.1.1 (2022-06-20)

Improvements

  • ⚠️ Removed db_schema_whitelist.json — Magento now manages schema changes via db_schema.xml only

1.1.0 (2022-05-23)

Improvements

  • ⚠️ Migrated database schema from install/upgrade scripts to Magento declarative schema (db_schema.xml)

1.0.24 (2022-04-27)

Features

  • Product Conditions — define rules to automatically limit which products appear in finder results (e.g., only products from a specific category or with certain attributes)

1.0.23 (2022-04-22)

Fixed

  • Fixed finder filter not applying when the filter's URL key differs from the attribute code with "Friendly URLs" enabled

1.0.22 (2022-04-22)

Fixed

  • Fixed finder returning unfiltered products when "Friendly URLs" is enabled (regression since 1.0.20)
  • Fixed finder returning unfiltered product collection on Magento 2.3

1.0.21 (2022-04-20)

Fixed

  • Fixed compatibility with Mageplaza Layered Navigation
  • Fixed Reset button not clearing selections when multiple finders are on the same page
  • Fixed multiple finders on the same page interfering with each other

1.0.20 (2022-04-01)

Features

  • Automatic Reindex via Cron — finder index is now rebuilt automatically on a schedule

Improvements

  • Improved filter loading speed by optimizing product count queries

Fixed

  • Fixed execution timeout during large CSV file import
  • Fixed compatibility with Mageplaza Layered Navigation
  • Fixed preselected filter options not narrowing results correctly

1.0.19 (2022-04-01)

Fixed

  • Fixed label-style multi-select filters not displaying selected values
  • Fixed Reset button URL not working when "Friendly URLs" is enabled
  • Fixed compatibility with Mageplaza Layered Navigation v2.4.3

1.0.18 (2021-09-09)

Fixed

  • Fixed filters containing hyphens in option names not matching products
  • Fixed CSV import creating duplicate entries when the same SKU appears in multiple filter columns

1.0.17 (2021-08-09)

Features

  • Filter Sorting — new "Sort Mode" option to control the order of filter options (alphabetical, numeric, or position)

Fixed

  • Fixed "Friendly URLs" generating incorrect redirect paths

1.0.16 (2021-07-05)

Improvements

  • Added additional sort mode options for filter dropdowns

Fixed

  • Fixed "Friendly URLs" not working with multi-select attribute filters
  • Fixed default value for dropdown filters not being selected on page load

1.0.15 (2021-07-05)

Fixed

  • Fixed default value for dropdown filter not being pre-selected on page load

1.0.13 (2021-05-26)

Features

  • Multi-select Dropdown — filters can now be configured as multi-select dropdowns using the Chosen library
  • Session Persistence — selected filter values are remembered during the customer's session

1.0.12 (2021-05-17)

Features

  • Non-sorted Filter Mode — new "Non-sorted" option added to the filter Sort Mode setting

Fixed

  • Fixed filter options not updating correctly on the finder results page

1.0.11 (2021-05-13)

Fixed

  • Fixed multi-select filter option not submitting selected values

1.0.10 (2021-05-06)

Fixed

  • Fixed filter rendering compatibility with Magento 2.3

1.0.9 (2021-04-21)

Fixed

  • Fixed layered navigation product counts being calculated incorrectly on Magento 2.3

1.0.8 (2021-04-19)

Fixed

  • Fixed delete confirmation message on Magento 2.4

1.0.7 (2021-04-12)

Features

  • Index by Attribute — reindex finder based on product attributes in addition to imported CSV data
  • Filter Button — optional "Find" button to apply all filter selections at once instead of auto-redirecting
  • Category Suffix Parsing — correctly handles category URL suffixes (e.g., .html) in friendly URLs

Fixed

  • Fixed compatibility with Magento 2.2 and 2.3 admin controllers

1.0.6 (2021-01-06)

Fixed

  • Fixed imported options showing wrong product results when multiple products share the same SKU across different filters (one-to-many relation)

1.0.5 (2020-11-26)

Improvements

  • Added "Reindex" button to the finder edit page in admin for manual reindexing
  • Improved error display during CSV import when rows contain invalid data

1.0.4 (2020-11-19)

Improvements

  • Added compatibility with Magento 2.3.5

1.0.3 (2020-11-11)

Features

  • Friendly URLs — finder selections are now reflected in clean, SEO-friendly URLs instead of query parameters. Configurable in Stores Configuration.

1.0.2 (2020-11-09)

Fixed

  • Fixed required filter fields not being visually marked as required on the storefront

1.0.1 (2020-11-06)

Fixed

  • Fixed filters based on product attributes not returning matching products
  • Fixed admin save error when no filters are configured on a finder

1.0.0 (2020-10-19)

Features

  • Product Finder with configurable dropdown and label-style filters
  • CSV import/export for filter options with SKU mapping
  • Widget support for embedding finders on any CMS page or block
  • Dedicated finder results page with layered navigation integration
  • Admin UI for managing finders, filters, and filter options
  • Console command for bulk CSV import