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





