### Install Flysystem Bundle

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/fields/FileField.rst

Install the Flysystem bundle and the adapter for your desired storage service using Composer.

```bash
$ composer require league/flysystem-bundle
```

--------------------------------

### Install PHP and JS Dependencies

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/AGENTS.md

Use these commands to install project dependencies for PHP and JavaScript.

```bash
composer install              # Install PHP dependencies
```

```bash
yarn install                  # Install JS dependencies
```

--------------------------------

### Install EasyAdmin Bundle

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/index.rst

Run this command to install the EasyAdmin bundle in your Symfony application. This is the primary installation method.

```bash
$ composer require easycorp/easyadmin-bundle
```

--------------------------------

### Install Money PHP Library

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/fields/MoneyField.rst

Install the Money PHP library using Composer to handle Money objects with EasyAdmin.

```bash
$ composer require moneyphp/money
```

--------------------------------

### Install EasyAdminBundle and Scaffold Controllers

Source: https://context7.com/easycorp/easyadminbundle/llms.txt

Use Composer to install the bundle and then Symfony's MakerBundle commands to generate the initial dashboard and CRUD controllers.

```bash
composer require easycorp/easyadmin-bundle

# Generate the dashboard (creates src/Controller/Admin/DashboardController.php)
php bin/console make:admin:dashboard

# Generate a CRUD controller for a Doctrine entity
php bin/console make:admin:crud
# → Select entity: App\Entity\Product
# → Creates src/Controller/Admin/ProductCrudController.php

# Visit /admin in your browser — done!
```

--------------------------------

### Install EasyAdminBundle and Generate Dashboard/CRUD

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/README.md

Install the EasyAdminBundle using Composer and then generate the admin dashboard and CRUD controllers. Visit /admin in your browser to see the result.

```bash
composer require easycorp/easyadmin-bundle
php bin/console make:admin:dashboard
php bin/console make:admin:crud
```

--------------------------------

### Install JS Dependencies and Check Code

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/AGENTS.md

Install JavaScript dependencies using yarn ci and check code style with Biome. Ensure both commands pass without errors.

```bash
yarn ci
```

```bash
yarn biome check --write
```

--------------------------------

### Install Flysystem AWS S3 Adapter

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/fields/FileField.rst

Install the specific Flysystem adapter for Amazon S3 using Composer.

```bash
$ composer require league/flysystem-aws-s3-v3
```

--------------------------------

### TextField Label Examples

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/fields.rst

Demonstrates different ways to set labels for TextField, including automatic generation, null, false, and explicit HTML content.

```php
TextField::new('firstName'),
    // label is null: generate it automatically (label = 'First Name')
    TextField::new('firstName', null),
```

```php
// label is false: no label is displayed and no <label> element is rendered
    TextField::new('firstName', false),
```

```php
// label is set explicitly: render its contents, including HTML tags
    TextField::new('firstName', 'Customer <b>Name</b>'),
```

--------------------------------

### Install Symfony ExpressionLanguage Component

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/security.rst

Install the necessary component for using complex security expressions. This is a prerequisite for advanced permission configurations.

```terminal
$ composer require symfony/expression-language
```

--------------------------------

### Example Custom Translation IDs

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/dashboards.rst

Example of how translations would look with the custom generator, using a simplified key structure.

```yaml
admin:
    entities:
        blogpost:
            singular: 'Blog Post'
            plural: 'Blog Posts'
            fields:
                title: 'Post Title'
```

--------------------------------

### Install Backend Assets Manually

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/design.rst

Run this command if assets are not automatically copied or symlinked to the public/bundles directory. Omit --symlink if your system does not support symbolic links.

```bash
# remove the --symlink option if your system doesn't support symbolic links
$ php bin/console assets:install --symlink
```

--------------------------------

### Functional Test Case Example for CategoryCrudController

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/tests.rst

Extend AbstractCrudTestCase and implement getControllerFqcn() and getDashboardFqcn() methods. Ensure user is logged in if security is enabled.

```php
namespace App\Tests\Admin\Controller;

use App\Controller\Admin\AppDashboardController;
use App\Controller\Admin\CategoryCrudController;
use EasyCorp\Bundle\EasyAdminBundle\Test\AbstractCrudTestCase;

final class CategoryCrudControllerTest extends AbstractCrudTestCase
{
    protected function getControllerFqcn(): string
    {
        return CategoryCrudController::class;
    }

    protected function getDashboardFqcn(): string
    {
        return AppDashboardController::class;
    }

    public function testIndexPage(): void
    {
        // this examples doesn't use security; in your application you may
        // need to ensure that the user is logged before the test
        $this->client->request("GET", $this->generateIndexUrl());
        static::assertResponseIsSuccessful();
    }
}
```

--------------------------------

### Create a Custom MapField

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/fields.rst

Example of creating a custom field class implementing FieldInterface, using FieldTrait, and configuring templates, form types, and assets.

```php
namespace App\Admin\Field;

use EasyCorp\Bundle\EasyAdminBundle\Contracts\Field\FieldInterface;
use EasyCorp\Bundle\EasyAdminBundle\Field\FieldTrait;
use Symfony\Component\Form\Extension\Core\Type\TextareaType;

final class MapField implements FieldInterface
{
    use FieldTrait;

    /**
     * @param TranslatableInterface|string|false|null $label
     */
    public static function new(string $propertyName, $label = null): self
    {
        return (new self())
            ->setProperty($propertyName)
            ->setLabel($label)

            // this template is used in 'index' and 'detail' pages
            ->setTemplatePath('admin/field/map.html.twig')

            // this is used in 'edit' and 'new' pages to edit the field contents
            // you can use your own form types too
            ->setFormType(TextareaType::class)
            ->addCssClass('field-map')

            // loads the CSS and JS assets associated to the given Webpack Encore entry
            // in any CRUD page (index/detail/edit/new). It's equivalent to calling
            // encore_entry_link_tags('...') and encore_entry_script_tags('...')
            ->addWebpackEncoreEntries('admin-field-map')

            // these methods allow you to define the web assets loaded when the
            // field is displayed in any CRUD page (index/detail/edit/new)
            ->addCssFiles('js/admin/field-map.css')
            ->addJsFiles('js/admin/field-map.js')
        ;
    }
}
```

