advanced_usage.rst

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

# 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

# config/packages/sonata_page.yaml

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