web_layout.menu.function

Web > Page module

Option tags:

<select name="SET[function]">

    <option value="1">Columns</option>

    <option value="0">QuickEdit</option>

    <option value="2">Languages</option>

    <option value="3">Page information</option>

    <option value="4">Grid-View</option>

</select>

Example:

  # Disables all items except the "QuickEdit" item:

mod.web_layout.menu.function {

  1 = 0

  2 = 0

  3 = 0

  4 = 0

}

web_info.menu.function

Web > Info module

Option tags:

<select name="SET[function]">

    <option value="tx_cms_webinfo_page">Pagetree Overview</option>

    <option value="tx_cms_webinfo_lang">Localization Overview</option>

    <option value="tx_belog_webinfo">Log</option>

    <option value="tx_infopagetsconfig_webinfo">Page TSconfig</option>

    <option value="tx_linkvalidator_ModFuncReport">Linkvalidator</option>

    <option value="tx_realurl_modfunc1">Speaking Url Management</option>

    <option value="tx_indexedsearch_modfunc1">Indexed search</option>

    <option value="tx_indexedsearch_modfunc2">Indexed search statistics</option>

</select>

Note: The Module "Speaking Url Management" is provided by the extension RealURL, which is not part of the TYPO3 Core.

Example:

  # Disables the item "Indexed search statistics":

mod.web_info.menu.function {

  tx_indexedsearch_modfunc2 = 0

}

web_func.menu.function

Web > Functions module

Option tags:

<select name="SET[function]">

    <option value="tx_funcwizards_webfunc">Wizards</option>

</select>

web_func.menu.wiz

Web > Functions module, Wizards sub module

This is the 2nd-level Function Menu in the Web > Functions module. Instead of the "function" key of the main menu it just uses the key "wiz" instead.

Option tags:

<select name="SET[wiz]">

    <option value="tx_wizardcrpages_webfunc_2">Create multiple pages</option>

    <option value="tx_wizardsortpages_webfunc_2">Sort pages</option>

</select>

Example:

  # Disables the sub-item "Create multiple pages":

mod.web_func.menu.wiz {

  tx_wizardcrpages_webfunc_2 = 0

}

web_ts.menu.function

Web > Template module

Option tags:

<select name="SET[function]">

    <option value="tx_tstemplateceditor">Constant Editor</option>

    <option value="tx_tstemplateinfo">Info/Modify</option>

    <option value="tx_tstemplateobjbrowser">TypoScript Object Browser</option>

    <option value="tx_tstemplateanalyzer">Template Analyzer</option>

</select>

user_task.menu.function

User > Task Center

Prior to TYPO3 4.5 the Task Center worked the following way:

The Task Center does not provide a selector box function menu. But behind the scenes it uses the same functionality of saving "states" and therefore you can also blind items in the Task Center.

There is one tricky thing though: The Task Center is not depending on a page in the page tree! So you either have to set default Page TSconfig or User TSconfig to blind options here!

Keys are:

tx_sysnotepad = Quick Notetx_taskcenterrecent = Recent Pagestx_taskcenterrootlist = Web > List module / roottx_taskcentermodules = Pluginstx_sysaction = Actionstx_systodos = Tasks

Example:

Set this as User TSconfig:

  # Task Center configuration:

mod.user_task.menu.function {

    # Disable "Recent Pages" display:

  tx_taskcenterrecent = 0

    # Disable "Action" list

  tx_sysaction = 0

}

taskcenter

User > Task Center

In TYPO3 4.5 and newer the Task Center can be configured as follows:

The Task Center does not provide a selector box function menu holding the different tasks. But behind the scenes it uses the same functionality of saving "states" and therefore you can also blind items in the Task Center.

There is one tricky thing though: The Task Center is not depending on a page in the page tree! So you have to set User TSconfig to blind options here!

You can hide a task by using the following syntax in User TSconfig:

