Deprecation: #83750 - Adapt TCA signature for customControls¶

Description¶

According to the TCA documentation since TYPO3 v4.7, the definition of "customControls" for "inline" columns is as follows:

Important

Numerical array containing definitions of custom header controls for IRRE fields. This makes it possible to create special controls by calling user-defined functions (userFuncs). Each item in the array item must be an array itself, with at least on key "userFunc" pointing to the user function to call.

The implementation instead relied on the userFunc string being provided as the key of the array.

Impact¶

TCA definition for "inline" fields using custom header controls for IRRE fields will trigger a PHP E_USER_DEPRECATED error:

'some-column' => [
    'config' => [
        'type' => 'inline',
        // ...
        'customControls' => [
            \Vendor\MyExtension\Tca\MyFirstCustomControl::class . '->render',
            \Vendor\MyExtension\Tca\MySecondCustomControl::class . '->render'
        ]
    ]
]

Migration¶

Update the TCA definition with a userFunc key to specify the method to be called:

'some-column' => [
    'config' => [
        'type' => 'inline',
        // ...
        'customControls' => [
            [
                'userFunc' => \Vendor\MyExtension\Tca\MyFirstCustomControl::class . '->render'
            ],
            [
                'userFunc' => \Vendor\MyExtension\Tca\MySecondCustomControl::class . '->render'
            ]
        ]
    ]
]