This article provides answers to questions frequently asked by clients when they begin working with the Drupal connector, XTM Connect – Drupal.

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:

• Installing the XTM Connect – Drupal plugin;

• TMGMT XTM.

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.

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

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).

Open

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.