PHPackages iamczech/easyadmin-fields-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. iamczech/easyadmin-fields-bundle ActiveSymfony-bundle[Admin Panels](/categories/admin) iamczech/easyadmin-fields-bundle ================================ Extends basic EasyAdmin fields and works well with AssetMapper and Smyfony 7.4^ 1.0.9(2mo ago)1311MITPHPPHP >=8.4 Since Oct 30Pushed 2mo agoCompare [ Source](https://github.com/xXIamCzechXx/easyadmin-fields-bundle)[ Packagist](https://packagist.org/packages/iamczech/easyadmin-fields-bundle)[ RSS](/packages/iamczech-easyadmin-fields-bundle/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependencies (7)Versions (7)Used By (0) 🧹 iamczech/easyadmin-fields-bundle ================================== [](#-iamczecheasyadmin-fields-bundle) A **custom fields extension bundle** for [EasyAdmin](https://github.com/EasyCorp/EasyAdminBundle) β€” built for modern **Symfony 7.4+** and **PHP 8.4+**, fully compatible with the new **AssetMapper** pipeline. This is my first bundle, if I have done something wrong or incorrectly, please contact me and I will be happy to fix it. This bundle provides advanced and interactive form fields designed to improve the developer experience and user interface inside the EasyAdmin backend. A big thanks to a bundle from TCM-dev, BurningDog, evotodi, Yonn-Trimoreau for creating this awesome bundle –> It works great with WebpackEncore and this bundle has been created inspired by this bundle. --- πŸš€ Requirements -------------- [](#-requirements) - **PHP** β‰₯ 8.2 - **Symfony** β‰₯ 7.4 - **EasyAdminBundle** β‰₯ 4.0 - Compatible with **AssetMapper** (no Webpack Encore is not supported!) - Works with **Stimulus 3** and **Hotwired** --- 🧱 Installation -------------- [](#-installation) ### 1️⃣ Install via Composer [](#1️⃣-install-via-composer) ``` composer require iamczech/easyadmin-fields-bundle ``` ### 2️⃣ Install front-end controllers with AssetMapper [](#2️⃣-install-front-end-controllers-with-assetmapper) If you're using Symfony’s **AssetMapper** (recommended): ``` php bin/console importmap:install php bin/console asset-map:compile ``` The bundle automatically registers its Stimulus controllers in your `controllers.json` under: ``` "symfony": { "controllers": { "dependent": { "main": "dist/dependent_controller.js", "webpackMode": "lazy", "fetch": "lazy", "enabled": true }, "locked": { "main": "dist/locked_controller.js", "webpackMode": "lazy", "fetch": "lazy", "enabled": true }, "embed": { "main": "dist/embed_controller.js", "webpackMode": "lazy", "fetch": "lazy", "enabled": true } } ... } ``` --- 🧹 Included Fields ----------------- [](#-included-fields) ### πŸ” DependentField [](#-dependentfield) A **reactive EasyAdmin field** that allows one field to depend on another β€” for example, dynamically updating a `` field’s options based on a previous input. Important thing, DependentField and its Associated fields cannot be ->autocomplete() (dependencies can), it has its own EventSubscriber to prevent from fetching large amount of data. **Usage:** ``` use App\Field\DependentField; use EasyCorp\Bundle\EasyAdminBundle\Field\AssociationField; yield AssociationField::new('client', 'Client') ->autocomplete(); yield DependentField::adapt( AssociationField::new('user', 'User'), [ DependentField::OPTION_CALLBACK_URL => $this->generateUrl('users_by_client'), DependentField::OPTION_DEPENDENCIES => ['client'], DependentField::OPTION_FETCH_ON_INIT => true ] ); ``` 🧠 **Notes:** - Works seamlessly with AssetMapper (no JS bundler required) - Updates target field values asynchronously via Fetch API - Handles normal `` (TomSelect (autocomplete) inputs are about to be available in next versions) --- ### πŸ”’ LockedTextField [](#-lockedtextfield) A **read-only text field** that is locked by default. When the user clicks the field, a confirmation popup appears. After confirming, all fields in the same unlock group become editable. **Usage:** ``` use App\Field\LockedTextField; yield LockedTextField::new('firstName', 'First Name') ->setUnlockGroup('name') ->setContentText('Do you really want to unlock this group of fields via first name?') ->setConfirmText('Oh yes!') ->setCancelText('Oh no!'); yield LockedTextField::new('lastName', 'Last Name') ->setUnlockGroup('name') ->setContentText('Do you really want to unlock this group of fields via last name?') ->setConfirmText('I agree!') ->setCancelText('No, thanks!'); ``` The controller automatically handles: - Displaying confirmation (via `window.confirm`) - Unlocking all inputs with the same `data-unlock-group` value - Removing the `locked` and `readonly` attributes dynamically --- ### 🧩 **EmbedField** [](#-embedfield) Embed nested `CrudController` directly into forms (inline CRUD editing). It is important to set callback url for a iframe via setCallbackUrl() and generate it via adminUrlGenerator. The default page is Crud::PAGE\_INDEX action, but you can change it via the setAction() method. **Usage:** ``` yield EmbedField::new('entities') ->setEmbeddedCrudController(SomeCrudController::class) ->setEmbeddedPropertyAlias('entityInstanceId'); // alias for property in embedded crud controller – current entity instance id is provided ->setEmbeddedPageAddText('Embed form will be shown after the record is created') // embed is unavailable when creating, this shows a message on Crud::PAGE_ADD ->setEmbeddedParameter('filters[id]', 1) // you can pass a single parameter to request header of an embedded crud controller ``` NOTE: You don't need to setEmbeddedPageAddText(), a default message is shown, otherwise you can disable showing on Crud::PAGE\_ADD by setting "hideWhenCreating()" Assign multiple parameters to request header: ``` yield EmbedField::new('entities') ->setEmbeddedCrudController(SomeCrudController::class) ->setEmbeddedPropertyAlias('entityInstanceId'); // alias for property in embedded crud controller – current entity instance id is provided ->setEmbeddedPageAddText('Embed form will be shown after the record is created') // embed is unavailable when creating, this shows a message on Crud::PAGE_ADD ->setEmbeddedParameters([ 'filters[id]' => 1, // this automatically sets a filter of your choice if that filter is defined in an embedded crud controller 'custom-parameter' => 'some-value' // this automatically assigns "custom-paramter" to request header of the embedded crud controller ]) ``` NOTE: You can access custom parameters from the embedded crud controller via $this->request->query->get('your-parameter-name') ``` public function configureCrud(Crud $crud): Crud { $crud = parent::configureCrud($crud); EmbedConfigurator::applyEmbedLayout($crud, $this->container->get('request_stack')); return $crud; } ``` NOTE: To render only content of EA you need to override default layout by overriding configureCrud method in your CrudController or AbstractCrudController if you have one. ### 🌳 **TreeConfigurator** [](#-treeconfigurator) You must use `NestedSetEntity` and implement `TreeInterface` directly into your entity where you want to show tree hierarchy. It is highly recommended to use `Gedmo\Tree` annotation with Strategy::NESTED. **Usage:** ``` use Gedmo\Tree\Traits\NestedSetEntity; use Iamczech\EasyAdminFieldsBundle\Interface\TreeInterface; #[Gedmo\Tree(type: Strategy::NESTED)] #[ORM\Entity(repositoryClass: NestedTreeRepository::class)] class Category implements TreeInterface { use NestedSetEntity; ``` NOTE: Create your own TreeController and extend AbstractTreeController, then you can override reorder() method if necessary. ``` use Iamczech\EasyAdminFieldsBundle\Controller\AbstractTreeController; class TreeController extends AbstractTreeController { // Do something or override reorder() method } ``` Last you need to extend your crud controller and appy TreeConfigurator. ``` public function configureCrud(Crud $crud): Crud { $crud = parent::configureCrud($crud); TreeConfigurator::applyTreeLayout($crud); return $crud; } ``` ### πŸ”— **LinkField** [](#-linkfield) Render a related entity as a selectable field (ChoiceField) enhanced with a dynamic action link (supported actions: edit, detail). The field automatically generates per-entity URLs using AdminUrlGenerator and respects user permissions. Only URLs the user is allowed to access (based on the configured CRUD action) are exposed to the frontend. **Usage:** ``` yield LinkField::link(AssociationField::new('entity', 'Entity'), [ LinkField::URL => $this->adminUrlGenerator->setController(SomeCrudController::class)->setAction(Crud::PAGE_DETAIL/Crud::PAGE_EDIT), LinkField::TARGET => '_blank'/'_self', LinkField::PAGE_NAME => $pageName ] ); ``` NOTE: Works also with ->autocomplete() fields. But only works for "ToOne" relations! ``` yield LinkField::link(AssociationField::new('entity', 'Entity') ->autocomplete(), [ LinkField::URL => $this->adminUrlGenerator->setController(SomeCrudController::class)->setAction(Crud::PAGE_DETAIL/Crud::PAGE_EDIT), LinkField::TARGET => '_blank'/'_self', LinkField::PAGE_NAME => $pageName ] ); ``` NOTE: If you want link to follow your actual Crud Action, then don't manually do ->setAction(), it will automatically set Action to your current action. ### 🀳 **QrField** [](#-qrfield) Provides automatic generation of QR code and print it on index, edit and detail pages. It is not mapped directly to any entity attribute, because it should consist of absolute URL. So field property is passed as a parameter to generate url when choosing generation of QR from route, not absolute URL **Usage:** ``` yield QrField::new('slug', 'QR Code') ->setQrRoute('app_some_route') ->setQrLabel(new Label('Some text provided to a QR')) ->setQrSize(100); ``` NOTE: setQrRoute() has priority over setQrUrl(), so when you set both, setQrRoute() will be used to generate QR code and also url into disabled input βš™οΈ Stimulus Controllers ----------------------- [](#️-stimulus-controllers) The bundle provides four native controllers: ControllerDescription`copy`Copy texts of another dependent filds to actual field`dependent`Handles asynchronous loading of dependent field options`embed`Resize iframe to its content height`locked`Manages field unlocking with confirmation alerts`tree`Generates wonderful tree hierarchy with drag 'n dropIf you're using AssetMapper, they’re automatically registered. Otherwise, you can manually import them from `@iamczech/easyadmin-fields`. --- 🌟 Feature Roadmap ----------------- [](#-feature-roadmap) ### βœ… Current Features [](#-current-features) - **DependentField**: dynamic dependency management between fields - **EmbedField**: rendering crud controllers within another crud controller with a custom popup for a better UX and consistent styling inside EasyAdmin. - **LockedTextField**: controlled unlocking of grouped inputs via confirmation - **LinkField**: possibility to redirect to ToOne relation edit/detail page - **TreeConfigurator**: controlled unlocking of grouped inputs via confirmation - **ButtonField**: makes possible to generate dynamic buttons that show modals, or redirect anywhere - **QrField**: based on input url generates QR code and print int on index, edit and detail pages ### 🧠 Upcoming Features [](#-upcoming-features) - 🌲 **TreeField**Visual tree hierarchy for `Gedmo\Tree` entities on the index page (collapsible nodes + drag & drop planned). --- πŸ§ͺ Development Setup ------------------- [](#-development-setup) Clone and link locally if developing: ``` git clone https://github.com/iamczech/easyadmin-fields-bundle.git cd easyadmin-fields-bundle # Build controllers for distribution npm install npm run build ``` Then update your Symfony project: ``` php bin/console importmap:install php bin/console asset-map:compile ``` --- 🀝 Contributing -------------- [](#-contributing) Pull requests, bug reports and feature ideas are very welcome! Follow PSR-12 coding style and use ES modules for front-end logic. --- πŸ§ͺ License --------- [](#-license) This bundle is open-sourced software licensed under the **MIT License**. Copyright Β© [iamczech](https://github.com/iamczech) --- 🦯 Summary --------- [](#-summary) FeatureDescription**Symfony Compatibility**Symfony 7.4 and newer**PHP Version**PHP 8.4+**Asset Pipeline**Fully compatible with AssetMapper**Provided Fields**`DependentField`, `LockedTextField`, `EmbedField`, `ButtonField`, `QrField`**Upcoming**`TreeField`, enhanced Autocomplete--- > πŸ’‘ *iamczech/easyadmin-fields-bundle* β€” bringing modern, reactive and elegant form fields to EasyAdmin ✨ ### Health Score 43 β€” FairBetter than 91% of packages Maintenance87 Actively maintained with recent releases Popularity10 Limited adoption so far Community7 Small or concentrated contributor base Maturity57 Maturing project, gaining track record 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 ~26 days Recently: every ~5 days Total 6 Last Release 66d ago PHP version history (2 changes)1.0.2PHP >=8.4 1.0.6PHP >=8.2 ### Community Maintainers ![](https://www.gravatar.com/avatar/2fd2f7fb4bd3e9b2007e695e053b92d4e2a856f95ab10e84d71adcdf67e09d3f?d=identicon)[xXIamCzechXx](/maintainers/xXIamCzechXx) --- Top Contributors [![xXIamCzechXx](https://avatars.githubusercontent.com/u/75167109?v=4)](https://github.com/xXIamCzechXx "xXIamCzechXx (41 commits)") --- Tags symfony-ux ### Embed Badge ![Health badge](/badges/iamczech-easyadmin-fields-bundle/health.svg) ``` [![Health](https://phpackages.com/badges/iamczech-easyadmin-fields-bundle/health.svg)](https://phpackages.com/packages/iamczech-easyadmin-fields-bundle) ``` ### Alternatives [easycorp/easyadmin-demo EasyAdmin Demo Application 145.7k](/packages/easycorp-easyadmin-demo)[2lenet/crudit-bundle The easy like Crud'it Bundle. 1714.8k8](/packages/2lenet-crudit-bundle)[forumify/forumify-platform 121.8k11](/packages/forumify-forumify-platform) PHPackages Β© 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)