PHPackages                             hananils/kirby-list-filters - 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. [Utility & Helpers](/categories/utility)
4. /
5. hananils/kirby-list-filters

ActiveKirby-plugin[Utility & Helpers](/categories/utility)

hananils/kirby-list-filters
===========================

Kirby allows for the storage of value lists using its select, tags or checkboxes fields but it doesn't offer ways to filter items by those values. List Filters closes this gap by providing includes and excludes collection filters.

1.0.0(1y ago)219MITPHPPHP ^8.2

Since Jun 25Pushed 2w ago2 watchersCompare

[ Source](https://github.com/hananils/kirby-list-filters)[ Packagist](https://packagist.org/packages/hananils/kirby-list-filters)[ Docs](https://kirby.hananils.de/plugins/list-filters)[ RSS](/packages/hananils-kirby-list-filters/feed)WikiDiscussions main Synced today

READMEChangelog (1)Dependencies (2)Versions (2)Used By (0)

[![Kirby List Filters](.github/title.png)](.github/title.png)

Kirby allows for the storage of value lists using its select, tags or checkboxes fields but it doesn't offer ways to filter items by those values. List Filters closes this gap by providing `includes` and `excludes` collection filters.

Note

Please check out the online documentation at [kirby.hananils.de/plugins/list-filters](https://kirby.hananils.de/plugins/list-filters) for further information.

Usage
=====

[](#usage)

The plugin adds the following filters:

- `includes`: finds items including the given values (like `in_array`)
- `includes some`: finds items including some of the given values
- `includes all`: finds items including all of the given values
- `excludes`: finds items excluding the given values (like `in_array`)
- `excludes some`: finds items excluding some of the given values
- `excludes all`: finds items excluding all of the given values

Examples
--------

[](#examples)

```
$plugins = $plugins->filterBy('category', 'includes all', ['field', 'section']);
```

Options
-------

[](#options)

- `hananils.list-filters.insensitive`: defaults to `true`, set to `false` if you want to enable case sensitive matching.

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

[](#installation)

### Download

[](#download)

Download and copy this repository to `/site/plugins/list-filters`.

### Git submodule

[](#git-submodule)

```
git submodule add https://github.com/hananils/kirby-list-filters.git site/plugins/list-filters

```

### Composer

[](#composer)

```
composer require hananils/kirby-list-filters

```

License
=======

[](#license)

This plugin is provided freely under the [MIT license](LICENSE.md) by [hana+nils · Büro für Gestaltung](https://hananils.de).
We create visual designs for digital and analog media.

###  Health Score

38

—

LowBetter than 83% of packages

Maintenance76

Regular maintenance activity

Popularity10

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity49

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

Unknown

Total

1

Last Release

375d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/e0465cfa7ef2b9a264429068ddfeb765f3881f9c611048d2e7e95dfad4afbb35?d=identicon)[hananils](/maintainers/hananils)

---

Top Contributors

[![nilshoerrmann](https://avatars.githubusercontent.com/u/25466?v=4)](https://github.com/nilshoerrmann "nilshoerrmann (16 commits)")

###  Code Quality

Static AnalysisRector

### Embed Badge

![Health badge](/badges/hananils-kirby-list-filters/health.svg)

```
[![Health](https://phpackages.com/badges/hananils-kirby-list-filters/health.svg)](https://phpackages.com/packages/hananils-kirby-list-filters)
```

###  Alternatives

[netgen/enhanced-selection-bundle

Netgen Enhanced Selection bundle for Ibexa Platform

19103.0k5](/packages/netgen-enhanced-selection-bundle)

PHPackages © 2026

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