Drupal: Frequently Asked Questions (FAQ)
- 1 Introduction
- 2 Questions and answers
- 2.1 How can I install the Drupal connector, XTM Connect – Drupal, seamlessly?
- 2.2 What happens in Drupal when a project is reopened on the XTM Cloud side?
- 2.3 Why might the File does not exist in the following location message be present in the logs? I cannot retrieve the translated file from XTM Cloud back to the Drupal CMS.
- 2.4 What happens if the source content in Drupal is updated after it is sent off for translation in XTM Cloud?
- 2.5 Is it possible to connect a single Drupal language with multiple XTM Cloud languages by means of one language mapping? Is it possible to map one Drupal language with all of its language variants in XTM Cloud?
- 2.6 Does the Drupal connector support multiple XTM Cloud customers?
- 2.7 Is it possible to send a single project for translation in XTM Cloud into multiple target languages?
- 2.8 Do edits in published Drupal content automatically make it into the translation memory in XTM Cloud?
- 2.9 Is there any limit to how many segments a single job can have? For example, I have over 2 000 words, but it seems, I have a hard time to review the job in TMGMT by clicking the Review button.
- 2.10 Have there ever been clients experiencing the volume issue? We will have a lot of content for initial translation of a website, like the Italian website with 100 000 words or so.
- 2.11 What do the numbers under the Progress bar refer to? And what about the colors?
- 2.12 I want to set up a continuous project but the system is showing that XTM is not supported. What should I do?
Introduction
This article provides answers to questions frequently asked by clients when they begin working with the Drupal connector, XTM Connect – Drupal.
Questions and answers
How can I install the Drupal connector, XTM Connect – Drupal, seamlessly?
There are two ways to install the XTM Connect – Drupal plugin: directly from the relevant XTM Connect – Drupal module page or by downloading the required plugin package and installing it using that package.
For detailed instructions, you can refer to the appropriate installation guide, available under one of these URLs:
What happens in Drupal when a project is reopened on the XTM Cloud side?
Once an XTM Cloud project has been imported back to the Drupal CMS, reopening it on the XTM Cloud side will have no impact on the CMS whatsoever. For this reason, any new or updated content should be first translated in a new project.
Why might the File does not exist in the following location message be present in the logs? I cannot retrieve the translated file from XTM Cloud back to the Drupal CMS.
In the vast majority of cases, the File does not exist in the following location message might indicate that the project has already been archived on the XTM Cloud side. As a consequence, the Drupal connector cannot process the target file. Once you reactivate the project in the XTM Cloud UI and refresh its status in the Drupal CMS, the project should update the file status accordingly.
What happens if the source content in Drupal is updated after it is sent off for translation in XTM Cloud?
Once you make revisions to the content that has already been sent off for translation in XTM Cloud, it will be displayed as a draft in the CMS, suggesting that the new content (with revision) has not yet been sent to the XTM Connect – Drupal. For this reason, we recommend that no changes are made to the content after it has been sent to translation, as these changes will not be sent for translation at all and the target text will not therefore not match the source text in XTM Workbench.
That might also prevent the translated content from returning to Drupal, since the source content sent to XTM Cloud and the content in the CMS will then differ from each other.
In no circumstances will the new or updated content in the CMS be sent to XTM Cloud automatically. However, XTM Connect - Drupal has some automated functions for continuous submission of new (or updated) source content for translation in XTM Cloud. To find out more, read the following article: Drupal: Continuous job.
Is it possible to connect a single Drupal language with multiple XTM Cloud languages by means of one language mapping? Is it possible to map one Drupal language with all of its language variants in XTM Cloud?
Language mapping in the Drupal CMS is only possible for one Drupal language and one XTM Cloud language at a time, which means that you cannot define a second language mapping for languages that have already been used in an existing language mapping. If you would also like to create a language mapping for a specific language variant, you might need to consider configuring a separate XTM Cloud service provider or changing the mapping in this file: \drupal\web\modules\tmgmt_xtm\src\Plugin\tmgmt\Translator\countryList.json
After each connector update, the changes will reset to the default values. For this reason, it is advisable to make the target language change after each connector update.
In the attachment below, you can find out how the languages are mapped between Drupal and XTM Cloud. Note that the en language has two languages mapped, but the first language variant in line is en_GB (the system takes the first language from the list).
Does the Drupal connector support multiple XTM Cloud customers?
It is possible to connect multiple XTM Cloud customers to the Drupal CMS via XTM Connect - Drupal, but you will have to configure a separate XTM Cloud service provider.
This of course can be done at your end, in the Drupal CMS. However, remember to select the customer in XTM Cloud with API enabled. Otherwise, the Drupal connector will not have a connection with your XTM Cloud instance.
Is it possible to send a single project for translation in XTM Cloud into multiple target languages?
By default, XTM Connect – Drupal creates projects for a single language combination. However, you can use XTM Connect – Drupal to send a single project for translation into multiple target languages, in XTM Cloud. To find out how to do so, read the following article: Drupal: Creating multilingual projects in XTM Cloud.
Do edits in published Drupal content automatically make it into the translation memory in XTM Cloud?
There is no such possibility. Each and every update in the translation memory in XTM Cloud requires sending a new or updated source content to XTM Cloud in the form of a translation job and, translate the said content there.
Is there any limit to how many segments a single job can have? For example, I have over 2 000 words, but it seems, I have a hard time to review the job in TMGMT by clicking the Review button.
The limit is within words that are sent, not strings. If you will end up with above 16 000 words or so, you will receive a relevant message when you choose the provider. The message will show you “unsupported” if the file is too big.
Have there ever been clients experiencing the volume issue? We will have a lot of content for initial translation of a website, like the Italian website with 100 000 words or so.
The system will most likely not process the files with 100 000 words. Therefore, we recommend sending the project for translation in XTM Cloud in smaller batches.
What do the numbers under the Progress bar refer to? And what about the colors?
The numbers under the Progress bar refer to files. What is more, the blue progress bar indicates the number of pending (not translated) files, whereas the orange progress bar shows the number of translated files.
I want to set up a continuous project but the system is showing that XTM is not supported. What should I do?
In such a case, you should always read the message that is below. You will find your root cause there: