Extension folder Configuration/Sets

New in version 13.1

In this directory TYPO3 extensions can provide their Site sets.

Each set must be saved in its own directory and have at least a file called config.yaml.

config.yaml

config.yaml
Scope
set
Path (Composer)
packages/my_extension/Configuration/Sets/MySet/config.yaml
Path (Classic)
typo3conf/ext/my_extension/Configuration/Sets/MySet/config.yaml

Contains the definition of a site set and its dependencies.

Example:

EXT:site_package/Configuration/Sets/SitePackage/config.yaml 
name: t3docs/site-package
label: 'Site Package'
dependencies:
  - typo3/fluid-styled-content
  - typo3/fluid-styled-content-css
Copied!

settings.yaml

settings.yaml
Scope
set
Path (Composer)
packages/my_extension/Configuration/Sets/MySet/settings.yaml
Path (Classic)
typo3conf/ext/my_extension/Configuration/Sets/MySet/settings.yaml

In this file an extension can override settings defined by other sets. For example Settings provided by site set "Fluid Styled Content":

EXT:site_package/Configuration/Sets/SitePackage/settings.yaml 
styles:
    templates:
        layoutRootPath: EXT:site_package/Resources/Private/ContentElements/Layouts
        partialRootPath: EXT:site_package/Resources/Private/ContentElements/Partials
        templateRootPath: EXT:site_package/Resources/Private/ContentElements/Templates
    content:
        textmedia:
            maxW: 1200
            maxWInText: 600
            linkWrap:
                lightboxEnabled: true
                lightboxCssClass: lightbox
Copied!

settings.definitions.yaml

settings.definitions.yaml
Scope
set
Path (Composer)
packages/my_extension/Configuration/Sets/MySet/settings.definitions.yaml
Path (Classic)
typo3conf/ext/my_extension/Configuration/Sets/MySet/settings.definitions.yaml

In this file an extension can define its own settings: Site settings definitions.

setup.typoscript

setup.typoscript
Scope
set
Path (Composer)
packages/my_extension/Configuration/Sets/MySet/setup.typoscript
Path (Classic)
typo3conf/ext/my_extension/Configuration/Sets/MySet/setup.typoscript

This file contains the Frontend TypoScript that the set should provide. If the extension keeps its TypoScript in folder TypoScript for backward compatibility reasons this file should contain an import of file Configuration/TypoScript/setup.typoscript for the main set of the extension:

EXT:my_extension/Configuration/Sets/MySet/setup.typoscript 
# For backward compatibility reasons setup.typoscript was not moved
@import 'EXT:my_extension/Configuration/TypoScript/setup.typoscript'
Copied!

constants.typoscript

constants.typoscript
Scope
set
Path (Composer)
packages/my_extension/Configuration/Sets/MySet/constants.typoscript
Path (Classic)
typo3conf/ext/my_extension/Configuration/Sets/MySet/constants.typoscript

This file contains the Frontend TypoScript Constants that the set should provide. This file can be used if your extension depends on other extensions that still rely on TypoScript constants.

page.tsconfig

page.tsconfig
Scope
set
Path (Composer)
packages/my_extension/Configuration/Sets/MySet/page.tsconfig
Path (Classic)
typo3conf/ext/my_extension/Configuration/Sets/MySet/page.tsconfig

This file contains the Page TSconfig (backend TypoScript) that the set should provide.