Fetching contributors…
Cannot retrieve contributors at this time
160 lines (126 sloc) 5.44 KB

SonataAdminBundle - The missing Symfony2 Admin Generator

Build Status

The online documentation of the bundle is in

The demo website can be found in (admin as user and password)

For contribution to the documentation you can find it on Resources/doc.

Warning: documentation files are not rendering correctly in Github (reStructuredText format) and some content might be broken or hidden, make sure to read raw files.

Warning: The bundle has been split into 4 bundles :

Google Groups: For questions and proposals you can post on this google groups

Quick example

Defining an Admin class is pretty easy: simply define configure[Show|Form|List|Datagrid]Fields methods

namespace Sonata\NewsBundle\Admin;

use Sonata\AdminBundle\Admin\Admin;
use Sonata\AdminBundle\Form\FormMapper;
use Sonata\AdminBundle\Datagrid\DatagridMapper;
use Sonata\AdminBundle\Datagrid\ListMapper;
use Sonata\AdminBundle\Show\ShowMapper;

class PostAdmin extends Admin
    public function configureShowFields(ShowMapper $showMapper)

    public function configureFormFields(FormMapper $formMapper)
                ->add('enabled', null, array('required' => false))
                ->add('author', 'sonata_type_model', array(), array('edit' => 'list'))
                ->add('tags', 'sonata_type_model', array('expanded' => true))
            ->with('Options', array('collapsed' => true))
                ->add('commentsEnabled', null, array('required' => false))

    public function configureListFields(ListMapper $listMapper)

    public function configureDatagridFilters(DatagridMapper $datagridMapper)
            ->add('tags', null, array('filter_field_options' => array('expanded' => true, 'multiple' => true)))

Screenshots :

Of course, power users will be happy as an Admin class is very flexible as all dependencies are injected by the DIC (dependency injection container).


  • Dashboard

  • List

    • Automatic sort
    • Link to associated admin (Post => User)
    • Custom templates
    • Row Action : edit, view, ...
    • Batch Action
    • Clever row visualisation : boolean values are represented with 'check picture'
    • Filter
    • Pagination
  • Edit/Create

    • Inline edition
    • Association management (create related model with + icon)
    • Group fields
    • Sortable option
    • Modal window to select model (when the list can be important)
    • Dynamic form on [one|many]-to-many association (add new element)
  • Templating

    • base templates (field, list, filter) can be overwritten
    • layout templates can be defined into the Service Container
  • Others

    • Nested Admin, ie /news/post/5/comment/list : filter and create comments only for the post with id=5
    • Contextual Breadcrumb
    • persistent parameters across an Admin
    • side menu option
    • Translated into 17 languages : CA, DE, EN, ES, FR, HR, IT, JA, LB, NL, PL, PT_BR, PT_PT, RU, SK, SL and UK.
    • Built to be extended
    • Explain command line utility

Usage examples


  • create the ODM version
  • save filter criteria
  • export list