README

A custom fields extension bundle for EasyAdmin — 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 –> https://github.com/TCM-dev/EasyAdminFieldsBundle/tree/main It works great with WebpackEncore and this bundle has been created inspired by this bundle.

🚀 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

1️⃣ Install via Composer

composer require iamczech/easyadmin-fields-bundle

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

🔁 DependentField

A reactive EasyAdmin field that allows one field to depend on another — for example, dynamically updating a <select> 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 <select> (TomSelect (autocomplete) inputs are about to be available in next versions)

🔒 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

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

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

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

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

The bundle provides four native controllers:

Controller	Description
`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 drop

If you're using AssetMapper, they’re automatically registered. Otherwise, you can manually import them from @iamczech/easyadmin-fields.

🌟 Feature Roadmap

✅ 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

🌲 TreeField Visual tree hierarchy for Gedmo\Tree entities on the index page (collapsible nodes + drag & drop planned).

🧪 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

Pull requests, bug reports and feature ideas are very welcome! Follow PSR-12 coding style and use ES modules for front-end logic.

🧪 License

🦯 Summary

Feature	Description
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 ✨

iamczech / easyadmin-fields-bundle

Maintainers

Package info

Statistics

Security

README

🚀 Requirements

🧱 Installation

1️⃣ Install via Composer

2️⃣ Install front-end controllers with AssetMapper

🧹 Included Fields

🔁 DependentField

🔒 LockedTextField

🧩 EmbedField

🌳 TreeConfigurator

🔗 LinkField

🤳 QrField

⚙️ Stimulus Controllers

🌟 Feature Roadmap

✅ Current Features

🧠 Upcoming Features

🧪 Development Setup

🤝 Contributing

🧪 License

🦯 Summary