Files
cms-core/Documentation/Changelog/8.7/Deprecation-79770-DeprecateInlineLocalizationMode.rst

42 lines
1.6 KiB
ReStructuredText

.. include:: /Includes.rst.txt
.. _deprecation-79770:
=======================================================
Deprecation: #79770 - Deprecate inline localizationMode
=======================================================
See :issue:`79770`
Description
===========
The `localizationMode` for inline relational record editing types is deprecated.
Impact
======
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.
Affected Installations
======================
All having :php:`$TCA[<table-name>]['columns'][<field-name>]['config']['behaviour']['localizationMode']` defined for
database tables that support translations.
Migration
=========
Remove :php:`$TCA[<table-name>]['columns'][<field-name>]['config']['behaviour']['localizationMode']` definitions and
make use of either one of the following
* :php:`$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
* :php:`$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`
.. index:: Backend, TCA