options¶

additionalPreviewLanguages¶

Datatype

list of sys_language ids

Description

The user will see these additional languages when localizing stuff in TCEforms. The list are uid numbers of sys_language records.

alertPopups¶

Datatype

bitmask

Description

Configure which Javascript popup alerts have to be displayed and which not:

1 – onTypeChange

2 – copy / move / paste

4 – delete

8 – FE editing

128 – other (not used yet)

Default

255 (show all warnings)

bookmarkGroups¶

Datatype

Array of integers/ strings

Description

Set groups of bookmarks that can be accessed by the user. This affects the bookmarks toolbar item in the top right of the backend.

By default, 5 default groups will be defined globally (shared, can only be set by admins) and also for each user (personal bookmarks):

1. Pages
2. Records
3. Files
4. Tools
5. Miscellaneous

Set 0 to disable one of these group IDs, 1 to enable it (this is the default) or “string” to change the label accordingly.

Example

bookmarkGroups {
   1 = 1
   2 = My Group
   3 = 0
   4 =
}

Bookmark group 1 is loaded with the default label (Pages), group 2 is loaded and labeled as “My Group” and groups 3 and 4 are disabled. Group 5 has not been set, so it will be displayed by default, just like group 1.

clearCache.all¶

Datatype

boolean

Description

This will allow a non-admin user to clear frontend and page-related caches, plus some backend-related caches (that is everything including templates); if it is explicitly set to 0 for an admin user, it will remove the clear all option on toolbar for that user.

Default

0

clearCache.pages¶

Datatype

boolean

Description

If set to 1, this will allow a non-admin user to clear frontend and page-related caches.

Default

0

clipboardNumberPads¶

Datatype

integer (0-20)

Description

This allows you to enter how many pads you want on the clipboard.

Default

3

contextMenu disableItems¶

Datatype

list of items

Description

List of context menu (“clickmenu”) items to disable.

Context menu of the page tree

The full path of this property is: contextMenu.table.[tableName][.context].disableItems

The “[tableName]” refers to the type of the record (database table name) the context menu is shown for e.g. “pages”, “sys_file”, “tt_content”, etc.

Optional key “[.context]” refers to the place from which the context menu is triggered. The core uses just one context called tree for context menus triggered from page tree and folder tree. This way you can disable certain options for one context, but keep them for another.

Items to disable for “page” type are: view, edit, new, info, copy, copyRelease, cut, cutRelease, pasteAfter, pasteInto, newWizard, pagesSort, pagesNewMultiple, openListModule, mountAsTreeRoot, hideInMenus, showInMenus, permissions, enable, disable, delete, history, clearCache

Items to disable for “sys_file” type (that is files/folders) are: edit, rename, upload, new, info, copy, copyRelease, cut, cutRelease, pasteInto, delete

When the system extension Import/Export (impexp) is installed then two more options become available: exportT3d and importT3d

Example

# Remove "New" and "Create New wizard" for pages context menu (list module)
options.contextMenu.table.pages.disableItems = new,newWizard

# Remove "New" and "Create New wizard" in page tree context menu
options.contextMenu.table.pages.tree.disableItems = new,newWizard

# Remove the "More options" item in the page tree context menu and all its subelements
options.contextMenu.table.pages.tree.disableItems = newWizard, pagesSort, pagesNewMultiple, openListModule, mountAsTreeRoot, exportT3d, importT3d, hideInMenus, showInMenus, permissions

createFoldersInEB¶

Datatype

boolean

Description

If set, a createFolders option appears in the element browser (for admin-users this is always enabled).

defaultUploadFolder¶

Datatype

string

Description

When a user uploads files they are stored in the default upload folder of the first file storage that user may access. The folder is used for uploads in the TCEforms fields. In general, this will be fileadmin/user_upload.

With this property it is possible to set a specific upload folder.

The syntax is “storage_uid:file_path”.

Example

options.defaultUploadFolder = 2:user_folders/my_folder/

disableDelete¶

Datatype

boolean

Description

Disables the “Delete” button in TCEFORMs.

Note it is possible to set this for single tables using options.disableDelete.[tableName]. Any value set for a single table will override the default value set for “disableDelete”.

dontMountAdminMounts¶

Datatype

boolean

Description

This options prevents the root to be mounted for an admin user.

Note

Only for admin-users. For other users it has no effect.

enableBookmarks¶

Datatype

boolean

Description

Enables the usage of bookmarks in the backend.

