CRUD Controllers

Extend the Admin Panel with custom CRUD interfaces using EasyAdmin.

Basic CRUD Controller

<?php
namespace Plugins\MyPlugin\Controller\Admin;

use App\Core\Controller\Admin\AbstractPanelController;
use EasyCorp\Bundle\EasyAdminBundle\Config\Crud;
use EasyCorp\Bundle\EasyAdminBundle\Config\Action;
use EasyCorp\Bundle\EasyAdminBundle\Config\Actions;
use EasyCorp\Bundle\EasyAdminBundle\Field\IdField;
use EasyCorp\Bundle\EasyAdminBundle\Field\TextField;
use EasyCorp\Bundle\EasyAdminBundle\Field\DateTimeField;
use Plugins\MyPlugin\Entity\MyEntity;

class MyEntityCrudController extends AbstractPanelController
{
    public static function getEntityFqcn(): string
    {
        return MyEntity::class;
    }

    public function configureCrud(Crud $crud): Crud
    {
        return $crud
            ->setEntityLabelInSingular('My Entity')
            ->setEntityLabelInPlural('My Entities')
            ->setPageTitle('index', 'My Plugin - Entities')
            ->setPageTitle('detail', fn (MyEntity $entity) => sprintf('Entity #%d', $entity->getId()))
            ->setDefaultSort(['createdAt' => 'DESC'])
            ->setPaginatorPageSize(25);
    }

    public function configureFields(string $pageName): iterable
    {
        yield IdField::new('id')
            ->hideOnForm();

        yield TextField::new('name')
            ->setRequired(true);

        yield TextField::new('description')
            ->setRequired(false);

        yield DateTimeField::new('createdAt')
            ->hideOnForm();
    }

    public function configureActions(Actions $actions): Actions
    {
        return $actions
            ->add(Crud::PAGE_INDEX, Action::DETAIL)
            ->remove(Crud::PAGE_INDEX, Action::DELETE);
    }
}

Advanced CRUD Features

use EasyCorp\Bundle\EasyAdminBundle\Config\Filters;
use EasyCorp\Bundle\EasyAdminBundle\Field\BooleanField;
use EasyCorp\Bundle\EasyAdminBundle\Field\ChoiceField;
use EasyCorp\Bundle\EasyAdminBundle\Field\AssociationField;
use EasyCorp\Bundle\EasyAdminBundle\Filter\EntityFilter;

class AdvancedCrudController extends AbstractPanelController
{
    // ... getEntityFqcn()

    public function configureFields(string $pageName): iterable
    {
        yield IdField::new('id')->hideOnForm();

        yield TextField::new('name')
            ->setHelp('Enter a unique name');

        yield ChoiceField::new('status')
            ->setChoices([
                'Active' => 'active',
                'Inactive' => 'inactive',
                'Pending' => 'pending'
            ]);

        yield BooleanField::new('isEnabled')
            ->renderAsSwitch(true);

        yield AssociationField::new('user')
            ->autocomplete();

        yield DateTimeField::new('createdAt')
            ->hideOnForm()
            ->setFormat('yyyy-MM-dd HH:mm:ss');
    }

    public function configureFilters(Filters $filters): Filters
    {
        return $filters
            ->add('status')
            ->add('isEnabled')
            ->add(EntityFilter::new('user'));
    }
}

Custom Actions

use EasyCorp\Bundle\EasyAdminBundle\Config\Action;
use EasyCorp\Bundle\EasyAdminBundle\Config\Actions;
use EasyCorp\Bundle\EasyAdminBundle\Router\AdminUrlGenerator;

public function configureActions(Actions $actions): Actions
{
    $customAction = Action::new('customAction', 'Custom Action')
        ->linkToRoute('plugin_my_plugin_custom_action', fn (MyEntity $entity) => [
            'id' => $entity->getId()
        ])
        ->setIcon('fa fa-rocket')
        ->displayIf(fn (MyEntity $entity) => $entity->canPerformAction());

    return $actions
        ->add(Crud::PAGE_INDEX, $customAction)
        ->add(Crud::PAGE_DETAIL, $customAction);
}

Field Types

Common Fields

use EasyCorp\Bundle\EasyAdminBundle\Field\*;

// Text fields
yield TextField::new('shortText');
yield TextareaField::new('longText');
yield TextEditorField::new('richText');  // WYSIWYG editor

// Numeric fields
yield IntegerField::new('count');
yield NumberField::new('price')
    ->setNumDecimals(2);

// Date/Time fields
yield DateField::new('birthDate');
yield TimeField::new('startTime');
yield DateTimeField::new('createdAt');

// Boolean fields
yield BooleanField::new('isActive')
    ->renderAsSwitch(true);

// Choice fields
yield ChoiceField::new('status')
    ->setChoices([
        'Active' => 'active',
        'Inactive' => 'inactive'
    ]);

// Association fields
yield AssociationField::new('user')
    ->autocomplete();  // Searchable dropdown

// Collection fields
yield CollectionField::new('tags');

// File fields
yield ImageField::new('avatar')
    ->setBasePath('uploads/avatars/')
    ->setUploadDir('public/uploads/avatars/');

Filters

use EasyCorp\Bundle\EasyAdminBundle\Filter\*;

public function configureFilters(Filters $filters): Filters
{
    return $filters
        ->add('name')                           // Text filter
        ->add('status')                         // Choice filter
        ->add('isActive')                       // Boolean filter
        ->add(EntityFilter::new('user'))        // Association filter
        ->add(DateTimeFilter::new('createdAt')) // Date filter
        ->add(NumericFilter::new('price'));     // Numeric filter
}

Batch Actions

use EasyCorp\Bundle\EasyAdminBundle\Config\Action;

public function configureActions(Actions $actions): Actions
{
    $batchAction = Action::new('batchApprove', 'Approve Selected')
        ->linkToRoute('plugin_my_plugin_batch_approve')
        ->addCssClass('btn btn-success')
        ->setIcon('fa fa-check');

    return $actions
        ->addBatchAction($batchAction);
}

Custom Templates

public function configureFields(string $pageName): iterable
{
    yield TextField::new('status')
        ->setTemplatePath('@PluginMyPlugin/admin/status_badge.html.twig');
}

Template file templates/admin/status_badge.html.twig:

{% if value == 'active' %}
    <span class="badge badge-success">Active</span>
{% else %}
    <span class="badge badge-danger">Inactive</span>
{% endif %}

Service Registration

services:
    Plugins\MyPlugin\Controller\Admin\MyEntityCrudController:
        tags: ['controller.service_arguments']
        public: true

Important: CRUD controllers must be:

• Tagged with controller.service_arguments

• Marked as public: true

Adding to Admin Menu

Use MenuEventSubscriber to add your CRUD to the admin menu:

$menuItems['admin'][] = MenuItem::linkToCrud(
    'My Entities',                        // Label
    'fas fa-database',                    // Icon
    MyEntity::class                       // Entity class
);

Permissions

Restrict access with permissions:

use Symfony\Component\Security\Http\Attribute\IsGranted;

#[IsGranted('ROLE_ADMIN')]
class MyEntityCrudController extends AbstractPanelController
{
    // Only admins can access
}

Related Guides

• Entities & Database - Create entities to manage

• Event System - Add to admin menu

• Dependencies - Service injection

• EasyAdmin Documentation - Full reference