lag/adminbundle

Generic admin bundle for Symfony2 from L'arrière-guichet

v1.1-RC2 2020-10-22 19:34 UTC

Requires

• php: ^7.2
• babdev/pagerfanta: ^2.4
• johnkrovitch/configuration: ^1.4
• johnkrovitch/orm-pack: ^2.0
• knplabs/knp-menu-bundle: ^3.0
• lag/string-utils: ^1.2
• sensio/framework-extra-bundle: ^4.4|^5.4
• symfony/dependency-injection: ^4.4|^5.1
• symfony/event-dispatcher: ^4.4|^5.1
• symfony/form: ^4.4|^5.1
• symfony/framework-bundle: ^4.4|^5.1
• symfony/security-bundle: ^4.4|^5.1
• symfony/serializer: ^4.4|^5.1
• symfony/translation: ^4.4|^5.1
• symfony/twig-bundle: ^4.4|^5.1
• twig/twig: ^3.0

Requires (Dev)

• dg/bypass-finals: ^1.1
• nyholm/symfony-bundle-test: ^1.6
• php-parallel-lint/php-var-dump-check: ^0.5
• phpstan/phpstan: ^0.12
• phpunit/phpunit: ^8.0
• sensiolabs/security-checker: ^4.0|^5.0|^6.0
• symfony/console: ^4.0|^5.1
• symfony/debug-bundle: ^5.1
• symfony/monolog-bundle: ^3.5
• symfony/var-dumper: ^4.4|^5.1
• symfony/webpack-encore-bundle: ^1.7

MIT

• JohnKrovitch
• JohanDufour
• VincentChalnot

• admin
• Symfony2
• backoffice
• generic

README

TODO

• validation groups
• serialization
• set nullable resource arrays to add difference between empty set array and not set array
• check validation php attributes of metadata
• batch actions
• dynamic resource/operation request parameters
• check extension parameters useful
• add sf routing params to resource
• remove load method from the registry

AdminBundle

The AdminBundle helps you to create flexible and robust administration application.

It provides PHP attributes or yaml configuration to build views to show, create; update and delete resources. It comes with a native Doctrine ORM integration, and can also be used with any architecture.

The AdminBundle is highly customizable using configuration or with events to allow you tu build dynamic administration interfaces.

Features

• Easy to use PHP attributes or yaml configuration
• Highly customizable
• Doctrine ORM integration
• Views with pagination, sorting and filtering
• Dynamic menus
• Bootstrap 5 integration

Install the Bundle

composer require lag/adminbundle

If you do not use Symfony Flex, follow those extra steps.

Step 1: Install the Bundle

Open a command console, execute the following command in your project directory to install the latest stable version of the bundle:

composer require lag/adminbundle

If you do not use flex, read the extra steps to install the bundle

Step 2: Configure the routing

Import the routing configuration to have the admin generated routes :

    # config/routes.yaml        
    lag_admin:
        resource: '@LAGAdminBundle/Resources/config/routing/routing.yaml'
        prefix: /admin

Step 3 : Configure an entity

# config/packages/lag_admin.yaml
lag_admin:
    application:
        title: My Little TaunTaun application       

# config/admin/resources/article.yaml
article:
    entity: App\Entity\Article 
    actions:
        create: ~
        edit: ~
        list: ~
        delete: ~

As new routes are dynamically created, the cache clearing is required (symfony cache:clear)

Now you could visit http://127.0.0.1:8000/admin/article/list to see a list of your entities.

Yan can visit http://127.0.0.1:8000/app_dev.php/admin/ to see the homepage of your admin interface

Documentation

1. How to use
   • a. Basics
   • b. Admins
   • c. Actions
   • d. Fields
   • e. Events
   • f. Data Providers
   • g. Filters
   • h. Views
   • i. Security
2. Customization
   • a. Custom actions
   • b. Custom render
   • c. Custom data
   • d. Custom routes and urls
3. Reference
   • a. Application configuration
   • b. Admin configuration
4. FAQ
5. Configuration reference

Testing

To run the admin test suite, run the following :

make tests

Road map

v1.1

• Add dynamic id column (instead of required "id" column) to improve generic and handle multiple ids columns

v1.0

• Add more testing

History

Version 0.4 :

• Dynamic CRUD for your entities (no code generation)
• Simple configuration in yml (look alike symfony1 generators.yml syntax)
• List with pagination, sorting and batch remove (filters are coming)
• Full translated
• Main and left menu integration
• Fully customizable (use your own controllers, data providers or templates)
• Bootstrap 3 integration (can be disabled or override)