--------------------------------

### Configure ChoiceFilter with Choices

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/filters.rst

Use ChoiceFilter for properties with a predefined set of options. This example sets up a 'status' filter with 'Draft', 'Published', and 'Archived' options.

```php
use EasyCorp\Bundle\EasyAdminBundle\Filter\ChoiceFilter;

$filters->add(ChoiceFilter::new('status')->setChoices([
    'Draft' => 'draft',
    'Published' => 'published',
    'Archived' => 'archived',
]));
```

--------------------------------

### Restricting Admin Route Availability

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/actions.rst

This example shows how to use the 'allowedDashboards' option with the #[AdminRoute] attribute to specify which EasyAdmin dashboards a route should be available in. Alternatively, 'deniedDashboards' can be used to exclude specific dashboards.

```php
use App\Controller\Admin\DashboardController;
use App\Controller\Admin\GuestDashboardController;
use EasyCorp\Bundle\EasyAdminBundle\Attribute\AdminRoute;

// Use the 'allowedDashboards' option to NOT generate a route for ANY dashboards
// except those listed explicitly:

#[AdminRoute('...', name: '...', allowedDashboards: [DashboardController::class, '...'])]
class BusinessStatsController extends AbstractController

// Use the 'deniedDashboards' option to generate a route for ALL dashboards
```

--------------------------------

### Configure CountryFilter with Specific Options

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/filters.rst

Implement CountryFilter for country code properties. This example restricts choices to 'US', 'CA', 'MX' and sets 'US' as a preferred option.

```php
use EasyCorp\Bundle\EasyAdminBundle\Filter\CountryFilter;

$filters->add(CountryFilter::new('country')
    ->includeOnly(['US', 'CA', 'MX'])
    ->preferredChoices(['US'])
);
```

--------------------------------

### Action Extension Implementation

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/actions.rst

An example of an Action Extension that can be used to dynamically add, remove, or modify actions in EasyAdmin CRUD controllers. The `supports` method determines when the extension is active.

```php
namespace App\Admin\Action\Extension;

use EasyCorp\Bundle\EasyAdminBundle\Config\Action;
use EasyCorp\Bundle\EasyAdminBundle\Config\Actions;
use EasyCorp\Bundle\EasyAdminBundle\Config\Crud;
use EasyCorp\Bundle\EasyAdminBundle\Context\AdminContext;
use EasyCorp\Bundle\EasyAdminBundle\Contracts\Action\ActionsExtensionInterface;

final class DuplicateActionExtension implements ActionsExtensionInterface
{
    // return true in this method to enable the extension for
    // the current backend request
    public function supports(AdminContext $context): bool
    {
        // enable the extension only on some pages
        return $context->getCrud()->getCurrentPage() === Crud::PAGE_DETAIL;

        // enable it on all except some entities
        $entityFqcn = $context->getCrud()->getEntityFqcn();
        return null !== $entityFqcn && !\in_array($entityFqcn, ['...'], true);

        // or use any other admin context data to make the decision
    }
}
```

--------------------------------

### Build Assets

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/AGENTS.md

Run the make build-assets command to compile and build project assets. This should complete successfully.

```bash
make build-assets
```

--------------------------------

### Add DateCalendarFilter to Entity

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/filters.rst

Example of adding a DateCalendarFilter to an entity's configuration. Ensure the necessary filter class is imported.

```php
use EasyCorp\Bundle\EasyAdminBundle\Controller\AbstractCrudController;
use EasyCorp\Bundle\EasyAdminBundle\Filter\BooleanFilter;

class UserCrudController extends AbstractCrudController
{
    // ...

    public function configureFilters(Filters $filters): Filters
    {
        return $filters
            // ...
            ->add(DateCalendarFilter::new('signupDate'))
        ;
    }
}
```

--------------------------------

### Set Upload Directory

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/fields/FileField.rst

The setUploadDir option is required to specify the directory where uploaded files will be stored. The path is relative to your project root. Failure to set this will result in an exception.

```php
yield FileField::new('...')->setUploadDir('public/uploads/files/');
```

--------------------------------

### Implement ProductCrudController with AbstractCrudController

Source: https://context7.com/easycorp/easyadminbundle/llms.txt

Extend AbstractCrudController to manage Product entities. Implement getEntityFqcn to link to the Product entity. Configure fields, CRUD settings, actions, and filters to customize the admin interface.

