11. Advanced usage

11.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
  • YAML
     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
    # config/packages/sonata_page.yaml

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

    ignore_routes:
        - sonata_page_cache_esi
        - sonata_page_cache_ssi

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

11.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
  • YAML
    1
2
3
4
5
    # config/packages/sonata_page.yaml

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