12. Advanced usage

12.1. 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'

12.2. 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'