Attention

TYPO3 v11 has reached end-of-life as of October 31th 2024 and is no longer being maintained. Use the version switcher on the top left of this page to select documentation for a supported version of TYPO3.

Need more time before upgrading? You can purchase Extended Long Term Support (ELTS) for TYPO3 v10 here: TYPO3 ELTS.

listModule

listModule

Type: array
Path: $GLOBALS['TCA'][$table]['columns'][$field]['config']['fieldControl']
Scope: fieldControl
Types: group

The list module control button opens the Web > List module for only one table and allows the user to manipulate stuff there.

Note

The list module control is disabled by default, enable it if needed. It is shown below the add record control if not changed by below or after settings.

Options

disabled

Type: boolean
Path: $GLOBALS['TCA'][$table]['columns'][$field]['config']['fieldControl']['listModule']
Scope: fieldControl -> listModule
Default: true

Disables the field control. Needs to be set to false to enable the Create new button

options[pid]

Type: string
Path: $GLOBALS['TCA'][$table]['columns'][$field]['config']['fieldControl']['listModule']
Scope: fieldControl -> addRecord
Values: marker or an integer
Default: ###CURRENT_PID###

List records from this pid. Can be an hard pid setting, or one of these markers, see select foreign_table_where.

Falls back to "current pid" if not set, forces pid=0 if records of this table are only allowed on root level.

###CURRENT_PID###
###THIS_UID###
###SITEROOT###

listModule options[table]

Type: string
Path: $GLOBALS['TCA'][$table]['columns'][$field]['config']['fieldControl']['listModule']
Scope: fieldControl -> listModule
Values: name of the table
Default: First table from property allowed / foreign_table

List records of this table only, falls back to first table from allowed list if not set for type='group' fields and to foreign_table for type='select' fields.

options[title]

Type: string
Path: $GLOBALS['TCA'][$table]['columns'][$field]['config']['fieldControl']['listModule']
Scope: fieldControl -> listModule
Values: string or LLL reference
Default: LLL:EXT:core/Resources/Private/Language/locallang_core.xlf:labels.list

Allows to set a different 'title' attribute to the popup icon.

Examples

Select field

EXT:styleguide/Configuration/TCA/tx_styleguide_elements_select.php

[
    'columns' => [
        'select_multiplesidebyside_6' => [
            'exclude' => 1,
            'label' => 'select_multiplesidebyside_6 fieldControl',
            'config' => [
                'type' => 'select',
                'renderType' => 'selectMultipleSideBySide',
                'foreign_table' => 'tx_styleguide_staticdata',
                'size' => 5,
                'autoSizeMax' => 20,
                'fieldControl' => [
                    'editPopup' => [
                        'disabled' => false,
                        'options' => [
                            'windowOpenParameters' => 'height=300,width=500,status=0,menubar=0,scrollbars=1',
                        ],
                    ],
                    'addRecord' => [
                        'disabled' => false,
                    ],
                    'listModule' => [
                        'disabled' => false,
                    ],
                ],
            ],
        ],
    ],
]

Group field

EXT:styleguide/Configuration/TCA/tx_styleguide_elements_group.php

[
    'columns' => [
        'group_db_1' => [
            'exclude' => 1,
            'label' => 'group_db_1 allowed=be_users,be_groups description',
            'description' => 'field description',
            'config' => [
                'type' => 'group',
                'allowed' => 'be_users,be_groups',
                'fieldControl' => [
                    'editPopup' => [
                        'disabled' => false,
                    ],
                    'addRecord' => [
                        'disabled' => false,
                    ],
                    'listModule' => [
                        'disabled' => false,
                    ],
                ],
            ],
        ],
    ],
]