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]
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.

Attention

There is a tricky aspect to these setup.override: 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!

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

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.

Note

The uploaded file will be stored in the default upload folder, see user TSconfig and page TSconfig

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.

Tip

To find out where this setting is applied, set it to a low number.