PHPackages                             mage2kishan/module-sale-filter-hyva - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Search &amp; Filtering](/categories/search)
4. /
5. mage2kishan/module-sale-filter-hyva

ActiveMagento2-module[Search &amp; Filtering](/categories/search)

mage2kishan/module-sale-filter-hyva
===================================

Panth Sale Filter — Hyvä compatibility module. Ships Alpine.js + Tailwind templates and the Appearance admin group for the "On Sale" layered navigation filter. Install alongside mage2kishan/module-sale-filter.

1.0.4(1mo ago)00proprietaryPHPPHP ~8.1.0||~8.2.0||~8.3.0||~8.4.0

Since Apr 23Pushed 2d agoCompare

[ Source](https://github.com/mage2sk/module-sale-filter-hyva)[ Packagist](https://packagist.org/packages/mage2kishan/module-sale-filter-hyva)[ Docs](https://kishansavaliya.com)[ RSS](/packages/mage2kishan-module-sale-filter-hyva/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (3)Versions (5)Used By (0)

Panth Sale Filter — Hyvä compatibility
======================================

[](#panth-sale-filter--hyvä-compatibility)

[![Latest Version](https://camo.githubusercontent.com/a1bf3c3fb9b5fee572345d76a4501b453547c7e8d00e1979acad5926a14f0868/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d616765326b697368616e2f6d6f64756c652d73616c652d66696c7465722d687976612e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/mage2kishan/module-sale-filter-hyva)[![Magento 2.4](https://camo.githubusercontent.com/a1e37eb6a80e6f9d2a361e50b7309c9d9e55ccd2821e987ae14e9c67c3ef457d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4d6167656e746f2d322e342d6f72616e67652e7376673f7374796c653d666c61742d737175617265266c6f676f3d6d6167656e746f266c6f676f436f6c6f723d7768697465)](https://developer.adobe.com/commerce/)[![PHP 8.1 - 8.4](https://camo.githubusercontent.com/86e4167eeef9be2757d70163fb9660456d2d63f62e3a1911ec38f493eba45799/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e312532302d2d253230382e342d626c75653f7374796c653d666c61742d737175617265266c6f676f3d706870266c6f676f436f6c6f723d7768697465)](https://php.net)[![Hyvä 1.3+](https://camo.githubusercontent.com/080607168787d2c8ec5dbc1b996c7a59573a0b1506db85fc940bec055bca221c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4879762543332541342d312e332b2d3134623861363f7374796c653d666c61742d737175617265)](https://hyva.io/)[![License](https://camo.githubusercontent.com/fa29be4f2797ff8b29e2d9fbd62f97650bafb7e96abb323c3f2dbc9078cb3e1a/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d50726f70726965746172792d6c69676874677265792e7376673f7374796c653d666c61742d737175617265)](LICENSE)

Hyvä-native storefront template for the [**Panth Sale Filter**](https://packagist.org/packages/mage2kishan/module-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`](https://packagist.org/packages/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
-----------

[](#screenshots)

### Storefront sidebar

[](#storefront-sidebar)

[![Hyvä storefront sidebar](docs/images/hyva-sidebar.png)](docs/images/hyva-sidebar.png)

### Admin — configuration

[](#admin--configuration)

[![Admin configuration (Appearance section, Hyvä group)](docs/images/admin-configuration.png)](docs/images/admin-configuration.png)

### Admin — live demo

[](#admin--live-demo)

[![Admin configuration demo](docs/images/admin-config-demo.gif)](docs/images/admin-config-demo.gif)

### Indexer registration (inherited from the core module)

[](#indexer-registration-inherited-from-the-core-module)

[![Index Management](docs/images/admin-index-management.png)](docs/images/admin-index-management.png)

---

What this module does
---------------------

[](#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](https://github.com/mage2sk/module-sale-filter#readme) for the full story.

---

Compatibility
-------------

[](#compatibility)

ComponentVersionMagento Open Source / Adobe Commerce**2.4.x** (tested 2.4.4 – 2.4.8)PHP8.1 · 8.2 · 8.3 · 8.4Hyvä Themes**1.3+**Core module[`mage2kishan/module-sale-filter`](https://packagist.org/packages/mage2kishan/module-sale-filter) **^1.0.4**---

Installation
------------

[](#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
-------------

[](#configuration)

**Stores → Configuration → Panth Extensions → Sale Filter → Appearance (Hyvä)**

FieldNotesExpanded By DefaultRenders 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.

---

Template override
-----------------

[](#template-override)

The filter renders via:

```
app/design/frontend///Panth_SaleFilter/templates/layer/filter/sale.phtml

```

Copy [`view/frontend/templates/layer/filter/sale.phtml`](view/frontend/templates/layer/filter/sale.phtml) into your theme to customise markup without forking the module.

---

Uninstall
---------

[](#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
---------

[](#changelog)

### 1.0.1

[](#101)

- 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

[](#100)

- Initial release.

---

Support
-------

[](#support)

- Issues, feature requests:
- Author: [Kishan Savaliya](https://kishansavaliya.com)

---

License
-------

[](#license)

Proprietary. See [LICENSE](LICENSE).

###  Health Score

41

—

FairBetter than 87% of packages

Maintenance97

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity54

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~5 days

Total

4

Last Release

33d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/343e344aa298f189db888b32d62f9202d31ced1a5ea23411850a63dc4a30299c?d=identicon)[kishansavaliya](/maintainers/kishansavaliya)

---

Top Contributors

[![KishanSavaliya](https://avatars.githubusercontent.com/u/16853223?v=4)](https://github.com/KishanSavaliya "KishanSavaliya (6 commits)")

---

Tags

magento2layered-navigationmagento2 modulehyvapanthsale-filter

### Embed Badge

![Health badge](/badges/mage2kishan-module-sale-filter-hyva/health.svg)

```
[![Health](https://phpackages.com/badges/mage2kishan-module-sale-filter-hyva/health.svg)](https://phpackages.com/packages/mage2kishan-module-sale-filter-hyva)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
