README

Extends EasyAdmin with reusable traits, fields, and controllers for building admin panels. Requires PHP 8.5+ and Symfony 7.4+/8.1+.

Install

composer require playtini/easy-admin-helper-bundle

Create App\EasyAdmin\EasyAdminMenu implementing EasyAdminMenuInterface. Create DashboardController extending CustomDashboardController.

Add to config/services.yaml:

    Playtini\EasyAdminHelperBundle\Dashboard\EasyAdminMenuInterface:
        class: 'App\EasyAdmin\EasyAdminMenu'
    Playtini\EasyAdminHelperBundle\Dashboard\EasyAdminContext:
        bind:
            $dashboardController: '@App\Controller\Admin\DashboardController'
    Playtini\EasyAdminHelperBundle\Event\DashboardExceptionSubscriber:
        tags: [ { name: kernel.event_subscriber } ]

Load routes. Add to config/routes/easyadmin.yaml:

easy_admin_helper:
    resource: '@EasyAdminHelperBundle/config/routes.yaml'

EasyAdmin 5 requires pretty URLs, so the EasyAdmin route loader must be enabled for the custom CRUD actions (archive, duplicate) to be registered. Add to the same config/routes/easyadmin.yaml:

easyadmin:
    resource: .
    type: easyadmin.routes

Install bundle assets (symlinks JS/CSS to public/bundles/easyadminhelper/):

php bin/console assets:install

Features

Controller Traits

Entity Traits

CrudField Helper

Static factory for pre-configured EasyAdmin fields:

yield CrudField::id();
yield CrudField::panel('Details', 6);
yield CrudField::name();
yield CrudField::email();
yield CrudField::domain();
yield CrudField::ip();
yield CrudField::country();
yield CrudField::url('websiteUrl');
yield CrudField::status();
yield CrudField::bool('isVerified', 'Verified');
yield CrudField::createdAt();
yield CrudField::updatedAt();
yield CrudField::yaml('config', isIndex: true);
yield CrudField::virtual('Score', fn($v, $entity) => $entity->getScore());

AdminFormatter

AdminFormatter::badge('active', '#198754')           // colored badge
AdminFormatter::badgeMap('error', $colorMap)          // badge with color lookup
AdminFormatter::formatExpireDate($date)               // color-coded by days remaining
AdminFormatter::formatHttpStatus(200)                 // Bootstrap status badge
AdminFormatter::formatBoolNullEmoji(true)             // 🟢 / 🔴
AdminFormatter::muteZero(0)                           // grayed-out zero
AdminFormatter::percents(25, 100)                     // "25%"

Quick Date Filter

Dropdown with preset date periods. Query param: ?period=24h

class ClickCrudController extends AbstractCrudController
{
    use CrudControllerTrait;
    use QuickDateFilterCrudTrait;

    public function configureCrud(Crud $crud): Crud {
        return $this->_configureCrud($crud)
            ->overrideTemplate('crud/index', '@EasyAdminHelper/crud/quick_date_filter_index.html.twig');
    }

    public function createIndexQueryBuilder(...): QueryBuilder {
        $qb = parent::createIndexQueryBuilder(...);
        return $this->applyQuickDateFilter($qb);
    }
}

Override getQuickDateField(), getQuickDateDefault(), getQuickDateOptions() to customize.

Date Range Picker

Calendar-based date range picker. Query params: ?from=2025-01-01&to=2025-01-31

class EventCrudController extends AbstractCrudController
{
    use CrudControllerTrait;
    use DateRangePickerCrudTrait;

    public function configureCrud(Crud $crud): Crud {
        return $this->_configureCrud($crud)
            ->overrideTemplate('crud/index', '@EasyAdminHelper/crud/date_range_picker_index.html.twig');
    }
}

The trait handles createIndexQueryBuilder() and configureResponseParameters() automatically. Override getDateRangeField() and getDateRangeDefaultDays() to customize.

Doc Controllers

Built-in documentation viewer for markdown files in {project}/doc/. Supports YAML front matter. Routes:

• /admin/doc — doc index
• /admin/doc/{name} — single doc page
• /admin/doc/db — database diagrams

Bundled Assets

The bundle ships common vendor JS/CSS in public/. After assets:install they're available at /bundles/easyadminhelper/:

• js/jquery.js — jQuery
• js/chart.js — Chart.js
• js/moment.min.js — Moment.js
• js/vanilla-datetimerange-picker.js — Date range picker
• css/vanilla-datetimerange-picker.css — Date range picker styles

The bundle layout (templates/layout.html.twig) includes common CSS utilities (.positive, .negative, .uid, .short-1–.short-6, .btn-xs, etc.) and auto-initializes Bootstrap tooltips.