SonataAdminBundle/Resources/doc/reference/configuration.rst

Configuration // Warning: this doc page is not up to date and will be removed soon.
===================================================================================

.. note::
    This page will be removed soon, as it's content is being improved and moved to
    other pages of the documentation. Please refer to each section's documentation for up-to-date
    information on SonataAdminBundle configuration options.

Configuration
-------------

Configuration options

* ``security``
    * ``handler``
        * ``sonata.admin.security.handler.role`` : The default value
        * ``sonata.admin.security.handler.acl`` : Use this service if you want ACL


Full Configuration Options
--------------------------

.. configuration-block::

    .. code-block:: yaml

    # Default configuration for "SonataAdminBundle"
    sonata_admin:
        security:
            handler:              sonata.admin.security.handler.noop
            information:

                # Prototype
                id:                   []
            admin_permissions:

                # Defaults:
                - CREATE
                - LIST
                - DELETE
                - UNDELETE
                - EXPORT
                - OPERATOR
                - MASTER
            object_permissions:

                # Defaults:
                - VIEW
                - EDIT
                - DELETE
                - UNDELETE
                - OPERATOR
                - MASTER
                - OWNER
            acl_user_manager:     ~         # Name of the user manager service used to retrieve ACL users
        title:                Sonata Admin
        title_logo:           bundles/sonataadmin/logo_title.png
        options:
            html5_validate:       true      # use html5 validation
            confirm_exit:         true      # enabled confirmation when quitting with unsaved changes
            use_select2:          true      # enable select2
            pager_links:          ~         # pager max links to display
        dashboard:
            groups:

                # Prototype
                id:
                    label:                ~
                    label_catalogue:      ~
                    items:                []
                    item_adds:            []
                    roles:                []
            blocks:
                type:                 ~
                settings:

                    # Prototype
                    id:                   []
                position:             right
        admin_services:

            # Prototype
            id:
                model_manager:        ~
                form_contractor:      ~
                show_builder:         ~
                list_builder:         ~
                datagrid_builder:     ~
                translator:           ~
                configuration_pool:   ~
                router:               ~
                validator:            ~
                security_handler:     ~
                label:                ~
        templates:
            user_block:           SonataAdminBundle:Core:user_block.html.twig
            layout:               SonataAdminBundle::standard_layout.html.twig
            ajax:                 SonataAdminBundle::ajax_layout.html.twig
            dashboard:            SonataAdminBundle:Core:dashboard.html.twig
            search:               SonataAdminBundle:Core:search.html.twig
            list:                 SonataAdminBundle:CRUD:list.html.twig
            show:                 SonataAdminBundle:CRUD:show.html.twig
            edit:                 SonataAdminBundle:CRUD:edit.html.twig
            preview:              SonataAdminBundle:CRUD:preview.html.twig
            history:              SonataAdminBundle:CRUD:history.html.twig
            acl:                  SonataAdminBundle:CRUD:acl.html.twig
            history_revision_timestamp:  SonataAdminBundle:CRUD:history_revision_timestamp.html.twig
            action:               SonataAdminBundle:CRUD:action.html.twig
            select:               SonataAdminBundle:CRUD:list__select.html.twig
            list_block:           SonataAdminBundle:Block:block_admin_list.html.twig
            search_result_block:  SonataAdminBundle:Block:block_search_result.html.twig
            short_object_description:  SonataAdminBundle:Helper:short-object-description.html.twig
            delete:               SonataAdminBundle:CRUD:delete.html.twig
            batch:                SonataAdminBundle:CRUD:list__batch.html.twig
            batch_confirmation:   SonataAdminBundle:CRUD:batch_confirmation.html.twig
            inner_list_row:       SonataAdminBundle:CRUD:list_inner_row.html.twig
            base_list_field:      SonataAdminBundle:CRUD:base_list_field.html.twig
            pager_links:          SonataAdminBundle:Pager:links.html.twig
            pager_results:        SonataAdminBundle:Pager:results.html.twig
        extensions:

            # Prototype
            id:
                admins:               []
                excludes:             []
                implements:           []
                extends:              []
                instanceof:           []
        persist_filters:      false     # set to true to persist filter settings per admin module in the user's session