Configuration

By default, headless template and brick configurations are stored in Symfony config yaml files (under var/config/headless_templates & var/config/headless_bricks). It is also possible to store these configurations in settingsStore (database layer).

Example Config for Template and Brick Are:

pimcore_headless_documents:
      config_location:
          headless_templates:
            write_target:
                type: 'symfony-config'
                options:
                    directory: '/var/www/html/var/config/headless_templates'

pimcore_headless_documents:
      config_location:
         headless_bricks:
            write_target:
                type: 'symfony-config'
                options:
                    directory: '/var/www/html/var/config/headless_bricks'

You can change the write target for each type using the config.

The following target options are available:

• symfony-config - write configs as Symfony Config as YAML files
• settings-store - write configs to the SettingsStore
• disabled - do not allow to edit/write configs at all

Note: These configurations are merged from yaml files & settingsStore on loading & usage on headless documents. If you switch to a particular storage target, then migration & cleanup is required to be performed manually.

Grouping

It is possible to group configurations on editing interface with group property as follows:

pimcore_headless_documents:
    templates:
        test:
            group: Test
            layout: simple
            ...

pimcore_headless_documents:
    bricks:
        area1:
            group: Test
            type: brick
            ...

Custom Views & Perspective

Just like other document types, you can hide/show headless documents from context menu in perspectives custom view with following configuration:

pimcore:
    custom_views:
        definitions:
            no_headless_documents:
                name: no_headless_documents
                treetype: document
                position: left
                #...
                treeContextMenu:
                    document:
                        items:
                            #...
                            addHeadlessdocument: false # hide "Add Headlessdocument"
                            #...