meuhmeuhconcept/sonata-admin-bundle

SonataAdmin implementation for MeuhMeuhConcept

2.3 2024-09-27 13:43 UTC

Requires

• php: ~7.0
• doctrine/collections: 1.*
• doctrine/orm: ^2.5
• sonata-project/admin-bundle: ^3.10.2
• sonata-project/doctrine-orm-admin-bundle: ^3.1
• sonata-project/exporter: ^1.0
• symfony/config: ~3.4|~4.0
• symfony/dependency-injection: ~3.4|~4.0|~5.0
• symfony/form: ~3.4|~4.0|~5.0
• symfony/framework-bundle: ~3.4|~4.0|~5.0
• symfony/http-kernel: ~3.4|~4.0|~5.0
• symfony/options-resolver: ~3.4|~4.0|~5.0
• symfony/security: ~3.4|~4.0|~5.0
• symfony/security-core: ~3.4|~4.0|~5.0
• symfony/translation: ~3.4|~4.0|~5.0

Requires (Dev)

• doctrine/annotations: ^1.2
• friendsofphp/php-cs-fixer: ^1.12
• phpunit/phpunit: ~5.6

proprietary

• Jean-Noël Germon

README

Implatation of SonataAdmin for MeuhMeuhConcept

Installation

Via composer

composer require meuhmeuhconcept/sonata-admin-bundle

Installs bundles web assets under a public web directory

bin/console assets:install

Configuration

Add bundles

In app/AppKernel.php, add following lines

public function registerBundles()
{
    $bundles = [

        // ...

        new MMC\SonataAdminBundle\MMCSonataAdminBundle(),

        // These are the other bundles the SonataAdminBundle relies on
        new Sonata\CoreBundle\SonataCoreBundle(),
        new Sonata\BlockBundle\SonataBlockBundle(),
        new Knp\Bundle\MenuBundle\KnpMenuBundle(),

        // And finally, the storage and SonataAdminBundle
        new Sonata\DoctrineORMAdminBundle\SonataDoctrineORMAdminBundle(),
        new Sonata\AdminBundle\SonataAdminBundle(),

        // ...
    ];

    // ...
}

Configure bundles

Add SonataAdmin configuration (dashboard, templates, security,...) and form themes in Twig configuration :

# app/config/config.yml

sonata_block:
    default_contexts: [cms]
    blocks:
        # enable the SonataAdminBundle block
        sonata.admin.block.admin_list:
            contexts: [admin]

sonata_admin:
    templates:
        layout: MMCSonataAdminBundle::sonata_layout.html.twig
    security:
        handler: sonata.admin.security.handler.role

twig:
    form_themes:
        - 'SonataCoreBundle:Form:datepicker.html.twig'

Add roles hierarchy (This is an example, for more more detail see sonata security documentation) :

# app/config/security.yml
    role_hierarchy:

        # for convenience, I decided to gather Sonata roles here
        ROLE_SONATA_FOO_READER:
            - ROLE_SONATA_ADMIN_DEMO_FOO_LIST
            - ROLE_SONATA_ADMIN_DEMO_FOO_VIEW
        ROLE_SONATA_FOO_EDITOR:
            - ROLE_SONATA_ADMIN_DEMO_FOO_CREATE
            - ROLE_SONATA_ADMIN_DEMO_FOO_EDIT
        ROLE_SONATA_FOO_ADMIN:
            - ROLE_SONATA_ADMIN_DEMO_FOO_DELETE
            - ROLE_SONATA_ADMIN_DEMO_FOO_EXPORT

        # those are the roles I will use (less verbose)
        ROLE_STAFF:             [ROLE_USER, ROLE_SONATA_FOO_READER]
        ROLE_ADMIN:             [ROLE_STAFF, ROLE_SONATA_FOO_EDITOR, ROLE_SONATA_FOO_ADMIN]
        ROLE_SUPER_ADMIN:       [ROLE_ADMIN, ROLE_ALLOWED_TO_SWITCH]

Add Sonata Admin route :

# app/config/routing.yml
mmc_sonata_admin:
    resource: "@MMCSonataAdminBundle/Resources/config/routing.yml"
    prefix:   /admin

Image preview

Install liip/imagine-bundle

Official documentation

Configure form theme :

# app/config/config.yml

twig:
    form_themes:
        - 'MMCSonataAdminBundle:Form:image_preview.html.twig'

Add filters

# app/config/config.yml

liip_imagine :

    resolvers :
        default :
            web_path : ~

    filter_sets :
        cache : ~
        admin_thumb:
            quality: 75
            filters:
                thumbnail: { size : [90, 50], mode : outbound }

        admin_poster:
            quality: 85
            filters:
                thumbnail: { size : [400, 300], mode : inset }

Note : If php_exif extension is not enable in your PHP container, add the following line :

# app/config/parameters.yml && app/config/parameters.yml.dist

liip_imagine.meta_data.reader.class: Imagine\Image\Metadata\DefaultMetadataReader

Show template type

To insert template in edit view

Configure form theme :

# app/config/config.yml

twig:
    form_themes:
        - 'MMCSonataAdminBundle:Form:show_template.html.twig'

Customize

Sonata Admin

Example :

# app/config/config.yml

sonata_admin:
    title : ExampleOfTitle
    dashboard:
        blocks: []
        groups:
            sonata.admin.group.myCustomGroup:
                label:           myCustomLabel
                icon:            '<i class="fa fa-th"></i>'
                items: ~ # Add class item here