setup

Default values and override values for the User Settings module.

The User > User settings module may only represent a subset of the options from the table below.

Default values and overriding values in the "User > User settings" module

Default values and overriding values in the User > User settings module

Properties from the list below are available the different prefixes setup.default and setup.override, and there is another prefix to hide single fields:

setup.default.[someProperty]

This sets default values of the property. A user may override these using its User Settings module. This affects only new users who did not login yet. It is not usually not possible to set new defaults for users who already logged in at least once. The only way to apply new defaults to existing users is by Reset Backend User Preferences in the Admin tools > Maintenance section of the install tool.

EXT:site_package/Configuration/user.tsconfig
[backend.user.isAdmin]
   # Some settings an administrator might find helpful
   setup.default {
      recursiveDelete = 1
      copyLevels = 99
      moduleData {
         # Defaulting some options of the Template/TypoScript backend module
         web_ts {
            # Pre-select 'Object browser' instead of 'Constant editor'
            function = TYPO3\CMS\Tstemplate\Controller\TypoScriptTemplateObjectBrowserModuleFunctionController
            # Pre-select 'Setup' instead of 'Constants'
            ts_browser_type = setup
            # The other settings
            ts_browser_const = subst
            ts_browser_fixedLgd = 0
            ts_browser_showComments = 1
         }
      }
   }
[END]
Copied!
setup.override.[someProperty]

This forces values for the properties of the list below, a user can not override these setting in its User settings module. So, overriding values will be impossible for the user to change himself and no matter what the current value is, the overriding value will overrule it.

setup.fields.[fieldName].disabled

On top of being able to set default values or override them, it is also possible to hide fields in the User Settings module, using setup.fields.[fieldName].disabled = 1. You can find the names of the fields in the Configuration module by browsing the "User Settings" array, example:

EXT:site_package/Configuration/user.tsconfig
# Do not show the 'emailMeAtLogin' field to the user in "User Settings" module
setup.fields.emailMeAtLogin.disabled = 1

# And force the value of this field to be set to 1
setup.override.emailMeAtLogin = 1
Copied!

backendTitleFormat

Datatype
string
Description

Format of window title in backend. Possible values:

titleFirst
[title] · [sitename]
sitenameFirst
[sitename] · [title]

copyLevels

Datatype
positive integer
Description
Recursive Copy: Enter the number of page sub-levels to include, when a page is copied

edit_docModuleUpload

Datatype
boolean
Description

Allow file upload directly from file reference fields within backend forms.

emailMeAtLogin

Datatype
boolean
Description
Notify me by email, when somebody logs into my account

lang

Datatype
language-key
Description
One of the language keys. For current options see Supported languages, for example dk, de, es etc.

neverHideAtCopy

Datatype
boolean
Description
If set, then the hideAtCopy feature for records in TCE will not be used.

showHiddenFilesAndFolders

Datatype
boolean
Description
If set, hidden files and folders will be shown in the filelist.

startModule

Datatype
string
Description
Name of the module that is called when the user logs into the backend, for example web_layout, web_list, web_view, web_info, web_ts etc.

titleLen

Datatype
positive integer
Description

Maximum length of rendered record titles in the backend interface. It is used in several places: page tree, edit masks, workspace module, etc.