Attention
TYPO3 v8 has reached its end-of-life March 31st, 2020 and is not maintained by the community anymore. Looking for a stable version? Use the version switch on the top left.
You can order Extended Long Term Support (ELTS) here: TYPO3 ELTS.
Top Level Objects¶
These are the User TSconfig Top Level Objects (TLOs):
Property
admPanel
Data type
->ADMPANEL
Description
Options regarding the frontend admin panel.
Property
options
Data type
->OPTIONS
Description
Options for the user, various
Property
mod
Data type
(see ->MOD of Page TSconfig)
Description
Overriding values for the backend modules
Deprecated. Use page.mod instead!
Property
setup.default
setup.override
Data type
->SETUP
Description
Default values and override values for the user settings known from the setup module.
Attention
There is a tricky aspect to these settings: If first you have set a value by setup.override and then remove it again, you will experience that the value persists to exist. This is because it is saved in the backend user's profile. Therefore, if you have once set a value, do not remove it again but rather set it blank if you want to disable the effect again!
Property
TCAdefaults.[table name].[field]
Data type
string
Description
Sets default values for records. The order of default values when creating new records in the backend is this:
Value from $GLOBALS['TCA']
Value from User TSconfig (these settings)
Value from Page TSconfig
Value from "defVals" GET variables (see BackendUtility::getModuleUrl('record_edit'))
Value from previous record based on 'useColumnsForDefaultValues'
However the order for default values used by TYPO3CMSCoreDataHandlingDataHandler if a certain field is not granted access to for user will be:
Value from $GLOBALS['TCA']
Value from User TSconfig (these settings)
So these values will be authoritative if the user has no access to the field anyway.
- Example
This sets the default hidden flag for pages to "clear".
TCAdefaults.pages.hidden = 0
Important
This example will not work when creating the page from the context menu since this is triggered by the values listed in the
ctrl
section oftypo3/sysext/core/Configuration/TCA/pages.php
:'ctrl' => [ 'useColumnsForDefaultValues' => 'doktype,fe_group,hidden',
If 'hidden' is in the list, it gets overwritten with the "neighbor" record value (see
\TYPO3\CMS\Backend\Form\FormDataProvider\DatabaseRowInitializeNew::setDefaultsFromNeighborRow
) and as the value is set - usually to '0' - it will not be overwritten again. To make it work as expected, that value must be overridden. This can be done for example in theConfiguration/TCA/Overrides
folder of an extension:$GLOBALS['TCA']['pages']['ctrl']['useColumnsForDefaultValues'] = 'doktype,fe_group';
Property
user
Data type
(whatever)
Description
This is for custom purposes.
Deprecated, use "tx_*" from extensions! See blow.
Property
auth
Data type
array
Description
Configuration for authentication services. Currently this is the only option:
auth.BE.redirectToURL
Specifies a URL to redirect to after login is performed in the backend login form.
Property
page
Data type
all page TSconfig properties
Description
You can override all page TSconfig properties by putting them into user TSconfig and prefixing them with page.
Example:
page.TCEMAIN.table.pages.disablePrependAtCopy = 1
Property
tx_[extension key with no underscore]
Data type
(whatever)
Description
This is reserved space for extensions.