Core Documentation

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>

</select>

Example:

  # Disables all items except the "QuickEdit" item:

mod.web_layout.menu.function {

  1 = 0

  2 = 0

  3 = 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_belog_webinfo">Log</option>

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

    <option value="tx_cms_webinfo_hits">Hit Statistics</option>

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

</select>

Example:

  # Disables the item "Hit Statistics":

mod.web_info.menu.function {

  tx_cms_webinfo_hits = 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>

    <option value="tx_tstemplatestyler_modfunc1">CSS Styler</option>

</select>

user_task.menu.function

User > Task Center

This is slightly different because the Task Center does not provide a selector box function menu. But behind the scene 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

}

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 on Web > List, Web > Page and TemplaVoilà page module.

defaultLanguageFlag

string

Flag icon filename from gfx/flags/ for default language

Used in Web > List and TemplaVoilà page module.

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 by this option:

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, then records will be listed only when the single table view is enabled. 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 listed only in the single-table mode and the default view will just show number of table records in page and the table description if available:

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 tablenames

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 tablenames

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.

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 Technical and Validation listings are available in the EM. Those will evaluate ALL available extensions and that can take many seconds (up to 30) depending on number of extensions.

Example:

mod.tools_em.allowTVlisting = 1

Enables these options in the Extension Manager:

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.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 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 means that a page copied (say, the last page in this tree, labeled "Test") will neither have "(copy X)" appended nor be hidden.

This effect is shown in the first sub page here, labeled "Test". It appears exactly like the third page that was copied.

The page in the middle, labeled "Test (copy 3)" is the default mode where 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 table in $TCA)

For 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 set, the element "INVALID VALUE" will not be added to the list.

Example:

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 show a label that warns about this special state:

TCEFORM.pages.doktype {

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

  disableNoMatchingValueElement = 1

}

noMatchingValue_label

string (localized)

(applies to select-types only)

Allows for an alternative label 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.2 = ADVANCED page type

  altLabels.254 = System Folder (for various elements)

    # Sets the default labels 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 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:

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. Has only 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 sugesst 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 sugesst 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

}