From edf709a383da50e4bd94c85d7ce7903ef28fb5b0 Mon Sep 17 00:00:00 2001 From: quietone <quietone@2572884.no-reply.drupal.org> Date: Thu, 19 Dec 2024 21:53:45 +1300 Subject: [PATCH] Issue #3479185 by akulsaxena, joachim, smustgrave, mikelutz, quietone: Clarify documentation for EntityContentBase 'translations' configuration option --- .../Plugin/migrate/destination/EntityContentBase.php | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/core/modules/migrate/src/Plugin/migrate/destination/EntityContentBase.php b/core/modules/migrate/src/Plugin/migrate/destination/EntityContentBase.php index a7bfda9f89fd..63daca442460 100644 --- a/core/modules/migrate/src/Plugin/migrate/destination/EntityContentBase.php +++ b/core/modules/migrate/src/Plugin/migrate/destination/EntityContentBase.php @@ -27,8 +27,14 @@ * Provides destination class for all content entities lacking a specific class. * * Available configuration keys: - * - translations: (optional) Boolean, indicates if the entity is translatable, - * defaults to FALSE. + * - translations: (optional) A boolean that indicates if the entity is + * translatable. When TRUE, migration rows will be considered as translations. + * This means the migration will attempt to load an existing entity and, if + * found, save the row data into it as a new translation rather than creating + * a new entity. For this functionality, the migration process definition must + * include mappings for the entity ID and the entity language field. If this + * property is TRUE, the migration will also have an additional destination ID + * for the language code. * - overwrite_properties: (optional) A list of properties that will be * overwritten if an entity with the same ID already exists. Any properties * that are not listed will not be overwritten. -- GitLab