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.

Screenshots

Storefront sidebar

Admin — configuration

Admin — live demo

Indexer registration (inherited from the core module)

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.

Compatibility

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ä)

All other settings (enable/disable, labels, counts, position, discount sources) live in the General group and belong to the core module.

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.

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.

Changelog

1.0.1

• Pin hard dependency on mage2kishan/module-sale-filter to ^1.0.4 so installers always pull the sort + realtime fixes.
• README rewrite with screenshots and live-demo GIF.

1.0.0

• Initial release.

Support

• Issues, feature requests: kishansavaliyakb@gmail.com
• Author: Kishan Savaliya

License

Proprietary. See LICENSE.