label

label
Path

$GLOBALS['TCA'][$table]['ctrl']

Type

string (field name)

Scope

Display

Required!

Points to the field name of the table which should be used as the "title" when the record is displayed in the system.

Note

label_userFunc overrides this property (but it is still required).

Warning

For the label only regular input or text fields should be used. Otherwise issues may occur and prevent from a working system if TCEMAIN.table.tt_content.disablePrependAtCopy is not set or set to 0.

A simple example

A minimal example of the control section
EXT:styleguide/Configuration/TCA/tx_styleguide_ctrl_minimal.php
[
    'ctrl' => [
        'title' => 'LLL:EXT:styleguide/Resources/Private/Language/locallang.xlf:minimalTableTitle',
        'label' => 'title',
        'iconfile' => 'EXT:styleguide/Resources/Public/Icons/tx_styleguide.svg',
    ],
    'columns' => [
        'title' => [
            'label' => 'LLL:EXT:styleguide/Resources/Private/Language/locallang.xlf:minimalTableTitleField',
            'config' => [
                'type' => 'input',
            ],
        ],
    ],
    'types' => [
        [
            'showitem' => 'title',
        ],
    ],
]

label_alt

label_alt
Type

String (comma-separated list of field names)

Scope

Display

Comma-separated list of field names, which are holding alternative values to the value from the field pointed to by "label" (see above) if that value is empty. May not be used consistently in the system, but should apply in most cases.

Note

label_userFunc overrides this property, also see label_alt_force.

Examples

Example for table "tt_content":

'ctrl' => [
   'label' => 'header',
   'label_alt' => 'subheader,bodytext',
],

label_alt_force

label_alt_force
Type

boolean

Scope

Display

If set, then the label field and the label_alt fields are shown in the title separated by comma.

Note

label_userFunc overrides this property.