[BUGFIX] Upgrade Wizard must work also on records marked as deleted
[Packages/TYPO3.CMS.git] / typo3 / sysext / core / Documentation / Changelog / 8.6 / Feature-51291-SynchronizedFieldValuesInLocalizedRecords.rst
1 .. include:: ../../Includes.txt
2
3 ================================================================
4 Feature: #51291 - Synchronized field values in localized records
5 ================================================================
6
7 See :issue:`51291`
8
9 Description
10 ===========
11
12 The localized record overlay behaviour has been changed to make localization-rows standalone.
13
14 Previously, if fields in :code:`TCA` columns were set to :code:`l10n_mode` :code:`exclude`
15 or :code:`mergeIfNotBlank`, the localized record overlay did not contain values, and those
16 values were "pulled up" from the underlying default language records.
17
18 This has been changed, the :code:`DataHandler` now copies those values over to the localized
19 record and synchronizes them if the default language record is changed.
20
21 As a substitution of the :code:`mergeIfNotBlank` feature, the new configuration :code:`allowLanguageSynchronization`
22 has been added. Setting this adds a wizard to single fields and an editor can select if a field of a localized record
23 should be kept in sync with the default language record, or the localized record it was derived from.
24
25 A typical configuration looks like that:
26
27 .. code-block:: php
28
29 'columns' => [
30 ...
31 'header' => [
32 'label' => 'My header',
33 'config' => [
34 'type' => 'input',
35 'behaviour' => [
36 'allowLanguageSynchronization' => true,
37 ],
38 ],
39 ],
40 ],
41
42 :code:`TCA` tables that configure the language localization get the field :code:`l10n_state` added by the schema analyzer
43 which stores a json string with field names and the values :code:`custom`, :code:`parent` or :code:`source` to
44 specify if and from which record a single field gets its value.
45
46 .. index:: Backend, Database, Frontend, PHP-API, TCA