Bez popisu

Thomas 60d0379f80 Merge pull request #778 from damienalexandre/add_template_block před 13 roky
Admin 858d29c482 Allow read-only fields when editing collections of entities. před 13 roky
Block 4c9bff8a46 Fix CS před 13 roky
Builder 4c9bff8a46 Fix CS před 13 roky
Command df2df5064d Fix some CS před 13 roky
Controller 858d29c482 Allow read-only fields when editing collections of entities. před 13 roky
Datagrid 4c9bff8a46 Fix CS před 13 roky
DependencyInjection 74b85b8605 allow multiple filter type tags před 13 roky
Exception 5b75b51303 Refactoring of NoValueException před 13 roky
Export 4c9bff8a46 Fix CS před 13 roky
Filter 4c9bff8a46 Fix CS před 13 roky
Form 4c9bff8a46 Fix CS před 13 roky
Guesser 4c9bff8a46 Fix CS před 13 roky
Model f9dd8e6389 Fix method signature před 13 roky
Resources 60d0379f80 Merge pull request #778 from damienalexandre/add_template_block před 13 roky
Route 4c9bff8a46 Fix CS před 13 roky
Security 4c9bff8a46 Fix CS před 13 roky
Show df2df5064d Fix some CS před 13 roky
Tests 697497beda Fix tests před 13 roky
Translator 4c9bff8a46 Fix CS před 13 roky
Twig df2df5064d Fix some CS před 13 roky
Util 4c9bff8a46 Fix CS před 13 roky
Validator 4c9bff8a46 Fix CS před 13 roky
.gitignore c30bd9426d Add build process for jenkins integration před 13 roky
.travis.yml 2720a7dfbf Update travis config to use composer to load test dependencies před 13 roky
CHANGELOG.md 697497beda Fix tests před 13 roky
CREDITS e0e3e92a69 update README, add missing type před 14 roky
LICENSE 5b24344281 add jquery.form.js to allows file upload from a modal window před 14 roky
README.md 116f800b79 Link to demo website před 13 roky
SonataAdminBundle.php 59285d5b29 Fix some CS před 13 roky
build.xml 6c44a03ce4 Move 'jms/translation-bundle' composer dependency into dev requirements před 13 roky
composer.json 07c83d489b Changed the KnpMenuBundle requirement to use the released version před 13 roky
phpunit.xml.dist c30bd9426d Add build process for jenkins integration před 13 roky

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