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 984A 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 | 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.