Default

1

file_list¶

folderTree¶

hideModules.[moduleGroup]¶

Datatype

list of module groups or modules

Description

Configure which module groups or modules should be hidden from the main menu.

It is not an access restriction but makes defined modules invisible. That means in principle those modules can still be accessed if the rights allow.

A list of all available module groups and modules can be found in in the backend module SYSTEM -> Configuration -> $GLOBALS[‘TBE_MODULES’] (BE Modules)

Example

# Hide module groups "file" and "help"
options.hideModules = file, help

# Hide module "func" and "info" from the "web" group
options.hideModules.web := addToList(func,info)

# Hide module BELogLog from "system" group
options.hideModules.system = BelogLog

hideRecords.pages¶

Datatype

list of page ids

Description

This hides records in the backend user interface. It is not an access restriction but makes defined records invisible. That means in principle those records can still be edited if the user rights allow. This makes sense if only a specialized module should be used to edit those otherwise hidden records.

This option is currently implemented for the pages table only and has an effect in the following places:

• Page tree navigation frame
• Web > List module
• New record wizard

Example

options.hideRecords.pages = 12,45

impexp.enableImportForNonAdminUser¶

Datatype

boolean

Description

The import/export module of EXT:impext is disabled by default for non-admin users. Enable this option, if non-admin users need to use the module. This should only be enabled for trustworthy backend users, as it might impose a security risk.

Default

0

lockToIP¶

Datatype

string

Description

Comma separated list of IP-numbers with wildcards.

Note

This option is only enabled if the $GLOBALS['TYPO3_CONF_VARS']['BE']['enabledBeUserIPLock'] configuration is true.

Example

# Allow all from 192.168-network
options.lockToIP = 192.168.*.*

# Allow all from 192.168-network plus all from REMOTE_ADDR 212.22.33.44
options.lockToIP = 192.168.\*.\*, 212.22.33.44

# Same as the previous. Leaving out parts of the IP address is the same as wild cards.
options.lockToIP = 192.168, 212.22.33.44

mayNotCreateEditBookmarks¶

Datatype

boolean

Description

If set, the user can not create or edit bookmarks.

noThumbsInEB¶

Datatype

boolean

Description

If set, then image thumbnails are not shown in the element browser.

overridePageModule¶

Datatype

string

Description

By this value you can substitute the default “Web > Page” module key (“web_layout”) with another backend module key.

Note

This property has been introduced for TemplaVoila in the old days. It is of little use nowadays and can be achieved using hideModules, too.

Example

# Enable TemplaVoila page module as default page module.
options.overridePageModule = web_txtemplavoilaM1

pageTree¶

popupWindowSize¶

Datatype

string

Description

Defines the size of the element browser.

Note

This property is outdated.

saveClipboard¶

Datatype

boolean

Description

If set, the clipboard content will be preserved for the next login. Normally the clipboard content lasts only during the session.

saveDocNew¶

Datatype

boolean / “top”

Description

If set, a button “Save and create new” will appear in TCEFORMs.

Note it is possible to set this for single tables using options.saveDocNew.[tableName]. Any value set for a single table will override the default value set for “saveDocNew”.

Default

1

Example

In this example the button is disabled for all tables, except tt_content where it will appear, and in addition create the records in the top of the page (default is after instead of top).

options.saveDocNew = 0
options.saveDocNew.tt_content = top

saveDocView¶

Datatype

boolean

Description

If set, a button “Save and view” will appear in TCEFORMs.

Note it is possible to set this for single tables using options.saveDocView.[tableName]. Any value set for a single table will override the default value set for “saveDocView”.

Default

1

showDuplicate¶

Datatype

boolean

Description

If set, a button “Duplicate” will appear in TCEFORMs.

Note that it is possible to set this for single tables using options.showDuplicate.[tableName]. Any value set for a single table will override the default value set for saveDocView.

Default

0

showHistory¶

Datatype

boolean

Description

Shows link to the history for the record in TCEFORMs.

Note it is possible to set this for single tables using options.showHistory.[tableName]. Any value set for a single table will override the default value set for “showHistory”.

view.languageOrder¶

Datatype

list of sys_language ids

Description

When a backend user clicks a view-page link in the backend (magnifying glass) the first language uid in this list which the user has access to edit will be added as the language parameter to the view-link.

This is a useful setting for translators which primarily wish to see their translation when they click the view-links.

Example

options.view.languageOrder = 2,1