[!!!][TASK] Remove legacy soft references functionality
[Packages/TYPO3.CMS.git] / typo3 / sysext / core / Documentation / Changelog / master / Breaking-77156-TSconfigAndTStemplateSoftReferencesFunctionalityRemoved.rst
1 ================================================================================
2 Breaking: #77156 - TSconfig and TStemplate soft references functionality removed
3 ================================================================================
4
5 Description
6 ===========
7
8 Soft references based on TSconfig, TStemplate and images within fileadmin/ have been removed.
9
10 The soft reference keys "TSconfig" and "TStemplate" that could previously be set via
11 ``$TCA[$table][columns][$column][config][softref]`` are not evaluated anymore.
12
13 The soft reference keys "images", "typolink" and "typolink_tag" are not evaluating files within fileadmin/
14 anymore that are not based on the File Abstraction Layer.
15
16 The public PHP property "SoftReferenceIndex::$fileAdminDir" has been removed.
17
18 The following PHP methods has been removed without substitution:
19 * SoftReferenceIndex::findRef_TStemplate()
20 * SoftReferenceIndex::findRef_TSconfig()
21 * SoftReferenceIndex::fileadminReferences()
22
23
24 Impact
25 ======
26
27 Setting softref property ``TSconfig`` and ``TStemplate`` within TCA will not be evaluated anymore and will
28 throw a deprecation message.
29
30 Calling any of the PHP methods above will throw a fatal PHP error.
31
32 The soft reference index will not be updated with the TSconfig and TStemplate properties anymore, as well
33 as files directly linked or referenced with the fileadmin/ directory.
34
35
36 Affected Installations
37 ======================
38
39 If the soft reference index is evaluated in a third-party extension, this might result in unexpected behaviour.
40
41 All TYPO3 instances using extensions setting TSconfig or TStemplate soft references in TCA are also affected.
42
43
44 Migration
45 =========
46
47 Remove the softref keys ``TStemplate`` and ``TSconfig`` from the TCA definition of the third party extensions.