Без опису

Michel Weimerskirch 81b5ad34b2 Doc changes for Symfony2.1 + Composer 13 роки тому
Admin 86be523ac7 Merge branch '2.0' of https://github.com/sonata-project/SonataAdminBundle 13 роки тому
Block c23e0ca311 Update Block/AdminListBlockService.php 13 роки тому
Builder 4c9bff8a46 Fix CS 13 роки тому
Command df2df5064d Fix some CS 13 роки тому
Controller 55bdddb315 merged 2.0 13 роки тому
Datagrid 55bdddb315 merged 2.0 13 роки тому
DependencyInjection bc19371a36 Update DependencyInjection/Compiler/AddDependencyCallsCompilerPass.php 13 роки тому
Exception 5b75b51303 Refactoring of NoValueException 13 роки тому
Export 4c9bff8a46 Fix CS 13 роки тому
Filter 55bdddb315 merged 2.0 13 роки тому
Form 0e78c9fb4a Fix param transposition 13 роки тому
Guesser 4c9bff8a46 Fix CS 13 роки тому
Model 92e7bbac87 clean up doc comments on ModelManagerInterface 13 роки тому
Resources 81b5ad34b2 Doc changes for Symfony2.1 + Composer 13 роки тому
Route 4c9bff8a46 Fix CS 13 роки тому
Security 55bdddb315 merged 2.0 13 роки тому
Show df2df5064d Fix some CS 13 роки тому
Tests 55bdddb315 merged 2.0 13 роки тому
Translator 4c9bff8a46 Fix CS 13 роки тому
Twig df2df5064d Fix some CS 13 роки тому
Util 4c9bff8a46 Fix CS 13 роки тому
Validator 55bdddb315 merged 2.0 13 роки тому
.gitignore 106e96a94d fixed merging bugs 13 роки тому
.travis.yml 97fc0118d3 fixed version conflicts 13 роки тому
CHANGELOG.md 697497beda Fix tests 13 роки тому
CREDITS e0e3e92a69 update README, add missing type 14 роки тому
LICENSE 5b24344281 add jquery.form.js to allows file upload from a modal window 14 роки тому
README.md 116f800b79 Link to demo website 13 роки тому
SonataAdminBundle.php 59285d5b29 Fix some CS 13 роки тому
build.xml 6c44a03ce4 Move 'jms/translation-bundle' composer dependency into dev requirements 13 роки тому
composer.json 3b6bc0aecd Update composer.json 13 роки тому
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