Attention

TYPO3 v12 has reached end-of-life as of April 30th 2026 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 v12 here: TYPO3 ELTS.

CustomFileControlsEvent

New in version 12.0

This event replaces the customControls hook option, which is only available for TCA type inline.

Listeners to the PSR-14 event \TYPO3\CMS\Backend\Form\Event\CustomFileControlsEvent are able to add custom controls to a TCA type file field in form engine.

Custom controls are always displayed below the file references. In contrast to the selectors, e.g. Select & upload files are custom controls independent of the readonly and showFileSelectors options. This means, you have full control in which scenario your custom controls are being displayed.

Example

Note

Currently, we do not have an example for this event. If you can provide a useful one, please open an issue with your code snippets or a pull request.

API

class CustomFileControlsEvent

Fully qualified name: \TYPO3\CMS\Backend\Form\Event\CustomFileControlsEvent

Listeners to this Event will be able to add custom controls to a TCA type="file" field in FormEngine

getResultArray ( )

Returns: array

setResultArray ( array $resultArray)

WARNING: Modifying the result array should be used with care. It mostly only exists to allow additional $resultArray['javaScriptModules'].

param $resultArray: the resultArray

getControls ( )

Returns: array

setControls ( array $controls)

param $controls: the controls

addControl ( string $control, string $identifier = '')

param $control: the control
param $identifier: the identifier, default: ''

removeControl ( string $identifier)

param $identifier: the identifier

Returns: bool

getTableName ( )

Returns: string

getFieldName ( )

Returns: string

getDatabaseRow ( )

Returns: array

getFieldConfig ( )

Returns: array

getFormFieldIdentifier ( )

Returns: string

getFormFieldName ( )

Returns: string