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:

Properties

setup.default.[someProperty]

setup.default.[someProperty]
Type
any

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]

setup.override.[someProperty]
Type
mixed

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

setup.fields.[fieldName].disabled
Type
boolean

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

backendTitleFormat
Type
string

Format of window title in backend. Possible values:

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

copyLevels

copyLevels
Type
positive integer

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

edit_docModuleUpload

edit_docModuleUpload
Type
boolean

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

emailMeAtLogin

emailMeAtLogin
Type
boolean

Notify me by email, when somebody logs into my account

lang

lang
Type
language-key

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

neverHideAtCopy

neverHideAtCopy
Type
boolean

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

showHiddenFilesAndFolders

showHiddenFilesAndFolders
Type
boolean

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

startModule

startModule
Type
string

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

titleLen
Type
positive integer

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