```php
<?php
// src/Controller/Admin/ProductCrudController.php
namespace App\Controller\Admin;

use App\Entity\Product;
use Doctrine\ORM\EntityManagerInterface;
use EasyCorp\Bundle\EasyAdminBundle\Config\Action;
use EasyCorp\Bundle\EasyAdminBundle\Config\Actions;
use EasyCorp\Bundle\EasyAdminBundle\Config\Crud;
use EasyCorp\Bundle\EasyAdminBundle\Config\Filters;
use EasyCorp\Bundle\EasyAdminBundle\Controller\AbstractCrudController;
use EasyCorp\Bundle\EasyAdminBundle\Field\AssociationField;
use EasyCorp\Bundle\EasyAdminBundle\Field\BooleanField;
use EasyCorp\Bundle\EasyAdminBundle\Field\IdField;
use EasyCorp\Bundle\EasyAdminBundle\Field\ImageField;
use EasyCorp\Bundle\EasyAdminBundle\Field\MoneyField;
use EasyCorp\Bundle\EasyAdminBundle\Field\TextField;
use EasyCorp\Bundle\EasyAdminBundle\Filter\BooleanFilter;
use EasyCorp\Bundle\EasyAdminBundle\Filter\EntityFilter;
use EasyCorp\Bundle\EasyAdminBundle\Filter\NumericFilter;

class ProductCrudController extends AbstractCrudController
{
    public static function getEntityFqcn(): string
    {
        return Product::class;
    }

    public function configureCrud(Crud $crud): Crud
    {
        return $crud
            ->setEntityLabelInSingular('Product')
            ->setEntityLabelInPlural('Products')
            ->setPageTitle('index', '%entity_label_plural% List')
            ->setDefaultSort(['createdAt' => 'DESC'])
            ->setSearchFields(['name', 'description', 'sku'])
            ->setPaginatorPageSize(20)
            ->showEntityActionsInlined();
    }

    public function configureFields(string $pageName): iterable
    {
        yield IdField::new('id')->hideOnForm();
        yield TextField::new('name')->setMaxLength(100);
        yield TextField::new('description')->onlyOnForms()->setRequired(false);
        yield MoneyField::new('price')->setCurrency('USD');
        yield BooleanField::new('published');
        yield AssociationField::new('category')
            ->autocomplete()
            ->setQueryBuilder(fn ($qb) => $qb->andWhere('entity.active = true'));
        yield ImageField::new('photo')
            ->setBasePath('/uploads/products')
            ->setUploadDir('public/uploads/products')
            ->setUploadedFileNamePattern('[slug]-[contenthash].[extension]')
            ->onlyOnForms();
    }

    public function configureActions(Actions $actions): Actions
    {
        $exportAction = Action::new('export', 'Export CSV', 'fa fa-download')
            ->linkToRoute('admin_product_export')
            ->createAsGlobalAction()
            ->addCssClass('btn btn-secondary');

        return $actions
            ->add(Crud::PAGE_INDEX, Action::DETAIL)
            ->add(Crud::PAGE_INDEX, $exportAction)
            ->remove(Crud::PAGE_DETAIL, Action::DELETE)
            ->setPermission(Action::DELETE, 'ROLE_SUPER_ADMIN')
            ->reorder(Crud::PAGE_INDEX, [Action::DETAIL, Action::EDIT, Action::DELETE]);
    }

    public function configureFilters(Filters $filters): Filters
    {
        return $filters
            ->add('name')
            ->add(BooleanFilter::new('published'))
            ->add(NumericFilter::new('price'))
            ->add(EntityFilter::new('category'));
    }

    // Hook into entity lifecycle without overriding the whole action
    public function persistEntity(EntityManagerInterface $entityManager, mixed $entityInstance): void
    {
        $entityInstance->setCreatedAt(new \DateTimeImmutable());
        parent::persistEntity($entityManager, $entityInstance);
    }
}
```

--------------------------------

### Basic Association Field Usage

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/fields/AssociationField.rst

This is a basic example of how to define an AssociationField. It's used to link one entity to another.

```php
yield AssociationField::new('...')
```

--------------------------------

### Run Full Pre-PR Check Suite

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/AGENTS.md

Execute the comprehensive 'checks-before-pr' make target to ensure all checks pass before creating a pull request.

```bash
make checks-before-pr
```

--------------------------------

### MaskedEmailConfigurator Implementation

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/fields.rst

An example of a custom field configurator that masks email addresses on the index page but shows the full address on other pages.

```php
namespace App\Admin\Configurator;

use EasyCorp\Bundle\EasyAdminBundle\Config\Crud;
use EasyCorp\Bundle\EasyAdminBundle\Context\AdminContext;
use EasyCorp\Bundle\EasyAdminBundle\Contracts\Field\FieldConfiguratorInterface;
use EasyCorp\Bundle\EasyAdminBundle\Dto\EntityDto;
use EasyCorp\Bundle\EasyAdminBundle\Dto\FieldDto;
use EasyCorp\Bundle\EasyAdminBundle\Field\EmailField;

final class MaskedEmailConfigurator implements FieldConfiguratorInterface
{
    public function supports(FieldDto $field, EntityDto $entityDto): bool
    {
        return EmailField::class === $field->getFieldFqcn();
    }

    public function configure(FieldDto $field, EntityDto $entityDto, AdminContext $context): void
    {
        if (Crud::PAGE_INDEX !== $context->getCrud()->getCurrentPage()) {
            return;
        }

        $email = (string) $field->getValue();
        if (!str_contains($email, '@')) {

```

--------------------------------

### Set Upload Directory

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/fields/ImageField.rst

Use setUploadDir to change the default directory where uploaded image contents are stored. The argument is relative to your project root.

```php
yield ImageField::new('...')->setUploadDir('assets/images/');
```

--------------------------------

### Define Custom Field in CRUD Controller

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/fields.rst

Example of how to use a custom field (MapField) within the configureFields method of a CRUD controller.

```php
use App\Admin\MapField;

public function configureFields(string $pageName): iterable
{
    return [
        // ...
        MapField::new('shipAddress'),
    ];
}
```

--------------------------------

### Running Customization Tests

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/tests/Functional/Customization/README.md

Commands to execute various levels of customization tests.

```bash
php vendor/bin/phpunit tests/Functional/Customization/

```

```bash
php vendor/bin/phpunit tests/Functional/Customization/Dashboard/

```

```bash
php vendor/bin/phpunit tests/Functional/Customization/Crud/

```

```bash
php vendor/bin/phpunit tests/Functional/Customization/Crud/Formatting/

```

```bash
php vendor/bin/phpunit tests/Functional/Customization/Crud/Search/

```

