Nenhuma descrição

David Buchmann 92e7bbac87 clean up doc comments on ModelManagerInterface 13 anos atrás
Admin 86be523ac7 Merge branch '2.0' of https://github.com/sonata-project/SonataAdminBundle 13 anos atrás
Block c23e0ca311 Update Block/AdminListBlockService.php 13 anos atrás
Builder 4c9bff8a46 Fix CS 13 anos atrás
Command df2df5064d Fix some CS 13 anos atrás
Controller 55bdddb315 merged 2.0 13 anos atrás
Datagrid 55bdddb315 merged 2.0 13 anos atrás
DependencyInjection bc19371a36 Update DependencyInjection/Compiler/AddDependencyCallsCompilerPass.php 13 anos atrás
Exception 5b75b51303 Refactoring of NoValueException 13 anos atrás
Export 4c9bff8a46 Fix CS 13 anos atrás
Filter 55bdddb315 merged 2.0 13 anos atrás
Form 45c6d2aa6f Follows the BC Breaks induced by the new Form Component of 2.1 on the filters 13 anos atrás
Guesser 4c9bff8a46 Fix CS 13 anos atrás
Model 92e7bbac87 clean up doc comments on ModelManagerInterface 13 anos atrás
Resources 984df1a986 Merge pull request #795 from sjopet/master 13 anos atrás
Route 4c9bff8a46 Fix CS 13 anos atrás
Security 55bdddb315 merged 2.0 13 anos atrás
Show df2df5064d Fix some CS 13 anos atrás
Tests 55bdddb315 merged 2.0 13 anos atrás
Translator 4c9bff8a46 Fix CS 13 anos atrás
Twig df2df5064d Fix some CS 13 anos atrás
Util 4c9bff8a46 Fix CS 13 anos atrás
Validator 55bdddb315 merged 2.0 13 anos atrás
.gitignore 106e96a94d fixed merging bugs 13 anos atrás
.travis.yml 97fc0118d3 fixed version conflicts 13 anos atrás
CHANGELOG.md 697497beda Fix tests 13 anos atrás
CREDITS e0e3e92a69 update README, add missing type 14 anos atrás
LICENSE 5b24344281 add jquery.form.js to allows file upload from a modal window 14 anos atrás
README.md 116f800b79 Link to demo website 13 anos atrás
SonataAdminBundle.php 59285d5b29 Fix some CS 13 anos atrás
build.xml 6c44a03ce4 Move 'jms/translation-bundle' composer dependency into dev requirements 13 anos atrás
composer.json 3b6bc0aecd Update composer.json 13 anos atrás
phpunit.xml.dist c30bd9426d Add build process for jenkins integration 13 anos atrás

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