README

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

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'

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

php bin/console assets:install

Features

Controller Traits

Trait	Purpose
`CrudControllerTrait`	Base CRUD config (date formats, pagination, actions, detail→edit redirect)
`ArchiveCrudControllerTrait`	Soft-delete via archiving (auto-filters archived, archive/unarchive actions)
`DuplicateCrudControllerTrait`	Entity duplication via `DuplicateInterface`
`ReadOnlyCrudControllerTrait`	Disables all edit/delete actions, makes fields disabled
`InlineEditCrudControllerTrait`	Inline editing support
`SaveCrudControllerTrait`	Custom save logic via repository
`UserCrudControllerTrait`	Current user helpers
`QuickDateFilterCrudTrait`	Dropdown with preset date periods (1h, today, 24h, 7d, 30d)
`DateRangePickerCrudTrait`	Calendar-based date range picker with `from`/`to` params

Entity Traits

Trait	Fields
`IdEntityTrait`	Auto-increment `id`
`NameEntityTrait` / `NameUniqueEntityTrait`	`name` (varchar 255)
`LongNameEntityTrait`	`name` (varchar 1000)
`CreatableEntityTrait`	`createdAt` (auto-set on persist)
`UpdatableEntityTrait`	`updatedAt` (auto-set on persist/update)
`ArchivableEntityTrait`	`archivedAt` (soft-delete timestamp)
`IsEnabledTrait`	`isEnabled` (boolean)
`UidEntityTrait`	`uid` (unique string)
`CommentEntityTrait` / `ShortCommentEntityTrait`	`comment` (text / varchar 1024)
`DataEntityTrait`	`data` (JSON column with YAML display helper)
`VirtualFieldsEntityTrait`	Stub methods for computed fields

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.

playtini / easy-admin-helper-bundle

Maintainers

Package info

Statistics

Security