README

Wandi/EasyAdminBundle is a Symfony 3 prepacked admin bundle. It includes :

How to configure

Install via composer

$ composer require wandi/easy-admin-bundle

Registering the bundles

$bundles = [
    // ...
    new \Wandi\EasyAdminBundle\WandiEasyAdminBundle(),
    new \JavierEguiluz\Bundle\EasyAdminBundle\EasyAdminBundle(),
    new \Vich\UploaderBundle\VichUploaderBundle(),
    new \Ivory\CKEditorBundle\IvoryCKEditorBundle(),
    new \CKSource\Bundle\CKFinderBundle\CKSourceCKFinderBundle(),
];

Configuration

Add required config to app/config/config.yml:

# Easy Admin
easy_admin:
    design:
        assets:
            js:
                - '/bundles/cksourceckfinder/ckfinder/ckfinder.js'
                - '/bundles/wandieasyadmin/js/ckfinder.js'
    entities:
        - AppBundle\Entity\Post
        - AppBundle\Entity\Tag
        # ... 
 
# VichUploader
vich_uploader:
    db_driver: orm
  
# CKFinder
ckfinder:
    connector:
        authenticationClass: Wandi\EasyAdminBundle\Services\CKFinderAuthentication

Add route to app/config/routing.yml:

wandi_easy_admin:
    resource: "@WandiEasyAdminBundle/Resources/config/routing.yml"
    prefix:   /admin

Note: Here we use the prefix /admin for all our admin paths

Update app/config/security.yml configuration:

security:
    encoders:
        # ...
        Wandi\EasyAdminBundle\Entity\User: bcrypt
    
    providers:
        # ...    
        wandi_easy_admin:
            entity: { class: 'Wandi\EasyAdminBundle\Entity\User' }
            
    firewalls:
        wandi_easy_admin:
            pattern: '^/admin'
            anonymous: true
            logout:
                path: wandi_easy_admin_logout
            guard:
                authenticators:
                    - wandi_easy_admin.form_authenticator
        # ...

    access_control:
        # ...
        - { path: '^/admin/login', role: IS_AUTHENTICATED_ANONYMOUSLY }
        - { path: '^/admin/', role: ROLE_EASY_ADMIN }

Important: Make sure that no firewall declared before our, does not match with the prefix we use

Update schema

The bundle uses its own User entity. So we need to update your database schema.

$ php bin/console doctrine:schema:update -f

Commands

Setup Wandi/EasyAdminBundle (required)

It's a shortcut for download and install all the assets for CKEditor and CKFinder

php bin/console wandi:easy-admin:setup

Create an admin

php bin/console wandi:easy-admin:user:create admin password

Change admin password

php bin/console wandi:easy-admin:user:change-password admin password2

Enable an admin

php bin/console wandi:easy-admin:user:enable admin

Disable an admin

php bin/console wandi:easy-admin:user:disable admin

wandi / easy-admin-bundle

Maintainers

Details