Advanced usage
==============

Ignore options
--------------

By default, the ``PageBundle`` decorates all pages. However it is possible to
tweak this behavior by ignoring patterns :

==========================      ===========================
Key                             Description
==========================      ===========================
**ignore_route_patterns**       based on pattern
**ignore_routes**               based on the route name
**ignore_uri_patterns**         based on the an uri pattern
==========================      ===========================

.. code-block:: yaml

    # config/packages/sonata_page.yaml

    sonata_page:
        ignore_route_patterns:
            - (.*)admin(.*)   # ignore admin route, i.e. route containing 'admin'
            - ^_(.*)          # ignore symfony routes

        ignore_uri_patterns:
            - ^/admin\/     # ignore admin route, i.e. route containing 'admin'

Page default options
--------------------
It's possible to redefine settings for autogenerated pages (like command update
core routes):

 - ``page_defaults`` : defaults for page properties, used in update page
   routes command

.. code-block:: yaml

    # config/packages/sonata_page.yaml

    sonata_page:
        page_defaults:
            homepage: { decorate: false } # disable decoration for route 'homepage'