```bash
php vendor/bin/phpunit tests/Functional/Customization/Crud/Pagination/

```

--------------------------------

### Format Integer Field with sprintf

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/fields/IntegerField.rst

Use setNumberFormat to format integer values using sprintf() syntax. This example shows scientific notation.

```php
yield IntegerField::new('...')->setNumberFormat('%e');
```

--------------------------------

### Add Text Filter

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/filters.rst

Adds a text filter for string and text properties. It supports operators such as contains, starts with, ends with, and empty checks.

```php
use EasyCorp\Bundle\EasyAdminBundle\Filter\TextFilter;

$filters->add(TextFilter::new('title'));
```

--------------------------------

### Configure Dashboard Settings

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/dashboards.rst

Use the `configureDashboard()` method to set various options for the main dashboard. This includes the visible title, favicon, translation domain, text direction, content maximization, sidebar minimization, dark mode, default color scheme, relative URL generation, and locale settings.

```php
namespace App\Controller\Admin;

use EasyCorp\Bundle\EasyAdminBundle\Attribute\AdminDashboard;
use EasyCorp\Bundle\EasyAdminBundle\Config\Dashboard;
use EasyCorp\Bundle\EasyAdminBundle\Controller\AbstractDashboardController;
use EasyCorp\Bundle\EasyAdminBundle\Dto\LocaleDto;

#[AdminDashboard(routePath: '/admin', routeName: 'admin')]
class DashboardController extends AbstractDashboardController
{
    // ...

    public function configureDashboard(): Dashboard
    {
        return Dashboard::new()
            // the name visible to end users
            ->setTitle('ACME Corp.')
            // you can include HTML contents too (e.g. to link to an image)
            ->setTitle('<img src="..."> ACME <span class="text-small">Corp.</span>')

            // by default EasyAdmin displays a black square as its default favicon;
            // use this method to display a custom favicon: the given path is passed
            // "as is" to the Twig asset() function:
            // <link rel="shortcut icon" href="{{ asset('...') }}">
            ->setFaviconPath('favicon.svg')

            // the domain used by default is 'messages'
            ->setTranslationDomain('my-custom-domain')

            // there's no need to define the "text direction" explicitly because
            // its default value is inferred dynamically from the user locale
            ->setTextDirection('ltr')

            // set this option if you prefer the page content to span the entire
            // browser width, instead of the default design which sets a max width
            ->renderContentMaximized()

            // set this option if you prefer the sidebar (which contains the main menu)
            // to be displayed as a narrow column instead of the default expanded design
            ->renderSidebarMinimized()

            // by default, users can select between a "light" and "dark" mode for the
            // backend interface. Call this method if you prefer to disable the "dark"
            // mode for any reason (e.g. if your interface customizations are not ready for it)
            ->disableDarkMode()

            // by default, the UI color scheme is 'auto', which means that the backend
            // will use the same mode (light/dark) as the operating system and will
            // change in sync when the OS mode changes.
            // Use this option to set which mode ('light', 'dark' or 'auto') will users see
            // by default in the backend (users can change it via the color scheme selector)
            ->setDefaultColorScheme('dark')
            // instead of magic strings, you can use constants as the value of
            // this option: EasyCorp\Bundle\EasyAdminBundle\Config\Option\ColorScheme::DARK

            // by default, all backend URLs are generated as absolute URLs. If you
            // need to generate relative URLs instead, call this method
            ->generateRelativeUrls()

            // set this option if you want to enable locale switching in dashboard.
            // IMPORTANT: this feature won't work unless you add the {_locale}
            // parameter in the admin dashboard URL (e.g. '/admin/{_locale}').
            // the name of each locale will be rendered in that locale
            // (in the following example you'll see: "English", "Polski")
            ->setLocales(['en', 'pl'])
            // to customize the labels of locales, pass a key => value array
            // (e.g. to display flags; although it's not a recommended practice,
            // because many languages/locales are not associated to a single country)
            ->setLocales([
                'en' => '🇬🇧 English',
                'pl' => '🇵🇱 Polski'
            ])
            // to further customize the locale option, pass an instance of
            // EasyCorp\Bundle\EasyAdminBundle\Config\Locale
            ->setLocales([
                'en', // locale without custom options
                Locale::new('pl', 'polski', 'far fa-language') // custom label and icon
            ])
        ;
    }
}
```

--------------------------------

### Enable EasyAdmin Pretty URLs

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/UPGRADE.md

Configure EasyAdmin routes by creating or updating the 'config/routes/easyadmin.yaml' file. This is automatically handled if using Symfony Flex.

```yaml
easyadmin:
    resource: .
    type: easyadmin.routes
```

--------------------------------

### Add Batch Action Configuration

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/actions.rst

Configure a new batch action named 'approve' with a custom label, link, CSS class, and icon.

```php
namespace App\Controller\Admin;

use EasyCorp\Bundle\EasyAdminBundle\Config\Action;
use EasyCorp\Bundle\EasyAdminBundle\Config\Actions;
use EasyCorp\Bundle\EasyAdminBundle\Controller\AbstractCrudController;

class UserCrudController extends AbstractCrudController
{
    // ...

    public function configureActions(Actions $actions): Actions
    {
        return $actions
            // ...
            ->addBatchAction(Action::new('approve', 'Approve Users')
                ->linkToCrudAction('approveUsers')
                ->addCssClass('btn btn-primary')
                ->setIcon('fa fa-user-check'))
        ;
    }
}
```

--------------------------------

### TextField Advanced Web Asset Configuration

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/fields.rst

Demonstrates advanced configuration of web assets for a TextField using the Asset class, including ignoring on forms, only on index, and preloading.

