TYPO3 v15 dev-main snapshot ()

2026-08-10 22:31:09 +02:00
commit af8cc155b5
6818 changed files with 642608 additions and 0 deletions
@@ -0,0 +1,59 @@
+.. include:: /Includes.rst.txt
+
+.. _deprecation-98479-1664622350:
+
+=====================================================================
+Deprecation: #98479 - Deprecated file reference related functionality
+=====================================================================
+
+See :issue:`98479`
+
+Description
+===========
+
+With the introduction of the new TCA type :php:`file`, a couple of cross
+dependencies have been deprecated, mainly related to FormEngine.
+
+The :php:`UserFileInlineLabelService` class has been deprecated, since it was
+only used for generating the inline label for file references in TCA type
+:php:`inline`. This is now handled by the new TCA type :php:`file` directly.
+
+The :php:`FileExtensionFilter->filterInlineChildren()` method, which was
+previously used as :php:`[filter][userFunc]` to filter the available
+file extensions in FormEngine as well as :php:`DataHandler` has been
+deprecated. This is now done internally.
+
+The :php:`ExtensionManagementUtility::getFileFieldTCAConfig()` method, which
+was usually used to simplify configuration of FAL fields in TCA has been
+deprecated as well, since the applied configuration is now handled internally.
+
+Impact
+======
+
+Instantiating the :php:`UserFileInlineLabelService` class, as well as
+calling the :php:`FileExtensionFilter->filterInlineChildren()` and
+:php:`ExtensionManagementUtility::getFileFieldTCAConfig()` methods will
+trigger a PHP :php:`E_USER_DEPRECATED` level error. The extension scanner
+also reports any usage.
+
+Affected installations
+======================
+
+All installations with extensions using the :php:`UserFileInlineLabelService`
+class or one of the mentioned methods.
+
+Migration
+=========
+
+Remove any usage of the :php:`UserFileInlineLabelService` class. There is no
+migration available, since this FAL specific functionality is now handled
+internally.
+
+Replace any usage of :php:`FileExtensionFilter->filterInlineChildren()` with
+:php:`FileExtensionFilter->filter()`. However, usage of this method in custom
+extension code should usually not be necessary.
+
+Replace any usage of :php:`ExtensionManagementUtility::getFileFieldTCAConfig()`
+by directly using the new TCA type :ref:`file <feature-98479-1664537749>`.
+
+.. index:: Backend, Database, FAL, PHP-API, TCA, PartiallyScanned, ext:backend