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.
- 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.
| 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 |
# 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:flushStores → Configuration → Panth Extensions → Sale Filter → Appearance (Hyvä)
| Field | Notes |
|---|---|
| Expanded By Default 847D | 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.
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.
bin/magento module:disable Panth_SaleFilterHyva
composer remove mage2kishan/module-sale-filter-hyva
bin/magento setup:upgradeRemoving 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.
- 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.
- Initial release.
- Issues, feature requests: kishansavaliyakb@gmail.com
- Author: Kishan Savaliya
Proprietary. See LICENSE.