Attention
This manual is no longer being maintained for TYPO3 versions 11.5 and above. The majority of the content has been migrated to the Extbase or Fluid sections in "TYPO3 Explained".
Configuration¶
There are several possibilities to make your extension configurable. From the various options described here each differs in:
the scope to what the configuration applies (extension, pages, plugin)
the access level required to make the change (editor, admin)
TypoScript and Constants¶
You can define configuration options using TypoScript. These options can be changed via TypoScript constants and setup in the backend. The changes apply to the current page and all subpages.
See also
Extension Configuration¶
Extension Configuration is defined in the file ext_conf_template.txt
using TypoScript constant syntax.
The configuration options you define in this file can be changed in the backend ADMIN TOOLS > Settings > Extension Configuration.
Use this file for general options that should be globally applied to the extension.
FlexForms¶
FlexForms can be configured in the backend by editors. With FlexForms you can configure each plugin or content element individually.
See also
FlexForms are handled in "TYPO3 Explained". Only options specific to Extbase are covered here.
Access Settings¶
Important
If you wish to access a setting set via FlexForm from your controller via
$this->settings
, the name of the setting must begin with settings
directly followed by a dot (.
).
<settings.includeCategories>
<TCEforms>
<label>LLL:EXT:example/Resources/Private/Language/Backend.xlf:settings.registration.includeCategories</label>
<config>
<type>check</type>
<default>0</default>
<items type="array">
<numIndex index="0" type="array">
<numIndex index="0">LLL:EXT:bootstrap_package/Resources/Private/Language/Backend.xlf:setting.registration.includeCategories.title</numIndex>
</numIndex>
</items>
</config>
</TCEforms>
</settings.includeCategories>
The settings can be read using $this->settings
in an
Extbase controller action. And via {settings}
within Fluid.
$includeCategories = (bool) ($this->settings['includeCategories'] ?? false);