暫無描述

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