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.

ModifyFileReferenceEnabledControlsEvent

New in version 12.0

Listeners to the PSR-14 event \TYPO3\CMS\Backend\Form\Event\ModifyFileReferenceEnabledControlsEvent are able to modify the state (enabled or disabled) for the controls of a single file reference of a TCA type file field. This event is similar to the ModifyInlineElementEnabledControlsEvent, which is only available for TCA type inline.

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 ModifyFileReferenceEnabledControlsEvent

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

Listeners to this Event will be able to modify the state (enabled or disabled) for controls of a file reference

enableControl ( string $identifier)

Enable a control, if it exists

param $identifier: the identifier
Return description: Whether the control could be enabled

Returns: bool

disableControl ( string $identifier)

Disable a control, if it exists

param $identifier: the identifier
Return description: Whether the control could be disabled

Returns: bool

hasControl ( string $identifier)

Returns whether a control exists for the given identifier

param $identifier: the identifier

Returns: bool

isControlEnabled ( string $identifier)

Returns whether the control is enabled.

Note: Will also return FALSE in case no control exists for the requested identifier

param $identifier: the identifier

Returns: bool

getControlsState ( )

Returns all controls with their state (enabled or disabled)

Returns: array

getEnabledControls ( )

Returns all enabled controls

Returns: array

getElementData ( )

Returns the whole element data

Returns: array

getRecord ( )

Returns the current record of the controls are created for

Returns: array

getParentUid ( )

Returns the uid of the parent (embedding) record (uid or NEW...)

Returns: string

getForeignTable ( )

Returns the table (foreign_table) the controls are created for

Returns: string

getFieldConfiguration ( )

Returns the TCA configuration of the TCA type=file field

Returns: array

isVirtual ( )

Returns whether the current records is only virtually shown and not physically part of the parent record

Returns: bool