taskcenter {

  <extension-key>.<task-class> = 0

}

Be aware that <extension-key> needs to be replaced by the actual extension key and <task-class> by the class name of the PHP class providing the task.

Example:

Set this as User TSconfig:

  # Task Center configuration:

taskcenter {

    # Disable "Quick Note":

  sys_notepad.tx_sysnotepad_task = 0

    # Disable "Action":

  sys_action.tx_sysaction_task = 0

    # Disable "Import/Export":

  impexp.tx_impexp_task = 0

}

colPos_list

(list of integers, blank = don't do anything.)

This option lets you specify which columns of tt_content elements should be displayed in the 'Columns' view of the modules, in particular Web > Page.

By default there are four columns, Left, Normal, Right, Border. However most websites use only the Normal column, maybe another also. In that case the remaining columns are not needed. By this option you can specify exactly which of the columns you want to display.

Each column has a number which ultimately comes from the configuration of the table tt_content, field 'colPos' found in the tables.php file. This is the values of the four default columns:

Left: 1

Normal: 0

Right: 2

Border: 3

Example:

This results in only the Normal and Border column being displayed:

mod.SHARED.colPos_list = 0,3

defaultLanguageLabel

string

Alternative label for "Default" when language labels are shown in the interface.

Used in Web > List, Web > Page and TemplaVoilà page module.

defaultLanguageFlag

string

Filename of the file with the flag icon for the default language. Do not use the complete filename, but only the name without dot and extension. The file will be taken from typo3/gfx/flags/.

Used in Web > List and TemplaVoilà page module.

Example:

This will show the German flag.

mod.SHARED {

  defaultLanguageFlag = de

  defaultLanguageLabel = deutsch

}

Note:

Prior to TYPO3 4.5 you had to set the complete filename as defaultLanguageFlag, e.g. "de.gif" to get the German flag. In TYPO3 4.5 and newer you must use the name without dot and extension.

disableLanguages

string

Comma-separated list of language UID which will be disabled in the given page tree.

tt_content.colPos_list

(list of integers, blank = don't do anything.)

See mod.SHARED.colPos_list for details.

If non-blank, this list will override the one set by mod.SHARED.colPos_list.

Example:

This results in only the Normal and Border column being displayed:

mod.web_layout.tt_content.colPos_list = 0,3

tt_content.fieldOrder

list of field names from tt_content table

This allows you to specify (and thereby overrule) the preferred order of the field names of the "Quick Edit" editing forms of the tt_content table (Content Elements). Just specify the list of fields, separated by comma. Then these fields will be listed first and all remaining fields thereafter in their original order.

Example:

This results in the 'Text' field and thereafter 'Header' field being display as the very first fields instead of the 'Type' field.

mod.web_layout.tt_content {

  fieldOrder = bodytext, header

}

editFieldsAtATime

int+

Specifies the number of subsequent content elements to load in the edit form when clicking the edit icon of a content element in the 'Columns' view of the module.

Example:

mod.web_layout {

  editFieldsAtATime = 2

}

1

noCreateRecordsLink

boolean

If set, the link in the bottom of the page, "Create new record", is hidden.

QEisDefault

boolean

If set, then the QuickEditor is the first element in the Function Menu in the top of the menu in Web > Page

disableSearchBox

boolean

Disables the search box in Columns view.

disableBigButtons

boolean

Disables the large buttons in top of the Columns view.

These are the buttons that are hidden with this option:

1

disableAdvanced

boolean

Disables the clear cache advanced function in the bottom of the page in the module, including the "Create new record" link.

disableNewContentElementWizard

boolean

Disables the fact that the new-content-element icons links to the content element wizard and not directly to a blank "NEW" form.

defaultLanguageLabel

string

Alternative label for "Default" when language labels are shown in the interface.

Overrides the same property from mod.SHARED if set.

defLangBinding

boolean

If set, translations of content elements are bound to the default record in the display. This means that within each column with content elements any translation found for exactly the shown default content element will be shown in the language column next to.

This display mode should be used depending on how the frontend is configured to display localization. The frontend must display localized pages by selecting the default content elements and for each one overlay with a possible translation if found.

disableIconToolbar

boolean

Disables the topmost icon toolbar with the "view"-Icon and the icon toolbar below.

noCreateRecordsLink

boolean

If set, the link in the bottom of the page, "Create new record", is hidden.

Example:

mod.web_list {

noCreateRecordsLink = 1

}

alternateBgColors

boolean

If set, the background colors of elements will alternate.

Example:

mod.web_list {

alternateBgColors = 1

}

The result is alternating background colors for each element:

disableSingleTableView

boolean

If set, then the links on the table titles which shows a single table listing only will not be available (including sorting links on columns titles, because these links jumps to the table-only view).

listOnlyInSingleTableView

boolean

If set, the default view will not show the single records inside a table anymore, but only the available tables and the number of records in these tables. The individual records will only be listed in the single table view, that means when a table has been clicked. This is very practical for pages containing many records from many tables!

Example:

mod.web_list {

listOnlyInSingleTableView = 1

}

The result will be that records from tables are only listed in the single-table mode:

0

itemsLimitSingleTable

int+

Set the default maximum number of items to show in single table view.

100

itemsLimitPerTable

int+

Set the default maximum number of items to show per table.

20

noViewWithDokTypes

string

Hide view icon for the defined doktypes (comma-separated)

254,255

hideTables

list of table names

Hide these tables in record listings (comma-separated)

table.[tablename].hideTable

boolean

If set to non-zero, the table is hidden. If it is zero, table is shown if table name is not listed in "hideTables" list.

Example:

mod.web_list.table.tt_content.hideTable = 1

allowedNewTables

list of table names

If this list is set, then only tables listed here will have a link to "create new" in the page and subpages.

This also affects "db_new.php" (the display of "Create new record")

Note: Technically records can be created (e.g. by copying/moving), so this is "pseudo security". The point is to reduce the number of options for new records visually.

Example:

mod.web_list {

  allowedNewTables = pages, tt_news

}

Only pages and tt_news table elements will be linked to in the New record screen:

deniedNewTables

list of table names

If this list is set, then the tables listed here won't have a link to "create news" in the page and subpages. This also affects "db_new.php" (the display of "Create new record").

This is the opposite of the previous property "allowedNewTables".

If allowedNewTables and deniedNewTables contain a common subset, deniedNewTables takes precedence.

Example:

mod.web_list {

  deniedNewTables = tt_news,tt_content

}

newWizards

boolean

If set, then the new-link over the control panel of the pages and tt_content listings in the List module will link to the wizards and not create a record in the top of the list.

showClipControlPanelsDespiteOfCMlayers

boolean

If set, then the control- and clipboard panels of the module is shown even if the context-popups (ClickMenu) are available. Normally the control- and clipboard panels are disabled (unless extended mode is set) in order to save bandwidth.

enableDisplayBigControlPanel

list of keywords

Determines whether the checkbox "Extended view" in the list module is shown or hidden. If it is hidden, you can predefine it to be always activated or always deactivated.

The following values are possible:

- activated: The option is activated and the checkbox is hidden.

- deactivated: The option is deactivated and the checkbox is hidden.

- selectable: The checkbox is shown so that the option can be selected by the user.

selectable

enableClipBoard

list of keywords

Determines whether the checkbox "Show clipboard" in the list module is shown or hidden. If it is hidden, you can predefine it to be always activated or always deactivated.

The following values are possible:

- activated: The option is activated and the checkbox is hidden.

- deactivated: The option is deactivated and the checkbox is hidden.

- selectable: The checkbox is shown so that the option can be selected by the user.

selectable

enableLocalizationView

list of keywords

Determines whether the checkbox "Localization view" in the list module is shown or hidden. If it is hidden, you can predefine it to be always activated or always deactivated.

The following values are possible:

- activated: The option is activated and the checkbox is hidden.

- deactivated: The option is deactivated and the checkbox is hidden.

- selectable: The checkbox is shown so that the option can be selected by the user.

selectable

newPageWiz.overrideWithExtension

newContentWiz.overrideWithExtension

string

If set to an extension key, (eg. "templavoila") then the "mod1/index.php" file of that extension will be used for creating new elements on the page. "newContentWiz" will likewise use the "mod1/db_new_content_el.php" for creating new content elements.

Also see "options.overridePageModule"

clickTitleMode

string

Keyword which defines what happens when a user clicks the title in the list.

Default is that pages will go one level down while other records have no link at all.

Keywords:

edit = Edits record

info = Shows information

show = Shows page/content element in frontend

type

int+

Enter the value of the &type parameter passed to the webpage.

Example:

By this configuration frontend pages will be shown with "index.php?id=123&type=1" from the Web > View module:

mod.web_view {

type = 1

}

order

list of values

Define an alternate order for the groups of records in the new records wizard. Pages and content elements will always be on top, but the order of other record groups can be changed.

Records are grouped by extension keys, plus the special key "system" for records provided by the TYPO3 Core.

Example:

mod.wizards.newRecord.order = tt_news

This places the tt_news group at the top (after pages and content elements). The other groups follow unchanged:

renderMode

string

Alternative rendering mode; set to "tabs", if you want tabs.

Example:

mod.wizards.newContentElement.renderMode = tabs

wizardItems.[group]

array

In the new content element wizard, content element types are grouped together by type. Each such group can be configured independently. The four default groups are: "common", "special", "forms" and "plugins".

The configuration options below apply to any group.

wizardItems.[group].header

string (localized)

Name of the group.

wizardItems.[group].show

string

Comma-separated list of items to show in the group. Use "*" to show all.

Example:

  # Hide bulletList

mod.wizards.newContentElement.wizardItems.common.show := removeFromList(bullets)

  # Only show text and textpic in common

mod.wizards.newContentElement.wizardItems.common.show = text,textpic

wizardItems.[group].elements

array

List of items in the group.

wizardItems.[group].elements.[name]

array

Configuration for a single item.

wizardItems.[group].elements.[name].icon

resource

Path to the icon.

wizardItems.[group].elements.[name].title

string (localized)

Name of the item.

wizardItems.[group].elements.[name].description

string (localized)

Description text for the item.

wizardItems.[group].elements.[name].tt_content_defValues

array

Default values for tt_content fields.

allowTVlisting

boolean

If set, the listings "Technical", "Validation" and "Changed" are available in the Extension Manager. Those will evaluate ALL available extensions. That can take many seconds (up to 30) depending on the number of extensions.

Example:

mod.tools_em.allowTVlisting = 1

Enables these options in the Extension Manager:

Note: This setting does not influence the new Extension Manager which comes with TYPO3 4.5 and newer.

0

disableDocSelector

boolean

If set, the document selector is disabled.

Example:

mod.xMOD_alt_doc {

  disableDocSelector = 1

  disableCacheSelector = 1

}

disableCacheSelector

boolean

If set, the cache/save/close selector is disabled.

See example above.

Note: As of TYPO3 4.2 this menu does not exist anymore.

history.keepEntries

int+

Maximum number of entries in the sys_history for this table. Range 0-200. Zero turns the history off.

Example:

TCEMAIN {

    # Default for all tables is 10 entries:

  default.history.keepEntries = 10

    # But the Content Elements will have 20 levels:

  table.tt_content.history.keepEntries = 20

}

Note: This option has been removed in TYPO3 4.0.

history.maxAgeDays

int+

The number of days elements are in the history at most. Takes precedence over keepEntries.

Default is 7 days. Range 0-200. Zero turns the magAgeDays off.

disablePrependAtCopy

boolean

Disables the "prependAtCopy" feature (if configured for the table in $TCA).

(The word "prepend" is misguiding - the "(copy)" label is appended to (put after) the record title! Sorry for that mistake, it isn't the only time I have made that.)

Example:

TCEMAIN.table.pages {

    # Pages will NOT have "(copy)" appended:

  disablePrependAtCopy = 1

    # Pages will NOT be hidden upon copy:

  disableHideAtCopy = 1

}

These settings adjust that a page which is copied will neither have "(copy X)" appended nor be hidden.

The last page in this tree, labeled "Test", is used as original to be copied.

The first sub page was copied using the settings from the above example: It is labeled "Test" and is visible exactly like the original page.

The page "Test (copy 2)" in the middle was in contrast copied in default mode: The page is hidden and the "(copy X)" suffix is added, if another page with the same named existed already.

disableHideAtCopy

boolean

Disables the "hideAtCopy" feature (if configured for the table in $TCA).

For an example, see "disablePrependAtCopy" above.

disabled

boolean

If set, the field is not rendered.

Example:

TCEFORM.pages.title {

    # You cannot edit the Page title field now:

  disabled = 1

}

label

string (localized)

This allows you to enter alternative labels for any field.

Example:

TCEFORM.pages.title {

  label = LLL:EXT:my_ext/locallang_db.xml:table.column

  label.default = New Label

  label.de = Neuer Feldname

}

keepItems

list of values

(applies to select-types only)

This keeps in the list only the items defined here. All others are removed.

Example:

TCEFORM.pages.doktype {

    # Show only standard and "Spacer" page types

  keepItems = 1,199

}

removeItems

list of values

(applies to select-types only)

This removes the items from the list which has a value found in this comma list of values.

Example:

TCEFORM.pages.doktype {

    # Remove the "Recycler" and "Spacer" page type options:

  removeItems = 199, 255

}

addItems.[itemValue]

string (localized)

(applies to select-types only)

This will add elements to the list. Notice that the added elements might be removed if the selector represents records. In that case only still existing records will be preserved.

Example:

TCEFORM.pages.doktype {

    # Creates a new page type option:

  addItems.123 = New Page type!

    # Creates yet a page type with "locallang" title:

  addItems.124 = LLL:EXT:lang/locallang_tca.php:title

}

This example extends the options for Page types with two new items:

disableNoMatchingValueElement

boolean

(applies to select-types only)

If a selector box value is not available among the options in the box, the default behavior of TYPO3 is to preserve the value and to show a label which warns about this special state:

If disableNoMatchingValueElement is set, the element "INVALID VALUE" will not be added to the list.

Example:

TCEFORM.pages.doktype {

    # "INVALID VALUE ..." label will never show up:

  disableNoMatchingValueElement = 1

}

Now the selector box will default to the first element in the selector box:

noMatchingValue_label

string (localized)

(applies to select-types only)

Allows for an alternative label of the "noMatchingValue" element.

You can insert the placeholder "%s" to insert the value.

If you supply a blank value the label will be blank.

Example:

TCEFORM.pages.doktype {

    # Alternative "INVALID VALUE ..." label:

  noMatchingValue_label = VALUE "%s" was not available!

}

The result will be:

altLabels.[item_value]

string (localized)

(applies to select-types only)

This allows you to enter alternative labels for the items in the list.

Example:

TCEFORM.pages.doktype {

    # Setting alternative labels:

  altLabels.1 = STANDARD Page Type

  altLabels.254 = Folder (for various elements)

    # Sets the default label for Recycler via "locallang":

  altLabels.255 = LLL:EXT:lang/locallang_tca.php:doktype.I.2

}

Result will be:

PAGE_TSCONFIG_ID

integer

(applies to select-types with foreign table)

When the select-types are used with foreign-table the where-query has four markers (see description of $TCA in the "Inside TYPO3" document.) The value of three of these markers may be set from Page TSconfig.

PAGE_TSCONFIG_IDLIST

comma list of integers

(applies to select-types with foreign table)

See above

PAGE_TSCONFIG_STR

string

(applies to select-types with foreign table)

See above

itemsProcFunc.[...]

(custom)

(applies to select-types with itemsProcFunc)

The properties of this key is passed on to the itemsProcFunc in the parameter array by the key "TSconfig".

RTEfullScreenWidth

int+/%

(applies for RTE text fields only with the RTE wizard configured)

The width of the RTE full screen display. If nothing is set, the whole width is used which means "100%". If you set an integer value, that indicates the pixels width.

linkTitleToSelf

boolean

(all fields)

If set, then the title of the field in the forms links to alt_doc.php editing ONLY that field.

Works for existing records only - not for new records.

Example:

TCEFORM.pages.title {

    # The label for the "title" field will link itself

  linkTitleToSelf = 1

}

The result is that the label for the title field will be a link:

Clicking the link brings you to a form where only this field is shown:

disabled

boolean

If set, the FlexForm sheet is not rendered. One sheet represents one tab in plug-in configuration.

Example:

TCEFORM.tt_content.pi_flexform.my_ext_pi1.sDEF {

  # The tab with key "sDEF" of the FlexForm plug-in configuration is now hidden

  disabled = 1

}

title

string / getText

Set the title of the tab in FlexForm plug-in configuration.

Example:

TCEFORM.tt_content.pi_flexform.my_ext_pi1.sDEF {

  # Rename the first tab of the FlexForm plug-in configuration

  title = LLL:fileadmin/locallang.xml:tt_content.pi_flexform.my_ext_pi1.sDEF

}

pidList

list of values

Limit the search to certain pages (and their subpages). When pidList is empty all pages will be included in the search (as long as the be_user is allowed to see them)

Example:

TCEFORM.suggest.default {

  # sets the pidList for a suggest fields in all tables

  pidList = 1,2,3,45

}

pidDepth

int+

Expand pidList by this number of levels. Only has an effect, if pidList has a value.

Example:

TCEFORM.suggest.default {

  pidList = 6,7

  pidDepth = 4

}

minimumCharacters

int+

Minimum number of characters needed to start the search. Works only for single fields.

Example:

TCEFORM.pages.storage_pid.suggest.default {

  minimumCharacters = 3

}

2

maxPathTitleLength

int+

Maximum number of characters to display when a path element is too long.

Example:

TCEFORM.suggest.default {

  maxPathTitleLength = 30

}

searchWholePhrase

boolean

Whether to do a LIKE=%mystring% (searchWholePhrase = 1) or a LIKE=mystring% (to do a real find as you type).

Example:

TCEFORM.pages.storage_pid.suggest.default {

  # configures the suggest wizard for the field "storage_pid" in table "pages" to search only for whole phrases

  searchWholePhrase = 1

}

0

searchCondition

string

Additional WHERE clause (no AND needed to prepend).

Example:

TCEFORM.pages.storage_pid.suggest.default {

  # configures the suggest wizard for the field "storage_pid" in table "pages" to search only for pages with doktype=1

  searchCondition = doktype=1

}

cssClass

string

Add a CSS class to every list item of the result list.

Example:

TCEFORM.suggest.pages {

  # configures all suggest wizards which list records from table "pages" to add the css-class "pages" to every list item of the result list.

  cssClass = pages

}

receiverClass

string

PHP class alternative receiver class - the file that holds the class needs to be included manually before calling the suggest feature, should be derived from "t3lib_tceforms_suggest_defaultreceiver"

t3lib_tceforms_suggest_defaultreceiver

renderFunc

string

User function to manipulate the displayed records in the result.

hide

boolean

Hide the suggest field. Works only for single fields.

Example:

TCEFORM.pages.storage_pid.suggest.default {

  hide = 1

}