Aucune description

Thomas a1d1fe7f53 Merge pull request #1154 from WesleyVanOpdorp/Translation il y a 12 ans
Admin d2b3646f1b Fixed setCurrentUri() in buildSideMenu() il y a 12 ans
Block c23e0ca311 Update Block/AdminListBlockService.php il y a 13 ans
Builder 94e0b118d1 Remove @abstract from phpdoc il y a 12 ans
Command 73d507571c some phpdoc fixes and improve code view il y a 13 ans
Controller 5316b95ec8 Use native JsonResponse object il y a 12 ans
Datagrid b0fa2fe49c Update Datagrid/Datagrid.php il y a 12 ans
DependencyInjection 4a3cec84f8 Fixed variable name il y a 12 ans
Exception 5b75b51303 Refactoring of NoValueException il y a 13 ans
Export 73d507571c some phpdoc fixes and improve code view il y a 13 ans
Filter fe11f07f77 fixed filtering on sub-entities for sf 2.1 il y a 13 ans
Form e8c752e343 fix SonataAdminBundle #1099 il y a 12 ans
Guesser 73d507571c some phpdoc fixes and improve code view il y a 13 ans
Model 73d507571c some phpdoc fixes and improve code view il y a 13 ans
Resources 6aa9c92824 Fixed button translation il y a 12 ans
Route bff64d2dff Fixed Symfony naming convetion break il y a 12 ans
Security 73d507571c some phpdoc fixes and improve code view il y a 13 ans
Show 83eb838e13 Add a safe option for template il y a 12 ans
Tests 5316b95ec8 Use native JsonResponse object il y a 12 ans
Translator 4c9bff8a46 Fix CS il y a 13 ans
Twig 73d507571c some phpdoc fixes and improve code view il y a 13 ans
Util 73d507571c some phpdoc fixes and improve code view il y a 13 ans
Validator 24c52778ad fixed extra constraint violations il y a 12 ans
.gitignore 106e96a94d fixed merging bugs il y a 13 ans
.travis.yml 5d78a0098f remove SYMFONY_VERSION env var from .travis.yml il y a 12 ans
CHANGELOG.md 984a6c32ff Fixed typos il y a 12 ans
CREDITS 1f2459c1e8 restore famfam icon for legacy BC il y a 12 ans
LICENSE 1f2459c1e8 restore famfam icon for legacy BC il y a 12 ans
README.md adc00621a5 Fixed list of available translations il y a 12 ans
SonataAdminBundle.php 59285d5b29 Fix some CS il y a 13 ans
UPGRADE-2.1.md c8a1b417f2 revert back to KnpMenuBundle 1.1.* (ie. revert 33a7649afa51a009a8849de46e79cc600fc5dba3) il y a 13 ans
build.xml eab3965686 Update composer.json il y a 12 ans
composer.json 5d0b067977 require security-bundle il y a 12 ans
phpunit.xml.dist c30bd9426d Add build process for jenkins integration il y a 13 ans

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

<?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 22 languages : BG, CA, CS, DE, EN, ES, EU, FA, FR, HR, IT, JA, LB, NL, PL, PT, PT_BR, 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