TSconfig

[tablename].[field]

[tablename].[field].types.[type]

->TCEFORM_confObj

These objects contain additional configuration of the TCEFORM interface.  For the properties available, refer to the table below. This is a description of how you can customize in general and override for specific types.

TCEFORM.[tablename].[field] -  configures the field in TCEFORM for all types.

TCEFORM.[tablename].[field].types.[type] - configures the field in TCEFORM in case the 'type'-value of the field matches type.

[tablename].[field].config.[key]

string / array

This setting allows to override TCA field configuration and offers a flexible opportunity to reuse tables and TCA definitions but adept it to individual demands. So this will influence configuration settings in $TCA[<tablename>]['columns'][<field>]['config'][<key>].

Depending on the $TCA type of the field, the allowed keys are:

1. input - size, max

2. text - cols, rows, wrap

3. check - cols, showIfRTE

4. select - size, autoSizeMax, maxitems, minitems

5. group - size, autoSizeMax, max_size, show_thumbs, maxitems, minitems

6. inline - appearance, foreign_label, foreign_selector, foreign_unique, maxitems, minitems, size, autoSizeMax, symmetric_label

disabled

boolean

If set, the field is not rendered.

Example:

  TCEFORM.pages.title {

      # You cannot edit the Page title field now:

    disabled = 1

  }

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 (label, LS)

(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:

Warning: This example shows the principle of adding adhoc-items to a selector box in TYPO3 but you should not add new page types or Content Element types this way!

disableNoMatchingValueElement

boolean

(applies to select-types only)

If set, the element "CURRENT VALUE IS NOT AVAILABLE" 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:

Setting this option disables that behavior:

  TCEFORM.pages.doktype {

      # "CURRENT VALUE IS NOT ..." label will never show up:

    disableNoMatchingValueElement = 1

  }

... and the selector box will default to the first element in the selector box:

noMatchingValue_label

string (LS)

(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 "CURRENT VALUE IS NOT ..." label:

    noMatchingValue_label = VALUE "%s" was not available!

  }

The result will be:

altLabels.[item_value]

string (LS)

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

Extra property:

.returnUrl = boolean; if set, then the return URL is also set.

Example:

  TCEFORM.pages.title {

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

    linkTitleToSelf = 1

      # From the form with "title", return to full form:

    linkTitleToSelf.returnUrl = 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: