Download the PHP package andanteproject/page-filter-form-bundle without Composer

Page Filter Form Bundle

Symfony Bundle - AndanteProject

A Symfony Bundle to simplify the handling of page filters for lists/tables in admin panels. 🧪

Requirements

Symfony 4.x-7.x and PHP 7.4-8.0.

Features

• Use Symfony Form;
• Keep you URL parameters clean as ?search=value&otherFilterName=anotherValue by default;
• Form will work even if you render form elements outside the form tag, around the web page, exactly where you need, avoiding nested form conflicts.
• Super easy to implement and maintains;
• Works like magic ✨.

How to install

After install, make sure you have the bundle registered in your symfony bundles list (config/bundles.php):

This should have been done automagically if you are using Symfony Flex. Otherwise, just register it by yourself.

The problem

Let's suppose you have this common admin panel controller with a page listing some Employee entities.

To add filters to this page, let's create a Symfony form.

Let's add this Form to our controller page:

The code above has some huge problems:

• 👎 Handling all this filter logic inside the controller is not a good idea. Sure, you can move it inside a dedicated service, but this means we are creating another file class alongside EmployeeFilterType to handle filters and this is not even solving this list's the second point;
• 👎 You need to carry around and match form elements names. search, senior and orderBy are keys you could store in some constants to don't repeat yourself, but this will drive you crazy as the filter logic grows.

The solution with Page Filter Form

Use Andante\PageFilterFormBundle\Form\PageFilterType as parent of your filter form (why?) and implement target_callback option on your form elements like this:

Implement Andante\PageFilterFormBundle\PageFilterFormTrait in you controller (or inject an argument Andante\PageFilterFormBundle\PageFilterManagerInterface as argument) and use form like this:

✅ Done!

• 👍 Controller is clean and easy to read;
• 👍 We have just one class taking care of filters;
• 👍 The option target_callback allows you to not repeat yourself carrying around form elements names;
• 👍 You can type-hint you callable 🥰 (check callback arguments);
• 👍 We got you covered solving possible nested form problems (how?);

"target_callback" option

target_callback

type: null or callable default: null

The callable is going to have 3 parameters (third is optional):

Why use PageFilterType as from Parent

You could avoid to use Andante\PageFilterFormBundle\Form\PageFilterType as parent for your form, but be aware it sets some useful default you may want to replicate:

Render the form in twig

As long as andante_smart_form_attr is true, you can render your form like this:

✅ form.perPage element work properly even outside form tag (how?!).

Give us a ⭐!

Built with love ❤️ by AndanteProject team.