Files
cms-core/Documentation/Changelog/8.3/Breaking-77156-TSconfigAndTStemplateSoftReferencesFunctionalityRemoved.rst

58 lines
1.9 KiB
ReStructuredText

.. include:: /Includes.rst.txt
.. _breaking-77156:
================================================================================
Breaking: #77156 - TSconfig and TStemplate soft references functionality removed
================================================================================
See :issue:`77156`
Description
===========
Soft references based on TSconfig, TStemplate and images within :file:`fileadmin/` have been removed.
The soft reference keys `TSconfig` and `TStemplate` that could previously be set via
:php:`$GLOBALS[TCA][$table][columns][$column][config][softref]` are not evaluated anymore.
The soft reference keys `images`, `typolink` and `typolink_tag` are not evaluating files within :file:`fileadmin/`
anymore that are not based on the File Abstraction Layer.
The public PHP property :php:`SoftReferenceIndex::$fileAdminDir` has been removed.
The following PHP methods has been removed without substitution:
- :php:`SoftReferenceIndex::findRef_TStemplate()`
- :php:`SoftReferenceIndex::findRef_TSconfig()`
- :php:`SoftReferenceIndex::fileadminReferences()`
Impact
======
Setting the softref properties `TSconfig` and `TStemplate` within TCA will not be evaluated anymore and will
throw a deprecation message.
Calling any of the PHP methods above will throw a fatal PHP error.
The soft reference index will not be updated with the TSconfig and TStemplate properties anymore, as well
as files directly linked or referenced with the :file:`fileadmin/` directory.
Affected Installations
======================
If the soft reference index is evaluated in a third-party extension, this might result in unexpected behaviour.
All TYPO3 instances using extensions setting TSconfig or TStemplate soft references in TCA are also affected.
Migration
=========
Remove the softref keys `TStemplate` and `TSconfig` from the TCA definition of the third party extensions.
.. index:: TCA, PHP-API