TYPO3 v15 dev-main snapshot ()

2026-08-10 22:31:09 +02:00
commit af8cc155b5
6818 changed files with 642608 additions and 0 deletions
@@ -0,0 +1,41 @@
+.. 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