label¶

label ¶

Type

string (field name)

Path

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

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¶

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',
        ],
    ],
]

Copied!

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.

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