PHPackages                             creativestyle/admin-list-bundle - 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. [Admin Panels](/categories/admin)
4. /
5. creativestyle/admin-list-bundle

ActiveLibrary[Admin Panels](/categories/admin)

creativestyle/admin-list-bundle
===============================

Bundle for making admin listings fast & easy

v4.0.1(7y ago)23141MITPHPPHP >=5.5

Since Jan 18Pushed 7y ago5 watchersCompare

[ Source](https://github.com/creativestyle/admin-list-bundle)[ Packagist](https://packagist.org/packages/creativestyle/admin-list-bundle)[ RSS](/packages/creativestyle-admin-list-bundle/feed)WikiDiscussions master Synced 6d ago

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

Admin List Budle
================

[](#admin-list-budle)

Setup
-----

[](#setup)

You might need to add to your `config/packages/framework.yaml`:

```
    templating:
        engines: twig

```

Templates
---------

[](#templates)

The templates are css-framework agnostic, you should override them (via symfony mechanism or by changing their config), extend the markup and style it.

Quickstart
----------

[](#quickstart)

### In your controller

[](#in-your-controller)

Get the `FilterManager` instance. *This is a non-shared service, so you get new instance every time.*

```
/** @var FilterManager $filters */
$filters = $this->get('creativestyle_admin_list.filter_manager');
```

Similarly to form builder it exposes a fluent interface, so you can register new filters:

```
$filters
    ->registerFilter(new SomeFilter('filterid', ['some_config' => 'value']);
    ->registerFilter(new SomeFilter('otherfilterid', ['some_config' => 'value'])
;
```

You can also register a paginator:

```
$filters
    ->setPaginator(new SimplePaginator([
        'order_by' => 'location.address.name',
    ]))
;
```

When you're done with configuration create a `QueryBuilder` and apply the filters, then fetch the results:

```
$qb = $repository->createQueryBuilder('product');
$filters->applyFilters($qb);

$results = $this->getFilterManager()->getPaginatedResults($queryBuilder);
```

You will need both the results and `FilterManager` in your template:

```
return $this->render('template.html.twig', [
    'results' => $results,
    'filters' => $filters,
]);
```

### In your template

[](#in-your-template)

You can render each filter by id:

```
{{ filters.renderFilter('filterid')|raw }}
```

You can also render the pagination controls like this:

```
{{ results.renderPaginationControls()|raw }}
```

For rendering the results themselves use something like this:

```

            Id
            {{ filters.renderSortControls('entityalias.fieldname', 'Column Title')|raw }}
            {{ filters.renderSortControls('entityalias.createdAt', 'Created At')|raw }}

    {# The result object is iterable #}

        {% for product in products %}

                {{ product.id }}
                {{ product.fieldname }}
                {{ product.createdAt|date }}

        {% endfor %}

```

And that's it! You've got a full-featured list UI with pagination, sorting and searching.

Filter reference
----------------

[](#filter-reference)

Beside the built-in filters you can add your own by extending the base filters or the base ones like `AbstractFilter`. Please look at the code - it's really simple.

### AbstractFilter

[](#abstractfilter)

Base for other filters, not for direct usage.

**Options**

`callback`

Callable. If provided then it's used to apply the filter on the `QueryBuilder`. If not provided then the internal filtering mechanism is used.

`default_value`

Default value of the filter.

`label`

Label, by default created by humanizing the filter id.

`parameters`

Parameters which will be directly passed into the template

`joins`

The joins to add to query if this filter is applied.

Accepts an array of joins where each join is an array of this form:

```
['rootEntityAlias.fieldname', 'alias']

```

`template`

The template used for rendering.

### DateFilter

[](#datefilter)

*Extends `AbstractFilter`*

Presents a datepicker field.

**Options**

`empty_label`

Label to use when nothing is selected.

`empty_value`

Value when nothing is selected.

`strategy`

By default EQUAL strategy is used.

One of:

- DateFilter::STRATEGY\_EQUAL
- DateFilter::STRATEGY\_GREATHER\_THAN
- DateFilter::STRATEGY\_LESS\_THAN
- DateFilter::STRATEGY\_GREATHER\_THAN\_OR\_EQUAL
- DateFilter::STRATEGY\_LESS\_THAN\_OR\_EQUAL

`field`

The entity field that the filter will be applied to.

### StringFilter

[](#stringfilter)

*Extends `AbstractFilter`*

Present a text input. Allows searching multiple fields, using LIKE and more.

**Options**

`concat`

If true then the fields are concatenated before being searched.

`wildcard`

If true then a wildcard `*` is allowed (will be substitued with `%` in the query).

`fields`

One filed as string or a list of fields to search.

`exact`

If true, then an exact match is needed (`LIKE` is not used). If `concat` or `wildcard` is enabled then this is set to `false` by default. Otherwise the default is `true`.

### Choice filter

[](#choice-filter)

*Extends `AbstractFilter`*

Presents a dropdown list or tabs.

**Options**

`empty_label`

Label to use when nothing is selected.

`empty_value`

Value when nothing is selected.

`choices`

Array of choices of the form `[value => label]`.

`callback`

The callback is mandatory for this filter.

Use it like this:

```
new ChoiceFilter('id', [
    'choices' => [
        'black' => 'Dark',
        'white' => 'Light',
    ],
    'callback' => function (QueryBuilder $qb, $value) {
        if ($value) {
            $qb->andWhere('product.color = :choice')
               ->setParameter('choice', $value);
        }
    }
]);
```

`disabled`

Disable the filter?

`tabbed`

If true then tabs are used instead of dropdown list.

Paginator reference
-------------------

[](#paginator-reference)

### AbstractPaginator

[](#abstractpaginator)

Base paginator, not for direct usage.

TBD

### SimplePaginator

[](#simplepaginator)

Presents user with a sliding paginator which may be slow with a lot of items because it has to do `COUNT` queries.

options TBD

### OffsetPaginator

[](#offsetpaginator)

Paginator for very big lists. It only allows *next* and *previous* navigation without giving user the information of how many elements/pages are on the list.

options TBD

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity57

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 ~10 days

Total

2

Last Release

2665d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/6814811?v=4)[creativestyle](/maintainers/creativestyle)[@creativestyle](https://github.com/creativestyle)

---

Top Contributors

[![pinkeen](https://avatars.githubusercontent.com/u/2019132?v=4)](https://github.com/pinkeen "pinkeen (3 commits)")

---

Tags

searchsymfonybundlefilterlistadmin

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/creativestyle-admin-list-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/creativestyle-admin-list-bundle/health.svg)](https://phpackages.com/packages/creativestyle-admin-list-bundle)
```

###  Alternatives

[sonata-project/admin-bundle

The missing Symfony Admin Generator

2.1k19.0M299](/packages/sonata-project-admin-bundle)[2lenet/crudit-bundle

The easy like Crud'it Bundle.

1714.8k8](/packages/2lenet-crudit-bundle)[fsi/admin-bundle

FSi Admin Bundle. Admin generator for Symfony.

5849.2k7](/packages/fsi-admin-bundle)[arkounay/quick-admin-generator-bundle

QAG is a bundle that generates cruds admin for Symfony applications using Doctrine.

2510.4k](/packages/arkounay-quick-admin-generator-bundle)[wandi/easyadmin-plus-bundle

Wandi/EasyAdminPlusBundle

3926.1k](/packages/wandi-easyadmin-plus-bundle)[2lenet/easyadmin-plus-bundle

2lenet/EasyAdminPlusBundle

1718.0k](/packages/2lenet-easyadmin-plus-bundle)

PHPackages © 2026

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