暫無描述

Thomas 96d079d86b Merge pull request #1452 from lsmith77/composer_tweaks 12 年之前
Admin eba377e3cc Merge pull request #1436 from fluxuator/master 12 年之前
Block 6bc9128445 Fix allowed type 12 年之前
Builder 1de9430666 Typo in class name 12 年之前
Command 1394100cd8 Fix deprecated call 12 年之前
Controller e8f6e35cfe The preg_replace() /e modifier is deprecated from PHP5.5.0. 12 年之前
Datagrid 065bcb7688 Added a simple base mapper that holds some common fields 12 年之前
DependencyInjection e8f6e35cfe The preg_replace() /e modifier is deprecated from PHP5.5.0. 12 年之前
Exception cae5a7df03 Apply PHP-CS-Fixer 12 年之前
Export 0ba9efeba3 Added BOM to CSV export files 12 年之前
Filter cae5a7df03 Apply PHP-CS-Fixer 12 年之前
Form 49f252d5f1 Added support for setting group translation_domain 12 年之前
Guesser cae5a7df03 Apply PHP-CS-Fixer 12 年之前
Mapper 49f252d5f1 Added support for setting group translation_domain 12 年之前
Model cae5a7df03 Apply PHP-CS-Fixer 12 年之前
Resources a80dc343a9 PR for Issue #1291. Support of the custom prototype names 12 年之前
Route fb57d1f033 Allow method chaining for add methods 12 年之前
Security cae5a7df03 Apply PHP-CS-Fixer 12 年之前
Show 890f19736f Added a grouped mapper to handle mappers that group fields together 12 年之前
Tests 431a0c7bef Added boolean and trans tests in SonataAdminExtension 12 年之前
Translator 312f4af9dc Fix NativeLabelTranslatorStrategy whitespace bug 12 年之前
Twig d99ad4b5dc Fix bug in getTemplate method 12 年之前
Util cae5a7df03 Apply PHP-CS-Fixer 12 年之前
Validator bd08b55ed6 Implemented ConstraintValidator::validate() 12 年之前
.gitignore 106e96a94d fixed merging bugs 13 年之前
.travis.yml 92b426563b Added PHP 5.5 to .travis.yml 12 年之前
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 5270b115d9 Update README.md 12 年之前
SonataAdminBundle.php cae5a7df03 Apply PHP-CS-Fixer 12 年之前
UPGRADE-2.1.md 7432a415ea Update UPGRADE-2.1.md 12 年之前
UPGRADE-2.2.md 9c9589378f Update UPGRADE-2.2.md 12 年之前
build.xml eab3965686 Update composer.json 12 年之前
composer.json ae675ae2d8 fixed BlockBundle 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 (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