Nav apraksta

Thomas Rabaix 002afd4ad0 Add ModelFilterTest 14 gadi atpakaļ
Admin 789802d1a8 Fix nested admin list filtering, add ModelReferenceType 14 gadi atpakaļ
Builder 9868bd0d47 Fix widget being rendered in a select 14 gadi atpakaļ
Command c38627afe3 add more details in explain command output 14 gadi atpakaļ
Controller ae3cdfdcf8 Refactor filter to use the Form Framework 14 gadi atpakaļ
Datagrid ae3cdfdcf8 Refactor filter to use the Form Framework 14 gadi atpakaļ
DependencyInjection 27e256e202 add filter compiler pass 14 gadi atpakaļ
Filter 002afd4ad0 Add ModelFilterTest 14 gadi atpakaļ
Form 789802d1a8 Fix nested admin list filtering, add ModelReferenceType 14 gadi atpakaļ
Guesser cf15783349 Add ModelFilter 14 gadi atpakaļ
Model 398a49603b Fix pagination 14 gadi atpakaļ
Resources 789802d1a8 Fix nested admin list filtering, add ModelReferenceType 14 gadi atpakaļ
Route 807e164dbe Add check for route existance, add unit test 14 gadi atpakaļ
Security ba17ba305b tweak AclSecurityHandler to return false on AuthenticationCredentialsNotFoundException 14 gadi atpakaļ
Show 3896ed5c24 Fixed the phpdoc for the mappers to make the fluent api friendly with IDEs 14 gadi atpakaļ
Tests 002afd4ad0 Add ModelFilterTest 14 gadi atpakaļ
Twig ae3cdfdcf8 Refactor filter to use the Form Framework 14 gadi atpakaļ
Util 0dc07aea65 Initial form refactoring 14 gadi atpakaļ
Validator 80a7bd9a40 Improve the ErrorElement class 14 gadi atpakaļ
.gitignore f5c060c3ac Updated translations to be aligned to english translations 14 gadi atpakaļ
CHANGES 224acf185d Update documentation, remove obsolete code, fix bugs 14 gadi atpakaļ
CREDITS e0e3e92a69 update README, add missing type 14 gadi atpakaļ
LICENSE 5b24344281 add jquery.form.js to allows file upload from a modal window 14 gadi atpakaļ
README.md 74db6a7157 added syntax highlighting for php in readme 14 gadi atpakaļ
SonataAdminBundle.php 27e256e202 add filter compiler pass 14 gadi atpakaļ
phpunit.xml.dist 51fb49c0ca update references from BaseApplicationBundle to AdminBundle 14 gadi atpakaļ

README.md

SonataAdminBundle - The missing Symfony2 Admin Generator

The documentation of the bundle is in 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.

Quick example

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

<?php
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)
    {
        $showMapper
            ->add('author')
            ->add('enabled')
            ->add('title')
            ->add('abstract')
            ->add('content')
            ->add('tags')
        ;
    }

    public function configureFormFields(FormMapper $formMapper)
    {
        $formMapper
            ->with('General')
                ->add('enabled', null, array('required' => false))
                ->add('author', 'sonata_type_model', array(), array('edit' => 'list'))
                ->add('title')
                ->add('abstract')
                ->add('content')
            ->end()
            ->with('Tags')
                ->add('tags', 'sonata_type_model', array('expanded' => true))
            ->end()
            ->with('Options', array('collapsed' => true))
                ->add('commentsCloseAt')
                ->add('commentsEnabled', null, array('required' => false))
            ->end()
        ;
    }

    public function configureListFields(ListMapper $listMapper)
    {
        $listMapper
            ->addIdentifier('title')
            ->add('author')
            ->add('enabled')
            ->add('tags')
            ->add('commentsEnabled')
        ;
    }

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

Screenshots : http://www.dropbox.com/gallery/581816/2/BaseApplicationBundle/preview?h=59b2e8

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

Features

  • 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 12 languages : DE, EN, ES, FR, IT, JA, NL, PL, PT_BR, PT_PT, RU and UK.
    • Built to be extended
    • Explain command line utility

Usage examples

TODO

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