Breaking: #98479 - Removed file reference related functionality

Description

With the introduction of the new TCA type file, a couple of cross dependencies have been removed, mainly related to FormEngine.

The customControls hook option is not available for the new TCA type file. It has been replaced by the new PSR-14 CustomFileControlsEvent for this use case.

The field table_local of table sys_file_reference: is no longer evaluated by TYPO3 and has therefore been removed.

The following options are no longer evaluated for TCA type inline:

• [appearance][headerThumbnail]
• [appearance][fileUploadAllowed]
• [appearance][fileByUrlAllowed]

The following options are no longer evaluated for TCA type group:

• [appearance][elementBrowserType]
• [appearance][elementBrowserAllowed]

A TCA migration is in place, removing those values from custom configurations.

Impact

Adding custom controls with the customControls option does no longer work for FAL fields.

Using the table_local field of table sys_file_reference does no longer work and might lead to database errors.

Using one of the mentioned [appearance] TCA options does no longer have any effect.

Affected installations

All installations making use of the customControls option for FAL fields, directly using the sql:table_local field of table sys_file_reference or using one of the mentioned [appearance] TCA options for TCA type inline and group fields. Latter is rather unlikley because the [appearance] options of group had only effect in FAL context and the options have only been set internally by the ExtensionManagementUtility->getFileFieldTCAConfig() API method.

Migration

Migrate corresponding user functions for the customControls option to a PSR-14 event listeners of the CustomFileControlsEvent.

Remove any usage of the table_local field of table sys_file_reference in custom extension code.

Remove the mentioned [appearance] TCA options from your custom TCA configurations.