| Table of Contents | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
| Page Properties | ||
|---|---|---|
| ||
Introduction
By default, XTM Connect – Contentful sends to XTM Cloud whatever is set as to localizable to XTM Cloud, andfor translation, unfortunately, from the Contentful CMS. Unfortunately, Contentful only allows permits this to be changed on the level of a at individual field level for a particular Content model:
...
What it this means is that you need to enter display the Field options of for each field in Edit mode, adjust them individually and decide specify whether or not the content therein shall field's contents are to be sent off for translation in XTM Cloud, by selecting the Enable localization of this field checkbox, in the field’s edition panel.
...
The drawback of such a behavior is that it this does not allow for selecting enable users to select content that is to be localizable within the framework of a specific XTM Cloud project, during the project submission process.
The solution is to it is the use of the Manage references feature.
...
Feature description
The Using the Manage references feature allows , you to can specify which of the referenced content, in relevant entries' referenced content , is to be translated and which are is not to be translated.
To set up configure the feature, you first need to make sure to add either the Reference or Rich text field type (or both) to your Content model, and make them localizable. These are the two field types in which you will be able to add “references”. Do not forget to save the changes.
...
Next, create your Content item in the Contentful CMS.
In the Reference Field Type, you can either add an existing Content item (here: REF 1) or create a new one, based on an existing Content model.
...
| Note |
|---|
IMPORTANT! The Reference Field Type allows for selecting one You can only select one Content item onlyfor the Reference field type! If you want to include multiple items, you would need to add the corresponding number of Reference Field Typesfield types in your Content model. |
In the Rich text field, there are three elements which act as References that will later be displayed in the Manage references window:
Entry (from the Embed dropdown) → Embed another Content item in the Text field (here: REF 2).
Inline entry (from the Embed dropdown) → Embed another Content item in the Text field that acts as an inline, that is usually incorporated within in the actual text (here: REF 3).
Hyperlink (from the top ribbon) → As the name suggests, this is usually a link to another existing Content item, embedded in the Text field. Once you click on it, name enter your Hyperlink hyperlink in the Link text field, and select Entry in the Link type section, which will allow you to attach yet . You can then attach another Content item.
...
Once you are have finished building your Content item, you can commence start the project submission process. In the XTM Connect Panel, go to the Manage references option and click on it.
...
When you do so, the Manage references popup is displayed.
...
In the Manage references popup:
Select referenced entries that are to be send sent for translation in XTM Cloud.
Deselect the reference(s) that are not to be sent for translation in XTM Cloud.
If the same entry has been referenced multiple times, all subsequent occurrences are marked with the
icon. Each occurrence will be selected or deselected for translation.
...
| Note |
|---|
IMPORTANT! Contentful limitations to on displaying references If one or more entries that you have selected for translation have contain over 1000 1,000 references, they will not be displayed, in Contentful. This means you also cannot display these entries in the Manage references popup and select the relevant ones for translation. However, you can create a project for such an entry of that kind and send all its +1000 1,000 references for translation, in XTM Cloud. If an entry has contains fewer than 1000 1,000 references, but they are nested over 10 levels deep, references below the 10th level are only marked with the ➕ more label, in the Manage references popup. To see them, you need to display their immediate parent entry. If you create a project for an entry with +10 levels of nesting:
|
| Info |
|---|
Remember that you can exclude all hyperlinked entries and their references from the translation project scope for all projects created in your XTM Connect – Contentful instance. To do so, contact XTM Support and request our team to make the necessary setting. |
Finish making the rest of the translation settings and then send your project to XTM Cloud!