```php
use EasyCorp\Bundle\EasyAdminBundle\Config\Asset;
// ...

    TextField::new('firstName', 'Name')
        ->addCssFiles(Asset::new('bundle/some-bundle/foo.css')->ignoreOnForm()->htmlAttr('media', 'print'))
        ->addJsFiles(Asset::new('admin/some-custom-code.js')->onlyOnIndex()->defer())
        ->addWebpackEncoreEntries(Asset::new('admin-maps')->onlyWhenCreating()->preload())
        // you can even define the Symfony Asset package which the asset belongs to
        ->addCssFiles(Asset::new('some-path/bar.css')->package('legacy_assets'))
```

--------------------------------

### Set Thousands Separator for Integer Field

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/fields/IntegerField.rst

Use setThousandsSeparator to specify a character for separating thousands groups in integer values. This example uses a space.

```php
yield IntegerField::new('...')->setThousandsSeparator(' ');
```

--------------------------------

### Keep Replaced File or Fail Behavior

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/fields/FileField.rst

Configure to keep the old file on disk, but throw an error if the new file's name conflicts with an existing file.

```php
yield FileField::new('...')->keepReplacedFileOrFail();
```

--------------------------------

### Add Timezone Filter for Specific Country

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/filters.rst

Adds a timezone filter that displays a dropdown of timezone names. This example restricts the choices to timezones of a specific country.

```php
use EasyCorp\Bundle\EasyAdminBundle\Filter\TimezoneFilter;

// show only timezones for a specific country
$filters->add(TimezoneFilter::new('timezone')->forCountryCode('US'));
```

--------------------------------

### Format Integer Field with Padding

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/fields/IntegerField.rst

Use setNumberFormat to format integer values using sprintf() syntax. This example shows left padding with zeros and a sign.

```php
yield IntegerField::new('...')->setNumberFormat('%+06d');
```

--------------------------------

### Display Fields Using Property Names (Strings)

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/fields.rst

Return strings with the names of the properties to display. EasyAdmin creates fields automatically for them.

```php
public function configureFields(string $pageName): iterable
{
    return [
        'title',
        'description',
        'price',
        'stock',
        'publishedAt',
    ];
}
```

--------------------------------

### Include EasyAdmin Templates in Twig

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/crud.rst

Use the `ea.templatePath()` function in Twig to get the path for a given template name, allowing customization while keeping templates flexible.

```twig
<div id="flash-messages">
    {{ include(ea.templatePath('flash_messages')) }}
</div>

{% if some_value is null %}
    {{ include(ea.templatePath('label/null')) }}
{% endif %}
```

--------------------------------

### Configure Menu Items with Permissions

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/security.rst

Conditionally yield menu items based on user roles and other criteria. Ensure necessary imports and context are available.

```php
public function configureMenuItems(): iterable
{
    yield MenuItem::linkToDashboard('Dashboard', 'fa fa-home');

    if ($this->isGranted('ROLE_EDITOR') && '...') {
        yield MenuItem::linkTo(BlogPostCrudController::class, 'Blog Posts');
    }

    // ...
}
```

--------------------------------

### Validate Documentation Syntax

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/AGENTS.md

Run make linter-docs to validate the syntax of documentation files written in RST format.

```bash
make linter-docs
```

--------------------------------

### Configure Assets in EasyAdmin

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/design.rst

Use the configureAssets method to import assetmapper entries, Webpack Encore entries, CSS files, and JavaScript files. You can also add raw HTML content to the head or body. This method is part of the AbstractCrudController.

```php
use EasyCorp\Bundle\EasyAdminBundle\Controller\AbstractCrudController;
use EasyCorp\Bundle\EasyAdminBundle\Config\Assets;

class ProductCrudController extends AbstractCrudController
{
    // ...

    public function configureAssets(Assets $assets): Assets
    {
        return $assets
            // imports the given entrypoint defined in the importmap.php file of AssetMapper
            // it's equivalent to adding this inside the <head> element:
            // {{ importmap('admin') }}
            ->addAssetMapperEntry('admin')
            // you can also import multiple entries
            // it's equivalent to calling {{ importmap(['app', 'admin']) }}
            ->addAssetMapperEntry('app', 'admin')

            // adds the CSS and JS assets associated to the given Webpack Encore entry
            // it's equivalent to adding these inside the <head> element:
            // {{ encore_entry_link_tags('...') }} and {{ encore_entry_script_tags('...') }}
            ->addWebpackEncoreEntry('admin-app')

            // it's equivalent to adding this inside the <head> element:
            // <link rel="stylesheet" href="{{ asset('...') }}">
            ->addCssFile('build/admin.css')
            ->addCssFile('https://example.org/css/admin2.css')

            // it's equivalent to adding this inside the <head> element:
            // <script src="{{ asset('...') }}"></script>
            ->addJsFile('build/admin.js')
            ->addJsFile('https://example.org/js/admin2.js')

            // use these generic methods to add any code before </head> or </body>
            // the contents are included "as is" in the rendered page (without escaping them)
            ->addHtmlContentToHead('<link rel="dns-prefetch" href="https://assets.example.com">')
            ->addHtmlContentToBody('<script> ... </script>')
            ->addHtmlContentToBody('<!-- generated at '.time().' -->')
        ;
    }
}
```

--------------------------------

### Custom Redirect After Saving Entity

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/crud.rst

Implement custom redirect logic after saving an entity by overriding `getRedirectResponseAfterSave()`. This example redirects to a detail page if a specific button was clicked.

```php
protected function getRedirectResponseAfterSave(AdminContext $context, string $action): RedirectResponse
{
    $submitButtonName = $context->getRequest()->request->all()['ea']['newForm']['btn'];

    if ('saveAndViewDetail' === $submitButtonName) {
        return $this->redirectToRoute('admin_product_detail', [
            'entityId' => $context->getEntity()->getPrimaryKeyValue(),
        ]);
    }

    return parent::getRedirectResponseAfterSave($context, $action);
}
```

