Ei kuvausta

Sjoerd Peters 03d8d8fa01 added check to pager template to not show last-page button if its the same as next-page 12 vuotta sitten
Admin f6dfcf0a45 Merge branch '2.1' 12 vuotta sitten
Block 6bc9128445 Fix allowed type 12 vuotta sitten
Builder 1de9430666 Typo in class name 12 vuotta sitten
Command cae5a7df03 Apply PHP-CS-Fixer 12 vuotta sitten
Controller 2e71ed0188 Merge branch '2.1' 12 vuotta sitten
Datagrid 065bcb7688 Added a simple base mapper that holds some common fields 12 vuotta sitten
DependencyInjection a03c464ea8 Merge pull request #1349 from virtualize/master 12 vuotta sitten
Exception cae5a7df03 Apply PHP-CS-Fixer 12 vuotta sitten
Export 0ba9efeba3 Added BOM to CSV export files 12 vuotta sitten
Filter cae5a7df03 Apply PHP-CS-Fixer 12 vuotta sitten
Form 890f19736f Added a grouped mapper to handle mappers that group fields together 12 vuotta sitten
Guesser cae5a7df03 Apply PHP-CS-Fixer 12 vuotta sitten
Mapper 05ef01c96b Added comments to warn about the discussion in sonata-project/SonataAdminBundle#1351 12 vuotta sitten
Model cae5a7df03 Apply PHP-CS-Fixer 12 vuotta sitten
Resources 03d8d8fa01 added check to pager template to not show last-page button if its the same as next-page 12 vuotta sitten
Route cae5a7df03 Apply PHP-CS-Fixer 12 vuotta sitten
Security cae5a7df03 Apply PHP-CS-Fixer 12 vuotta sitten
Show 890f19736f Added a grouped mapper to handle mappers that group fields together 12 vuotta sitten
Tests d17d17725d added feature to wire extensions dynamically using configuration 12 vuotta sitten
Translator f15aabd6bc made the logger optional in AdminExtractor 12 vuotta sitten
Twig 773d37651f Fix missing licences and fix some PSR 12 vuotta sitten
Util cae5a7df03 Apply PHP-CS-Fixer 12 vuotta sitten
Validator bd08b55ed6 Implemented ConstraintValidator::validate() 12 vuotta sitten
.gitignore 106e96a94d fixed merging bugs 13 vuotta sitten
.travis.yml 5d78a0098f remove SYMFONY_VERSION env var from .travis.yml 12 vuotta sitten
CHANGELOG.md 984a6c32ff Fixed typos 12 vuotta sitten
CREDITS 1f2459c1e8 restore famfam icon for legacy BC 12 vuotta sitten
LICENSE 1f2459c1e8 restore famfam icon for legacy BC 12 vuotta sitten
README.md 9eaded1c17 Update README.md 12 vuotta sitten
SonataAdminBundle.php cae5a7df03 Apply PHP-CS-Fixer 12 vuotta sitten
UPGRADE-2.1.md 325508ca99 Add tab layout 12 vuotta sitten
UPGRADE-2.2.md 325508ca99 Add tab layout 12 vuotta sitten
build.xml eab3965686 Update composer.json 12 vuotta sitten
composer.json 569b088b6c Merge pull request #1298 from tPl0ch/hotfix/composer-dev-requirements 12 vuotta sitten
phpunit.xml.dist c30bd9426d Add build process for jenkins integration 13 vuotta sitten

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 22 languages : BG, CA, CS, DE, EN, ES, EU, FA, FR, HR, IT, JA, LB, NL, PL, PT, PT_BR, 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