Sem descrição

Krzysztof Kolasiak b385edc785 Update Form/Type/TranslatableChoiceType.php há 13 anos atrás
Admin ce6f77154e Readded the supports preview mode getter and added another check for its value when determining preview mode há 13 anos atrás
Block c23e0ca311 Update Block/AdminListBlockService.php há 13 anos atrás
Builder d0f8e2fda3 Distinct field building and adding action for ListBuilder. há 13 anos atrás
Command df2df5064d Fix some CS há 13 anos atrás
Controller cd907afd93 Merge pull request #877 from thanosp/fix-form-extension-calls há 13 anos atrás
Datagrid b9cc7f2b71 Merge remote branch 'origin/2.0' há 13 anos atrás
DependencyInjection d863c365a7 Added optional preview mode for editing and creating entities há 13 anos atrás
Exception 5b75b51303 Refactoring of NoValueException há 13 anos atrás
Export e1b1f67612 Add StreamResponse support for export command há 13 anos atrás
Filter 55bdddb315 merged 2.0 há 13 anos atrás
Form b385edc785 Update Form/Type/TranslatableChoiceType.php há 13 anos atrás
Guesser 4c9bff8a46 Fix CS há 13 anos atrás
Model 2277812a51 Fix some CS há 13 anos atrás
Resources 36fa1799de Fix Form Component .... há 13 anos atrás
Route 4c9bff8a46 Fix CS há 13 anos atrás
Security 55bdddb315 merged 2.0 há 13 anos atrás
Show df2df5064d Fix some CS há 13 anos atrás
Tests 36fa1799de Fix Form Component .... há 13 anos atrás
Translator 4c9bff8a46 Fix CS há 13 anos atrás
Twig df2df5064d Fix some CS há 13 anos atrás
Util 902b9ef9ff Fix Form Component há 13 anos atrás
Validator ff1c009da8 Merge remote branch 'origin/2.0' há 13 anos atrás
.gitignore 106e96a94d fixed merging bugs há 13 anos atrás
.travis.yml 97fc0118d3 fixed version conflicts há 13 anos atrás
CHANGELOG.md b2f361dbbe Fix bug introduces by 09334d81, now an admin must have the role ``ROLE_SONATA_ADMIN`` to see the top bar navigation há 13 anos atrás
CREDITS e0e3e92a69 update README, add missing type há 14 anos atrás
LICENSE 5b24344281 add jquery.form.js to allows file upload from a modal window há 14 anos atrás
README.md 116f800b79 Link to demo website há 13 anos atrás
SonataAdminBundle.php 59285d5b29 Fix some CS há 13 anos atrás
UPGRADE-2.1.md c1932f459c rename UPGRATE-2.1.md to UPGRADE-2.1.md há 13 anos atrás
build.xml 6c44a03ce4 Move 'jms/translation-bundle' composer dependency into dev requirements há 13 anos atrás
composer.json f80e6b8deb Fix post merge issues and more BC work há 13 anos atrás
phpunit.xml.dist c30bd9426d Add build process for jenkins integration há 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