--------------------------------

### Define Entity Translations (YAML)

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/dashboards.rst

Example of defining entity and property translations using YAML format for the `messages.en.yaml` translation file. This format is used when `useEntityTranslations()` is enabled.

```yaml
# translations/messages.en.yaml
entities:
    App\Entity\BlogPost:
        singular: 'Blog Post'
        plural: 'Blog Posts'
        properties:
            title: 'Post Title'
            publishedAt: 'Publication Date'
            isPublished: 'Published?'
```

--------------------------------

### TextField Form Theme Configuration

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/fields.rst

Shows how to add specific form themes to a TextField for custom rendering.

```php
TextField::new('firstName', 'Name')
        // use this method if your field needs a specific form theme to render properly
        ->addFormTheme('@FOSCKEditor/Form/ckeditor_widget.html.twig')
        // you can add more than one form theme using the same method
        ->addFormTheme('theme1.html.twig', 'theme2.html.twig', 'theme3.html.twig')
```

--------------------------------

### Configure Dashboard Settings

Source: https://context7.com/easycorp/easyadminbundle/llms.txt

Extend `AbstractDashboardController` and override `configureDashboard()` to set the admin panel's title, favicon, color scheme, and layout.

```php
<?php
// src/Controller/Admin/DashboardController.php
namespace App\Controller\Admin;

use App\Entity\Category;
use App\Entity\Product;
use App\Entity\User;
use EasyCorp\Bundle\EasyAdminBundle\Attribute\AdminDashboard;
use EasyCorp\Bundle\EasyAdminBundle\Config\Assets;
use EasyCorp\Bundle\EasyAdminBundle\Config\Crud;
use EasyCorp\Bundle\EasyAdminBundle\Config\Dashboard;
use EasyCorp\Bundle\EasyAdminBundle\Config\MenuItem;
use EasyCorp\Bundle\EasyAdminBundle\Config\UserMenu;
use EasyCorp\Bundle\EasyAdminBundle\Config\Option\ColorScheme;
use EasyCorp\Bundle\EasyAdminBundle\Controller\AbstractDashboardController;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Security\Core\User\UserInterface;

#[AdminDashboard(routePath: '/admin', routeName: 'admin')]
class DashboardController extends AbstractDashboardController
{
    public function index(): Response
    {
        // Redirect to the first CRUD controller on login
        return $this->redirectToRoute('admin', [
            'crudAction' => 'index',
            'crudControllerFqcn' => ProductCrudController::class,
        ]);
    }

    public function configureDashboard(): Dashboard
    {
        return Dashboard::new()
            ->setTitle('My Shop Admin')
            ->setFaviconPath('favicon.ico')
            ->setDefaultColorScheme(ColorScheme::AUTO) // 'light', 'dark', or 'auto'
            ->renderContentMaximized()                  // use full-width layout
            ->generateRelativeUrls();
    }

    public function configureMenuItems(): iterable
    {
        yield MenuItem::linkToDashboard('Dashboard', 'fa fa-home');
        yield MenuItem::section('Catalog');
        yield MenuItem::linkTo('Products', 'fa fa-tag', ProductCrudController::class);
        yield MenuItem::linkTo('Categories', 'fa fa-folder', CategoryCrudController::class);
        yield MenuItem::section('Users');
        yield MenuItem::linkTo('Users', 'fa fa-user', UserCrudController::class);
        yield MenuItem::section();
        yield MenuItem::linkToUrl('Documentation', 'fa fa-book', 'https://symfony.com/bundles/EasyAdminBundle');
        yield MenuItem::linkToRoute('Back to site', 'fa fa-arrow-left', 'app_homepage');
    }

    public function configureUserMenu(UserInterface $user): UserMenu
    {
        return parent::configureUserMenu($user)
            ->setAvatarUrl('https://ui-avatars.com/api/?name='.$user->getUserIdentifier())
            ->addMenuItems([
                MenuItem::linkToRoute('My Profile', 'fa fa-id-card', 'app_profile'),
            ]);
    }

    public function configureCrud(): Crud
    {
        return Crud::new()
            ->setDateFormat('dd/MM/yyyy')
            ->setTimeFormat('HH:mm')
            ->setPaginatorPageSize(30)
            ->setDefaultSort(['id' => 'DESC']);
    }

    public function configureAssets(): Assets
    {
        return Assets::new()
            ->addCssFile('css/admin-custom.css')
            ->addJsFile('js/admin-custom.js');
    }
}

```

--------------------------------

### Update Action Properties

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/actions.rst

Use the `update()` method with a callable to modify built-in actions. This example changes the icon and removes the label for the `Action::NEW` on `Crud::PAGE_INDEX`.

```php
use EasyCorp\Bundle\EasyAdminBundle\Config\Action;
use EasyCorp\Bundle\EasyAdminBundle\Config\Actions;
use EasyCorp\Bundle\EasyAdminBundle\Config\Crud;

public function configureActions(Actions $actions): Actions
{
    return $actions
        // ...
        ->update(Crud::PAGE_INDEX, Action::NEW, 
            static fn (Action $action) => $action->setIcon('fa fa-file-alt')->setLabel(false)
        )
    ;
}
```

--------------------------------

### Set File Validation Constraints

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/fields/FileField.rst

Use setFileConstraints to define validation rules for uploaded files. By default, no constraints are applied. This example sets the filename charset to ASCII.

```php
use Symfony\Component\Validator\Constraints\File;

yield FileField::new('...')->setFileConstraints(new File(filenameCharset: 'ASCII'));
```

--------------------------------

### Set Uploaded File Name Pattern with Closure

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/fields/ImageField.rst

