Download the PHP package alterphp/easyadmin-extension-bundle without Composer

EasyAdmin Extension

EasyAdmin Extension provides some useful extensions to EasyAdmin admin generator for Symfony.

• Branch 3.x of this bundle requires at least PHP 7.1 and Symfony 4.2 components or stack and is suitable for EasyAdmin ^2.2.2 (Versions v2.2.0 and v2.2.1 are not allowed as they don't have native menu permissions). It allows installation of EasyAdmin 2.2.0 or upper and Symfony 5 as well. Extension bundle implementation of list filters is NOT COMPATIBLE with EasyAdmin dynamic list filters ! That's why we introduced the following change :

  :exclamation: BC BREAK list filters implemented by this extension bundle now use ext_filters query/form parameter, as filters is now used by native EasyAdmin for its own implementation of dynamic list filters.

• Branch 2.x of this bundle requires at least PHP 7.1 and Symfony 4.1 components or stack and is suitable for EasyAdmin 2.0.x and 2.1.x. It does not allow installation of EasyAdmin 2.2.0 or upper !

• Branch 1.x of this bundle requires at least PHP 7.0 and Symfony 3.0 components or stack and is suitable for EasyAdmin 1.x.

Features

• List filters form
• Register its own form types and aliases
• Embed lists in EDIT and SHOW views
• Autocomplete option to create related entity
• Role based access permissions
• Confirmation modal for custom POST actions (without form)
• Form fields by exclusion
• Vertical theme for SHOW view

Installation

Step 1: Download the Bundle

This command requires you to have Composer installed globally, as explained in the Composer documentation.

Step 2: Enable the Bundle

Step 3: Replace EasyAdmin controller

Instead of loading routes from EasyAdminBundle EasyAdminController, load them from EasyAdminExtensionBundle EasyAdminController.

If you have defined your own admin controllers, make them extend EasyAdminExtensionBundle EasyAdminController.

Features

List filters form

Add filters on list views by configuration.

Consider following Animation entity using such ValueListTrait :

Define your filters under list.form_filters entity configuration

Let's see the result !

Automatic list filter guesser

Guesser for list form filters are based on mapped entity property :

• boolean: guessed filter is a choice list (null, Yes, No)
• string: guessed filter is multiple choice list that requires either choices (value/label array) or choices_static_callback (static callback from entity class returning a value/label array) in type_options.
• integer, smallint, bigint: guessed filter is an integer input
• decimal, float: guessed filter is a number input
• *-to-one-relation: guessed filter is a multiple autocomplete of relation target entity.

Filters form's method is GET and submitted through form_filter parameter. It is transmitted to the referer used for post update/delete/create redirection AND for search !

List filter operator

By default, list filter use equals operator or in for multiple value filters.

But you can use more operators with the operator attribute :

Available built-in operators are listed in AlterPHP\EasyAdminExtensionBundle\Model\ListFilter class, as constant OPERATOR_* :

• equals: Is equal to
• not: Is different of
• in: Is in (array or Doctrine Collection expected)
• notin: Is not in (array or Doctrine Collection expected)
• gt: Is greater than
• gte: Is greater than or equal to
• lt: Is lower than
• lte: Is lower than or equal to
• like: Is LIKE %filterValue%

Filter list and search on request parameters

• EasyAdmin allows filtering list with dql_filter configuration entry. But this is not dynamic and must be configured as an apart list in easy_admin configuration.*

This extension allows to dynamically filter lists by adding ext_filters parameter in the URL parameters. Having a list of books at URL <url-to-admin>?action=list&entity=Book with a releaseYear field, you can filter on books releasd in 2016 by requesting <url-to-admin>?action=list&entity=Book&ext_filters[entity.releaseDate]=2016. It only matches exact values, but you can chain them. To request books released in 2015 and 2016, you must request <url-to-admin>?action=list&entity=Book&ext_filters[entity.releaseDate][]=2015&ext_filters[entity.releaseDate][]=2016.

This ext_filters parameter is transmitted to the referer used for post update/delete/create redirection AND for search !

Register your own form types with a short name (aliasing form types)

You have custom form types that you want to use in the EasyAdmin configuration. You can already register them with FQCN ... but it's quite boring and makes the admin massively enlarged. This feature allows you to define your own form types with short names, by configuration.

Let's see how to register them with those 2 examples (enum and statusable) :

Embed lists in edit and show views

Options

Embedded lists are useful to show relations to en entity in its NEW/EDIT/FORM or SHOW view. It relies on the LIST view of the related entities you want to embed in the parent EDIT/SHOW view. Options must be defined in type_options key for a NEW/EDIT/FORM view, or in template_options for a SHOW view.

Available options are :

• entity: Entity config name (key under the EasyAdmin entities config)
• ext_filters: Request filters to apply on the list
• hidden_fields: List of fields (columns) to hide from list fields config
• max_results: Number of items par page (list.max_results config is used if not defined)
• sort: Sort to apply
• parent_entity_fqcn: Parent entity FQCN in order to guess default filters (only when embedded in SHOW view, almost never required)
• parent_entity_property: Matching property name on parent entity FQCN (only when embedded in SHOW view, if property is not an ORM field)
• entity_fqcn: Listed entities FQCN in order to guess default filters (only when embedded in SHOW view, almost never required)

Options guesser based on ORM metadata

Service EmbeddedListHelper is intended to guess entity entry for embedded_list. It's reads ORM metadata, based on parent entity (the one that embeds the list) and property name.

It also guess default filter (relation between the parent and embedded list) for most of cases.

Edit view

Use pre-configured type embedded_list in the form definition :

But in many cases, the EmbeddedListHelper guesses __type_options__ for you, and you just have to write :

Let's see the result !

Show view

Using guesser for classic *ToMany relations :

Use following __template_options__ to pass options.

Disabling "Open in new tab" link at the bottom of embedded lists

• globally in config/packages/easy_admin_extension.yaml :

• by entity in config/packages/easy_admin.yaml :

Autocomplete add new option 'create' for modal in new and edit

Configure form type 'easyadmin_autocomplete', add type_options: { attr: { create: true } }

Define access permissions

Global minimum role access

You can define a minimum role to access the EasyAdmin controller (any action handled by the controller) :

This is just a global restriction, that should live with a security firewall as described in Symfony documentation.

Per entity action role permissions

You can also define role permissions per entity action :

Above configuration define a required role per action for Product entity. This is too verbose, isn't it ? Let's sum up as following :

Entity _roleprefix defines all actions required roles by appending the action name to the prefix.

Per entity field role permissions in form

You can also define role permissions per entity field in a form:

If user do not hold the required role, the form field will be disabled.

Confirmation modal for custom POST actions without form

A generic confirmation modal asks for confirmation (or any custom message) for links with data-confirm attribute (that may contain the custom message) and URL in data-href attribute.

Easy configurable with custom list actions by adding a confirm key :

To keep the confirmation modal behavior while creating a custom action template you need to use the action template provided by this bundle, replacing {{ include('@EasyAdmin/default/action.html.twig') }} by {{ include('@EasyAdminExtension/default/action.html.twig') }}.

Exclude fields in forms

In such entity:

It will show all fields but those mentioned in exclude_fields, equivalent to the following configuration:

Use template show vertical boostrap

Design EasyAdmin configuration:

Run tests

Run following command :

OR using Docker and Docker Compose :

Run code quality tools

PHP CS Fixer

Locally with Docker :

docker-compose run --rm php /app/vendor/bin/php-cs-fixer fix --config=/app/.php_cs /app/src

PHPStan

Locally with Docker :

docker-compose run --rm php /app/vendor/bin/phpstan analyse -c /app/phpstan.neon --level=5 /app/src

License

This software is published under the MIT License