On Sale Filter (Hyva Companion) for Magento 2
Requires mage2kishan/module-sale-filter (the core module that owns the indexer, the filter logic, and the Luma template). Installing this package alone does nothing.
Key Features:
- Registers the Hyvä-native layered-navigation template at ...
- Adds the Appearance (Hyvä) admin group at Stores -> Confi...
- Expanded By Default
- Varies the filter renderer's FPC cache key on that toggle...
Additional Services
Everything in the box
Built-in from day one. No add-ons, no upsell, no licence keys to renew.
Adds the Appearance (Hyvä) admin group at Stores -> Confi...
Expanded By Default
whether the filter renders open or collapsed on first paint (default: Yes).
Varies the filter renderer's FPC cache key on that toggle...
Overview
Panth Sale Filter Hyvä is the Hyvä-native storefront template for the Panth Sale Filter extension on Magento 2 and Adobe Commerce that replaces the core Luma Knockout markup with Alpine.js and Tailwind when a Hyvä theme is active.
The Panth Sale Filter Hyvä package registers a drop-in template at Panth_SaleFilter::layer/filter/sale.phtml that takes over rendering of the On Sale layered-navigation filter the moment a Hyvä theme is detected. Alpine.js handles the open and close interaction, Tailwind handles the styling, and the module ships zero jQuery and zero RequireJS, keeping Hyvä's lean frontend budget intact.
It adds a dedicated Appearance (Hyvä) admin group at Stores → Configuration → Panth Extensions → Sale Filter with an Expanded By Default toggle so merchants can choose whether the filter renders open or collapsed on first paint. The renderer's full-page-cache key varies on that toggle, so admin changes bust the cached block slot cleanly without manual flushes.
This package is a hard companion to mage2kishan/module-sale-filter: installing it alone does nothing. The core module owns the indexer, the filter logic, the URL parameters, and the admin grid; this Hyvä package supplies only the Alpine + Tailwind template and the Appearance config group.
Best for:
- Hyvä Themes 1.3+ storefronts already running the Panth Sale Filter core module
- Merchants migrating from Luma to Hyvä who need feature parity for layered-navigation filters
- Hyvä-first developers who refuse to ship jQuery or Knockout into a Tailwind storefront
What you get
Panth Sale Filter Hyvä gives the core On Sale filter a true Hyvä storefront:
- Alpine.js plus Tailwind template at Panth_SaleFilter::layer/filter/sale.phtml : zero jQuery
- Appearance (Hyvä) admin group with an Expanded By Default toggle, store-view scoped
- FPC cache key varies on the appearance toggle so admin changes bust cleanly
- Auto-activates when a Hyvä theme is detected: falls back to Luma elsewhere
- Tested on Hyvä Themes 1.3+, PHP 8.1 to 8.4, and Magento 2.4.4 to 2.4.8
What this module does
- Registers the Hyvä-native layered-navigation template at
Panth_SaleFilter::layer/filter/sale.phtml, replacing the core module's Luma Knockout markup when a Hyvä theme is active. Alpine.js handles the open/close interaction; Tailwind handles the styling, no jQuery, no requireJS. - Adds the Appearance (Hyvä) admin group at Stores → Configuration → Panth Extensions → Sale Filter with one toggle:
- Expanded By Default, whether the filter renders open or collapsed on first paint (default: Yes).
- Varies the filter renderer's FPC cache key on that toggle so admin changes bust the cached block slot.
Everything else (indexer, admin grid, filter logic, URL params, label config, discount-source switches, etc.) lives in the core module, see its README for the full story.
Template override
The filter renders via:
app/design/frontend/<YourVendor>/<YourHyvaChild>/Panth_SaleFilter/templates/layer/filter/sale.phtml
Copy view/frontend/templates/layer/filter/sale.phtml into your theme to customise markup without forking the module.
Changelog
1.0.1
- Pin hard dependency on
mage2kishan/module-sale-filterto^1.0.4so installers always pull the sort + realtime fixes. - README rewrite with screenshots and live-demo GIF.
1.0.0
- Initial release.
Panth Sale Filter, Hyvä compatibility
Hyvä-native storefront template for the Panth Sale Filter, Alpine.js + Tailwind, zero jQuery. Ships the Appearance admin group so you can toggle the collapsed/expanded default from Stores → Configuration.
Requires
mage2kishan/module-sale-filter(the core module that owns the indexer, the filter logic, and the Luma template). Installing this package alone does nothing.
Compatibility
| Component | Version |
|---|---|
| Magento Open Source / Adobe Commerce | 2.4.x (tested 2.4.4-2.4.8) |
| PHP | 8.1 · 8.2 · 8.3 · 8.4 |
| Hyvä Themes | 1.3+ |
| Core module | mage2kishan/module-sale-filter ^1.0.4 |
Installation
# This pulls the core module automatically (hard dependency).
composer require mage2kishan/module-sale-filter-hyva
bin/magento module:enable Panth_SaleFilter Panth_SaleFilterHyva
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento indexer:reindex panth_salefilter_product
bin/magento cache:flush
Configuration
Stores → Configuration → Panth Extensions → Sale Filter → Appearance (Hyvä)
| Field | Notes |
|---|---|
| Expanded By Default | Renders the filter in its open state on first paint. Off = collapsed until the shopper clicks the header. Store-scoped. |
All other settings (enable/disable, labels, counts, position, discount sources) live in the General group and belong to the core module.
Uninstall
bin/magento module:disable Panth_SaleFilterHyva
composer remove mage2kishan/module-sale-filter-hyva
bin/magento setup:upgrade
Removing only this module reverts Hyvä storefronts to the core module's Luma template (works but visually off-theme). Remove both to drop the filter entirely.
License
Proprietary. See LICENSE.
| Module Category | Catalog & Products |
|---|---|
| Best For | All Sizes |
Need this customised?
Talk to Kishan directly: written quote, scope and timeline within 24 hours. No sales call.
On Sale Filter (Hyva Companion) for Magento 2