The setUploadedFileNamePattern method also accepts a closure that receives the Symfony UploadedFile instance as its first argument.

```php
yield ImageField::new('...')->setUploadedFileNamePattern(
    
```

--------------------------------

### Define Entity Translations (PHP Array)

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/dashboards.rst

Example of defining entity and property translations using PHP arrays for the `messages.en.php` translation file. This format is used when `useEntityTranslations()` is enabled.

```php
// translations/messages.en.php
return [
    'entities' => [
        App\Entity\BlogPost::class => [
            'singular' => 'Blog Post',
            'plural' => 'Blog Posts',
            'properties' => [
                'title' => 'Post Title',
                'publishedAt' => 'Publication Date',
                'isPublished' => 'Published?',
            ],
        ],
        App\Entity\User::class => [
            'singular' => 'User',
            'plural' => 'Users',
            'properties' => [
                'email' => 'Email Address',
                'createdAt' => 'Registration Date',
            ],
        ],
    ],
];
```

--------------------------------

### Configure Search Mode

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/crud.rst

Define how search terms are matched. ALL_TERMS requires all terms to match, ANY_TERMS requires at least one term to match.

```php
->setSearchMode(SearchMode::ALL_TERMS)
            // use the SearchMode::ANY_TERMS option to change the search mode to
            // match at least one of the terms:
            // term1 in (field1 or field2) OR term2 in (field1 or field2)
            // e.g. if you look for 'lorem ipsum' in [title, description],
            // results will match either 'lorem' in title or description (or both)
            // OR 'ipsum' in title or description (or both)
            ->setSearchMode(SearchMode::ANY_TERMS)
```

--------------------------------

### Implement Event Subscriber for EasyAdmin

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/events.rst

Use an event subscriber to hook into EasyAdmin's Symfony events. This example shows how to set a 'slug' property before persisting a 'BlogPost' entity.

```php
namespace App\EventSubscriber;

use App\Entity\BlogPost;
use EasyCorp\Bundle\EasyAdminBundle\Event\BeforeEntityPersistedEvent;
use Symfony\Component\EventDispatcher\EventSubscriberInterface;

class EasyAdminSubscriber implements EventSubscriberInterface
{
    private $slugger;

    public function __construct($slugger)
    {
        $this->slugger = $slugger;
    }

    public static function getSubscribedEvents()
    {
        return [
            BeforeEntityPersistedEvent::class => ['setBlogPostSlug'],
        ];
    }

    public function setBlogPostSlug(BeforeEntityPersistedEvent $event)
    {
        $entity = $event->getEntityInstance();

        if (!($entity instanceof BlogPost)) {
            return;
        }

        $slug = $this->slugger->slugify($entity->getTitle());
        $entity->setSlug($slug);
    }
}
```

--------------------------------

### Twig Form Fragment for Custom Widget

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/design.rst

Example of a Twig template fragment to customize the widget for a specific form field, following Symfony's form fragment naming conventions.

```twig
{# templates/admin/form.html.twig #}
{# note that the Twig block name starts with an uppercase letter
   ('_Product_...' instead of '_product_...') because the first part
   of the block name is the unmodified entity name #}
{% block _Product_custom_title_widget %}
    {# ... #}
    <a href="...">More information</a>
{% endblock %}
```

--------------------------------

### Configure Assets in EasyAdmin

Source: https://context7.com/easycorp/easyadminbundle/llms.txt

Use `configureAssets()` to inject custom CSS, JS, Webpack Encore entries, or AssetMapper imports. This can be configured globally in the Dashboard or per-CRUD-controller.

```php
<?php
use EasyCorp\Bundle\EasyAdminBundle\Config\Asset;
use EasyCorp\Bundle\EasyAdminBundle\Config\Assets;

// In DashboardController (applies to all pages)
public function configureAssets(): Assets
{
    return Assets::new()
        ->addCssFile('css/admin-custom.css')
        ->addJsFile('js/admin-extra.js')
        // Webpack Encore
        ->addWebpackEncoreEntry('admin-theme')
        ->addWebpackEncoreEntry(
            Asset::fromEasyAdminAssetPackage('app')->onlyOnIndex()
        )
        // AssetMapper
        ->addAssetMapperEntry('admin/charts')
        // Inline HTML in <head> or before </body>
        ->addHtmlContentToHead('<link rel="preconnect" href="https://fonts.googleapis.com">')
        ->addHtmlContentToBody('<script>console.log("admin loaded");</script>');
}

// In a CrudController (applies only to this CRUD's pages)
public function configureAssets(Assets $assets): Assets
{
    return $assets
        ->addCssFile(
            Asset::new('css/product-admin.css')->onlyOnForms()
        )
        ->addJsFile(
            Asset::new('js/product-gallery.js')->onlyOnDetail()
        );
}
```

--------------------------------

### Build Admin URLs Dynamically with AdminUrlGenerator

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/crud.rst

Use the AdminUrlGenerator service to build backend URLs dynamically. It reuses existing query parameters from the current request.

```php
namespace App\Controller\Admin;

use EasyCorp\Bundle\EasyAdminBundle\Controller\AbstractCrudController;
use EasyCorp\Bundle\EasyAdminBundle\Router\AdminUrlGenerator;

class SomeCrudController extends AbstractCrudController
{
    private $adminUrlGenerator;

    public function __construct(AdminUrlGenerator $adminUrlGenerator)
    {
        $this->adminUrlGenerator = $adminUrlGenerator;
    }

    // ...

    public function someMethod()
    {
        // instead of injecting the AdminUrlGenerator service in the constructor,
        // you can also get it from inside a controller action as follows:
        // $adminUrlGenerator = $this->container->get(AdminUrlGenerator::class);

        // the existing query parameters are maintained, so you only
        // have to pass the values you want to change.
        $url = $this->adminUrlGenerator->set('page', 2)->generateUrl();

        // you can remove existing parameters
        $url = $this->adminUrlGenerator->unset('page')->generateUrl();
        $url = $this->adminUrlGenerator->unsetAll()->set('foo', 'someValue')->generateUrl();

        // the URL builder provides shortcuts for the most common parameters
        $url = $this->adminUrlGenerator
            ->setController(SomeCrudController::class)
            ->setAction('theActionName')
            ->generateUrl();

        // ...
    }
}
```

