vincet/base-bundle

Symfony VinceTBaseBundle

BaseBundle

This bundle define base class to improve your development., _(*1)

It requires SonataAdminBundle and SonataDoctrineORMAdminBundle, _(*2)

Installation

Use composer to install, _(*3)

composer require vincet/base-bundle

For symfony <2.5 use the 2.2 version, _(*4)

composer require vincet/base-bundle=2.2

Entity Management

This bundle defines a BaseManager class that is compatible with SonataAdmin ModelManager., _(*5)

Juste define a new class for your entity :, _(*6)

namespace Acme\DemoBundle\Manager;

use VinceT\BaseBundle\Manager\BaseManager;

class PostManager extends BaseManager
{
}

Define the manager as a service in your services.yml :, _(*7)

parameters:
    post_manager.class: Acme\DemoBundle\Manager\PostManager

services:
    post_manager:
        class: %post_manager.class%
        arguments: [@service_container]

you can now acces this manager from any controller :, _(*8)

[...]
$postManager = $this->container->get('post_manager');
[...]
$post = new Acme\DemoBundle\Entity\Post();
[...]
$postManager->create($post);
[...]
$postManager->update($post);
[...]
$postManager->delete($post);
[...]

To use this manager with SonataAdmin, add a call to setModelManager in your services.yml file, _(*9)

services:
    acme.demo.admin.post:
      class: Acme\DemoBundle\Admin\PostAdmin
      tags:
        - { name: sonata.admin, manager_type: orm, group: Blog, label: Post }
      arguments: [null, Acme\DemoBundle\Entity\Post, AcmeDemoBundle:PostAdmin]
      calls:
        - [ setModelManager, [ @page_manager ] ]
        - [ setTranslationDomain, [ AcmeDemoBundle ] ]

Your front and Admin application will now use the same entity manager., _(*10)

Admin Controller

This bundle also define a BaseAdminController that catch exception throwed during an admin action. It is very easy to use :, _(*11)

Define your admin controller :, _(*12)

namespace Acmd\DemoBundle\Controller;

use VinceT\BaseBundle\Controller\BaseAdminController;

class PostAdminController extends BaseAdminController
{
}

Don't forget to use this controller in your admin service (the third argument)., _(*13)

services:
    acme.demo.admin.post:
      class: Acme\DemoBundle\Admin\PostAdmin
      tags:
        - { name: sonata.admin, manager_type: orm, group: Blog, label: Post }
      arguments: [null, Acme\DemoBundle\Entity\Post, AcmeDemoBundle:PostAdmin]

Commands

To make your development faster a command can generate the following classes for an entity, bundle or namespace : * Admin/EntityAdmin * Controller/Admin/EntityAdminController * Manager/EntityManager, _(*14)

and create/update the following files : * Resources/config/services.yml * Resources/translations/YourBundle.en.yml * Resources/translations/YourBundle.fr.yml, _(*15)

To use it :, _(*16)

php app/console vincet:generate MyBundle:Post

Another command generate a frontend CRUD controller. It's based on the \Sensio\Bundle\GeneratorBundle\Command\GenerateDoctrineCrudCommand, _(*17)

To use it :, _(*18)

php app/console vincet:generate:crud