No Description

Tiago Garcia 404ed30bef wrap nav menu in block for easier customization 12 years ago
Admin 51fb3d156c Add row selector for sonata_type_model_list 12 years ago
Block 6bc9128445 Fix allowed type 12 years ago
Builder 1de9430666 Typo in class name 12 years ago
Command 1394100cd8 Fix deprecated call 12 years ago
Controller 6e2167d470 Update preview mode 12 years ago
Datagrid 065bcb7688 Added a simple base mapper that holds some common fields 12 years ago
DependencyInjection 51fb3d156c Add row selector for sonata_type_model_list 12 years ago
Exception cae5a7df03 Apply PHP-CS-Fixer 12 years ago
Export 0ba9efeba3 Added BOM to CSV export files 12 years ago
Filter cae5a7df03 Apply PHP-CS-Fixer 12 years ago
Form 49f252d5f1 Added support for setting group translation_domain 12 years ago
Guesser cae5a7df03 Apply PHP-CS-Fixer 12 years ago
Mapper 49f252d5f1 Added support for setting group translation_domain 12 years ago
Model cae5a7df03 Apply PHP-CS-Fixer 12 years ago
Resources 404ed30bef wrap nav menu in block for easier customization 12 years ago
Route fb57d1f033 Allow method chaining for add methods 12 years ago
Security cae5a7df03 Apply PHP-CS-Fixer 12 years ago
Show 890f19736f Added a grouped mapper to handle mappers that group fields together 12 years ago
Tests 431a0c7bef Added boolean and trans tests in SonataAdminExtension 12 years ago
Translator 312f4af9dc Fix NativeLabelTranslatorStrategy whitespace bug 12 years ago
Twig d99ad4b5dc Fix bug in getTemplate method 12 years ago
Util cae5a7df03 Apply PHP-CS-Fixer 12 years ago
Validator bd08b55ed6 Implemented ConstraintValidator::validate() 12 years ago
.gitignore 106e96a94d fixed merging bugs 13 years ago
.travis.yml 92b426563b Added PHP 5.5 to .travis.yml 12 years ago
CHANGELOG.md 984a6c32ff Fixed typos 12 years ago
CREDITS 1f2459c1e8 restore famfam icon for legacy BC 12 years ago
LICENSE 1f2459c1e8 restore famfam icon for legacy BC 12 years ago
README.md 5270b115d9 Update README.md 12 years ago
SonataAdminBundle.php cae5a7df03 Apply PHP-CS-Fixer 12 years ago
UPGRADE-2.1.md 7432a415ea Update UPGRADE-2.1.md 12 years ago
UPGRADE-2.2.md 9c9589378f Update UPGRADE-2.2.md 12 years ago
build.xml eab3965686 Update composer.json 12 years ago
composer.json b97512edae Fix composer.json config for exporter 12 years ago
phpunit.xml.dist c30bd9426d Add build process for jenkins integration 13 years ago

README.md

SonataAdminBundle - The missing Symfony2 Admin Generator

Build Status

The online documentation of the bundle is in http://sonata-project.org/bundles/admin

The demo website can be found in http://demo.sonata-project.org/admin/dashboard (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 (Fields in add function must be fields of your entity)

<?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 (dependency injection container).

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 24 languages : BG, CA, CS, DE, EN, ES, EU, FA, FR, HR, HU, IT, JA, LB, NL, PL, PT, PT_BR, RO, RU, SK, SL, UK and zh_CN.
    • Built to be extended
    • Explain command line utility

Usage examples

TODO

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