--------------------------------

### Generate Basic CRUD Controller

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/crud.rst

Use this command to generate the basic structure for a new CRUD controller.

```terminal
    $ php bin/console make:admin:crud
```

--------------------------------

### Getting AdminContext via AdminContextProvider Service

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/dashboards.rst

Inject the AdminContextProvider service into your custom services to retrieve the current AdminContext object. This is necessary because the context is created dynamically per request and cannot be directly injected.

```php
use EasyCorp\Bundle\EasyAdminBundle\Provider\AdminContextProvider;

final class SomeService
{
    private $adminContextProvider;

    public function __construct(AdminContextProvider $adminContextProvider)
    {
        $this->adminContextProvider = $adminContextProvider;
    }

    public function someMethod()
    {
        $context = $this->adminContextProvider->getContext();
    }

    // ...
}
```

--------------------------------

### Set Custom String Method for CollectionField Entries

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/fields/CollectionField.rst

Use `setEntryToStringMethod()` to define a specific method on the entity that EasyAdmin should call to get the string representation of each collection entry. Alternatively, a callable can be provided.

```php
// this calls the 'getFullName()' method in the entity
yield CollectionField::new('...')->setEntryToStringMethod('getFullName');

// you can also pass a callable to generate the string
```

--------------------------------

### Run All PHPUnit Tests

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/AGENTS.md

Execute all unit and functional tests using simple-phpunit. This is a comprehensive check for code correctness.

```bash
./vendor/bin/simple-phpunit
```

--------------------------------

### Configure Menu Items without Labels

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/dashboards.rst

Example of configuring menu items for CRUD controllers when entity translations are enabled. The label is omitted as EasyAdmin will automatically use the translated plural label for the entity.

```php
public function configureMenuItems(): iterable
{
    yield MenuItem::linkToDashboard('Dashboard', 'fa fa-home');

    // no label needed: will use the translated plural label
    yield MenuItem::linkTo(BlogPostCrudController::class, icon: 'fa fa-file-text');
    yield MenuItem::linkTo(UserCrudController::class, icon: 'fa fa-users');
}
```

--------------------------------

### Extend EasyAdmin Layout Template

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/design.rst

When overriding EasyAdmin Twig templates, use the '!' prefix in the extends statement to prevent infinite loops. This example shows how to extend the base layout and override the sidebar block.

```twig
{# templates/bundles/EasyAdminBundle/layout.html.twig #}

{# DON'T DO THIS: it will cause an infinite loop #}
{% extends '@EasyAdmin/layout.html.twig' %}

{# DO THIS: the '!' symbol tells Symfony to extend from the original template #}
{% extends '@!EasyAdmin/layout.html.twig' %}

{% block sidebar %}
    {# ... #}
{% endblock %}
```

--------------------------------

### Configure TextField Options

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/fields.rst

Set various options for a TextField, including sortability, help messages, form type, and HTML attributes.

```php
TextField::new('firstName', 'Name')
    // if TRUE, listing can be sorted by this field (default: TRUE)
    // unmapped fields cannot be sorted
    ->setSortable(false)

    // help message displayed for this field in the 'detail', 'edit' and 'new' pages
    ->setHelp('...')

    // sets the value of the `empty_data` option in the Symfony form
    // see https://symfony.com/doc/current/reference/forms/types/form.html#empty-data
    ->setEmptyData('Jane Doe')

    // the Symfony Form type used to render this field in 'edit'/'new' pages
    // (fields have good default values for this option, so you don't usually configure this)
    ->setFormType(TextType::class)

    // an array of parameters passed to the Symfony form type
    // (this only overrides the values of the passed form type options;
    // it leaves all the other existing type options unchanged)
    ->setFormTypeOptions(['option_name' => 'option_value'])

    // a custom HTML attribute added when rendering the field
    // e.g. setHtmlAttribute('data-foo', 'bar') renders a 'data-foo="bar"' attribute in HTML
    // On 'index' and 'detail' pages, the attribute is added to the field container:
    // <td> and div.field-group respectively
    // On 'new' and 'edit' pages, the attribute is added to the form field;
    // it's a shortcut for the equivalent setFormTypeOption('attr.data-foo', 'bar)
    ->setHtmlAttribute('attribute_name', 'attribute_value')

    // a key-value array of attributes to add to the HTML element
    ->setHtmlAttributes(['data-foo' => 'bar', 'autofocus' => 'autofocus'])
```

--------------------------------

### Add a New Row for Fields

Source: https://github.com/easycorp/easyadminbundle/blob/5.x/doc/fields.rst

Use `FormField::addRow()` to explicitly start a new row in the form layout. This ensures that subsequent fields render on a new line, regardless of available space in the current row.

```php
use EasyCorp\Bundle\EasyAdminBundle\Field\BooleanField;
use EasyCorp\Bundle\EasyAdminBundle\Field\DateTimeField;
use EasyCorp\Bundle\EasyAdminBundle\Field\FormField;

public function configureFields(string $pageName): iterable
{
    return [
        // ...,

        DateTimeField::new('startsAt')->setColumns('col-sm-6 col-lg-5 col-xxl-3'),
        DateTimeField::new('endsAt')->setColumns('col-sm-6 col-lg-5 col-xxl-3'),
        FormField::addRow(),

```