PHPackages playtini/easy-admin-helper-bundle - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Admin Panels](/categories/admin) 4. / 5. playtini/easy-admin-helper-bundle ActiveLibrary[Admin Panels](/categories/admin) playtini/easy-admin-helper-bundle ================================= EasyAdmin Helper Bundle 1.36(3w ago)09261proprietaryPHPPHP ^8.5CI passing Since Jul 1Pushed 3w ago1 watchersCompare [ Source](https://github.com/playtini/easy-admin-helper-bundle)[ Packagist](https://packagist.org/packages/playtini/easy-admin-helper-bundle)[ RSS](/packages/playtini-easy-admin-helper-bundle/feed)WikiDiscussions main Synced 2w ago READMEChangelogDependencies (79)Versions (31)Used By (0) EasyAdmin Helper Bundle ======================= [](#easyadmin-helper-bundle) Extends EasyAdmin with reusable traits, fields, and controllers for building admin panels. Requires PHP 8.5+ and Symfony 7.4+/8.1+. Install ------- [](#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 -------- [](#features) ### Controller Traits [](#controller-traits) TraitPurpose`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 [](#entity-traits) TraitFields`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### Entity Base Classes [](#entity-base-classes) `BaseAuditLog` is a `#[ORM\MappedSuperclass]` carrying the eight columns of a per-request audit log (`username`, `routeName`, `routeParams`, `url`, `httpMethod`, `statusCode`, `ip`, `responseTimeMs`) plus `id`/`createdAt` via `CreatableEntityTrait`. Subclass it with your own `#[ORM\Entity]`, indexes and repository: ``` #[ORM\Entity(repositoryClass: AuditLogRepository::class)] #[ORM\HasLifecycleCallbacks] #[ORM\Index(columns: ['created_at'])] class AuditLog extends BaseAuditLog {} ``` `#[ORM\HasLifecycleCallbacks]` must be declared on the concrete class or `createdAt` never gets set. Do not also `use IdEntityTrait` β€” `CreatableEntityTrait` already composes it. **Requires `doctrine.orm.auto_mapping: true`** in the consuming application, or an explicit Doctrine mapping for the `Playtini\EasyAdminHelperBundle\Entity` namespace. Without one, Doctrine treats `BaseAuditLog` as transient and the subclass maps to zero columns β€” `doctrine:schema:update` will then propose dropping every column from the existing table rather than failing loudly. ### CrudField Helper [](#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) ``` 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 [](#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 [](#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. ### Release Session Early [](#release-session-early) `#[ReleaseSessionEarly]` marks a controller class or method as session-read-only. `ReleaseSessionEarlyListener` then flushes the session (`$session->save()`) before the action runs, so the session row isn't held for the duration β€” useful for concurrent XHRs from the same user. ``` #[ReleaseSessionEarly] public function export(): Response { // session already flushed by the time this runs } ``` Sessions are never started by the listener: if the controller hasn't started one, nothing happens. It's inert in a project that doesn't use the attribute. Attribute lookup is not inheritance-aware β€” declare it on the concrete controller class or method, not on an abstract base controller. For invokable controllers, the attribute is honoured whether it's placed on the class or on `__invoke()`. ### Bulk Import [](#bulk-import) `BulkImportType` is a paste-a-TSV import form backed by `Form\Dto\BulkImport`. It knows nothing about the target entity: the controller reads `BulkImport::getRows()` and decides what each row means. `BulkImport::getMode()` returns one of five modes (`MODE_CREATE_OR_UPDATE`, `MODE_CREATE_ONLY`, `MODE_UPDATE_ONLY`, `MODE_CREATE_SKIP_EXISTING`, `MODE_UPDATE_SKIP_MISSING`) so every project offers the same choices with the same stored values. ### Doc Controllers [](#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 [](#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. ### Health Score 50 β€” FairBetter than 95% of packages Maintenance96 Actively maintained with recent releases Popularity18 Limited adoption so far Community8 Small or concentrated contributor base Maturity65 Established project with proven stability Bus Factor1 Top contributor holds 100% of commits β€” single point of failure How is this calculated?**Maintenance (25%)** β€” Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** β€” Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** β€” Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** β€” Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~14 days Recently: every ~7 days Total 29 Last Release 21d ago PHP version history (2 changes)1.8PHP ^8.4 1.30PHP ^8.5 ### Community Maintainers ![](https://www.gravatar.com/avatar/df3e7060fb5777768e7bb133e98b1e7dfcc788f25fe6dc445acf7036da5c0c3e?d=identicon)[luchaninov](/maintainers/luchaninov) --- Top Contributors [![luchaninov](https://avatars.githubusercontent.com/u/3829796?v=4)](https://github.com/luchaninov "luchaninov (60 commits)") ### Code Quality TestsPHPUnit Static AnalysisPHPStan Type Coverage Yes ### Embed Badge ![Health badge](/badges/playtini-easy-admin-helper-bundle/health.svg) ``` [![Health](https://phpackages.com/badges/playtini-easy-admin-helper-bundle/health.svg)](https://phpackages.com/packages/playtini-easy-admin-helper-bundle) ``` ### Alternatives [easycorp/easyadmin-bundle Admin generator for Symfony applications 4.3k18.3M430](/packages/easycorp-easyadmin-bundle)[kimai/kimai Kimai - Time Tracking 4.8k9.4k1](/packages/kimai-kimai)[rcsofttech/audit-trail-bundle Enterprise-grade, high-performance Symfony audit trail bundle. Automatically track Doctrine entity changes with split-phase architecture, multiple transports (HTTP, Queue, Doctrine), and sensitive data masking. 12017.1k](/packages/rcsofttech-audit-trail-bundle)[2lenet/crudit-bundle The easy like Crud'it Bundle. 1617.3k16](/packages/2lenet-crudit-bundle) PHPackages Β© 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)