[TASK] Deprecate inline localizationMode
[Packages/TYPO3.CMS.git] / typo3 / sysext / core / Documentation / Changelog / master / Deprecation-79770-DeprecateInlineLocalizationMode.rst
1 .. include:: ../../Includes.txt
2
3 =======================================================
4 Deprecation: #79770 - Deprecate inline localizationMode
5 =======================================================
6
7 See :issue:`79770`
8
9 Description
10 ===========
11
12 The `localizationMode` for inline relational record editing types is deprecated.
13
14
15 Impact
16 ======
17
18 Using `localizationMode` set to `keep` and having `allowLanguageSynchronization` enabled at the same time is counter-productive, since it will deny the synchronization process for the affected field. That's why `localizationMode` is unset only if `allowLanguageSynchronization` is enabled.
19
20
21 Affected Installations
22 ======================
23
24 All having `$TCA[<table-name>]['columns'][<field-name>]['config']['behaviour']['localizationMode']` defined for database tables that support translations.
25
26
27 Migration
28 =========
29
30 Remove `$TCA[<table-name>]['columns'][<field-name>]['config']['behaviour']['localizationMode']` definitions and make use of either one of the following
31
32 * `$TCA[<table-name>]['columns'][<field-name>]['config']['behaviour']['allowLanguageSynchronization'] = true` if editors can decide whether to provide custom child references or synchronize all references from the language parent record - this comes close to `localizationMode=select` without having the possibility to selectively translate child references
33 * `$TCA[<table-name>]['columns'][<field-name>]['l10n_mode'] = 'exclude'` if editors don't have a choice to translate child references - this corresponds to `localizationMode=keep`
34
35 .. index:: Backend, TCA