60 lines
2.2 KiB
ReStructuredText
60 lines
2.2 KiB
ReStructuredText
.. 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
|