Keine Beschreibung

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

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