Нет описания

marc 2cd05771a3 Update FormProxy:add declaration 12 лет назад
Admin 984a6c32ff Fixed typos 12 лет назад
Block c23e0ca311 Update Block/AdminListBlockService.php 13 лет назад
Builder d0f8e2fda3 Distinct field building and adding action for ListBuilder. 13 лет назад
Command 73d507571c some phpdoc fixes and improve code view 13 лет назад
Controller ab7d888e20 Remove deprecated function call Form::bindRequest 12 лет назад
Datagrid 73d507571c some phpdoc fixes and improve code view 13 лет назад
DependencyInjection 4a3cec84f8 Fixed variable name 12 лет назад
Exception 5b75b51303 Refactoring of NoValueException 13 лет назад
Export 73d507571c some phpdoc fixes and improve code view 13 лет назад
Filter fe11f07f77 fixed filtering on sub-entities for sf 2.1 13 лет назад
Form 2cd05771a3 Update FormProxy:add declaration 12 лет назад
Guesser 73d507571c some phpdoc fixes and improve code view 13 лет назад
Model 73d507571c some phpdoc fixes and improve code view 13 лет назад
Resources d910338de3 Added Basque translations 12 лет назад
Route 73d507571c some phpdoc fixes and improve code view 13 лет назад
Security 73d507571c some phpdoc fixes and improve code view 13 лет назад
Show 83eb838e13 Add a safe option for template 12 лет назад
Tests 99a3b8bb2c Fixed unit tests 12 лет назад
Translator 4c9bff8a46 Fix CS 13 лет назад
Twig 73d507571c some phpdoc fixes and improve code view 13 лет назад
Util 73d507571c some phpdoc fixes and improve code view 13 лет назад
Validator 73d507571c some phpdoc fixes and improve code view 13 лет назад
.gitignore 106e96a94d fixed merging bugs 13 лет назад
.travis.yml 44006a5956 Update travis file 13 лет назад
CHANGELOG.md 984a6c32ff Fixed typos 12 лет назад
CREDITS 1f2459c1e8 restore famfam icon for legacy BC 12 лет назад
LICENSE 1f2459c1e8 restore famfam icon for legacy BC 12 лет назад
README.md 116f800b79 Link to demo website 13 лет назад
SonataAdminBundle.php 59285d5b29 Fix some CS 13 лет назад
UPGRADE-2.1.md c8a1b417f2 revert back to KnpMenuBundle 1.1.* (ie. revert 33a7649afa51a009a8849de46e79cc600fc5dba3) 13 лет назад
build.xml eab3965686 Update composer.json 12 лет назад
composer.json 0513b90bba Add missing dependency 12 лет назад
phpunit.xml.dist c30bd9426d Add build process for jenkins integration 13 лет назад

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 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

TODO

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