Sin descripción

Thomas c0e21c2350 Merge pull request #229 from vslinko/missed_if hace 14 años
Admin 728907beac Fix nested admin hace 14 años
Builder 224acf185d Update documentation, remove obsolete code, fix bugs hace 14 años
Command 1cc5803d2e changed $this->container to $this->getContainer() hace 14 años
Controller ec25c1d068 refactor a bit the render method hace 14 años
Datagrid e84824afeb Implements List/Show/Filter guesser hace 14 años
DependencyInjection e84824afeb Implements List/Show/Filter guesser hace 14 años
Filter 3efab485ba Fix filter bug on empty value hace 14 años
Form 224acf185d Update documentation, remove obsolete code, fix bugs hace 14 años
Guesser 224acf185d Update documentation, remove obsolete code, fix bugs hace 14 años
Model 224acf185d Update documentation, remove obsolete code, fix bugs hace 14 años
Resources 2555227343 Missed if hace 14 años
Route 807e164dbe Add check for route existance, add unit test hace 14 años
Security 6b2e10a4b4 Refactor the show action, rename view => show, fix bug and missing implementation hace 14 años
Show 9172b8f70f Refactor the show groups feature hace 14 años
Tests 807e164dbe Add check for route existance, add unit test hace 14 años
Twig 6b2e10a4b4 Refactor the show action, rename view => show, fix bug and missing implementation hace 14 años
Util 0dc07aea65 Initial form refactoring hace 14 años
Validator 80a7bd9a40 Improve the ErrorElement class hace 14 años
.gitignore f5c060c3ac Updated translations to be aligned to english translations hace 14 años
CHANGES 224acf185d Update documentation, remove obsolete code, fix bugs hace 14 años
CREDITS e0e3e92a69 update README, add missing type hace 14 años
LICENSE 5b24344281 add jquery.form.js to allows file upload from a modal window hace 14 años
README.md 224acf185d Update documentation, remove obsolete code, fix bugs hace 14 años
SonataAdminBundle.php e84824afeb Implements List/Show/Filter guesser hace 14 años
phpunit.xml.dist 51fb49c0ca update references from BaseApplicationBundle to AdminBundle hace 14 años

README.md

SonataAdminBundle - The missing Symfony2 Admin Generator

There is online documentation here:

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

More information

There is online documentation here:

If you want to contribute to this documentation, you need to go to the Resources/doc folder where the reStructuredText documentation is available. Please note the Github preview might break and hide some content.

Usage examples

TODO

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