README

I have struggled with keeping my controllers DRY as my applications grew. All my attempts at solving the issue eventually timed perfectly with Live Components growing up into a mature and stable UX system. This bundle is the result of my attempts at previous reusable tables and admin generators, rebuilt on top of Live Components at its core.

While there's excellent admin bundles out there, I felt like defining their configuration replaced my controller problem with a new "configuration problem". I wanted something that was easy to get started with, non-repetitive, but also flexible enough to handle complex use cases while leaning on established patterns.

By leveraging Symfony UX, I was able to create a bundle that provides an admin interface with minimal boilerplate, while still allowing for deep customization through Twig templates and your own components.

1. Enable the bundle in config/bundles.php:

Kachnitel\AdminBundle\KachnitelAdminBundle::class => ['all' => true],

1. Import routes in config/routes/kachnitel_admin.yaml:

kachnitel_admin:
    resource: '@KachnitelAdminBundle/config/routes.yaml'
    prefix: /admin

1. Create config in config/packages/kachnitel_admin.yaml:

kachnitel_admin:
    base_layout: 'base.html.twig'  # Your app's base template

Level 1: Auto-detection (zero config) - all properties shown automatically

Level 2: Specify columns and order:

#[Admin(columns: ['id', 'name', 'price'])]

Or exclude: excludeColumns: ['costPrice']

Level 3: Role-based visibility:

#[ColumnPermission('ROLE_HR')]
private float $salary;

Level 4: User-toggleable:

#[Admin(enableColumnVisibility: true)]

Details: Configuration Guide | Column Visibility

Level 1: Use your layout:

kachnitel_admin:
    base_layout: 'base.html.twig'

Level 2: Switch theme (Bootstrap/Tailwind):

kachnitel_admin:
    theme: '@KachnitelAdmin/theme/tailwind.html.twig'

Level 3: Override type templates:

templates/bundles/KachnitelAdminBundle/types/datetime/_preview.html.twig

Level 4: Entity-specific:

templates/bundles/KachnitelAdminBundle/types/App/Entity/Product/price.html.twig

Details: Template Overrides Guide

Level 1: Route-based link, always visible:

#[AdminAction(name: 'duplicate', label: 'Duplicate', route: 'app_product_duplicate')]

Level 2: With a condition (expression):

#[AdminAction(name: 'approve', label: 'Approve', condition: 'entity.status == "pending"')]

Level 3: With a condition (service logic) and confirmation:

#[AdminAction(
    name: 'refund',
    label: 'Refund',
    method: 'POST',
    condition: [RefundService::class, 'canRefund'],
    confirmMessage: 'Refund this order?',
)]

Level 4: Remove or replace default Show/Edit:

#[AdminActionsConfig(exclude: ['edit'])]
#[AdminAction(name: 'show', label: 'Preview', icon: '🔍', override: true)]

Details: Row Actions Guide

EasyAdmin and SonataAdmin use PHP configuration, while this bundle leans heavily on a single Live Component with Twig templates for customization. This allows for real-time UI updates, and separates configuration (security, columns) from presentation (templates).

Full comparison - philosophy, features, and when to choose each.