Introduction

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

Questions and answers

How can I seamlessly install the Drupal connector?

To install the XTM Connect – Drupal plugin, you can either install it 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 installation guide available under the URLs provided below

• Installing the XTM Connect – Drupal plugin;

• TMGMT XTM.

What is happening in Drupal when a project is being reopened on the XTM Cloud end?

Once an XTM Cloud project is imported back to the Drupal CMS, reopening it on the XTM Cloud side will not have an impact on the CMS whatsoever. Therefore, any new or updated content should be first translated by means of a new project.

What might be the reason for the File does not exist in the following location message in the logs? I cannot retrieve the translated file from XTM Cloud back to the Drupal CMS.

In the vast majority of cases, the message File does not exist in the following location 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 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 was already sent off for translation in XTM Cloud, it will be displayed as a draft in the CMS, suggesting that the new content (with revision) was not sent to the XTM connector. Therefore, it is not recommended to make any changes to the content after it was sent to translation, as the changes in question will not be sent at all; as a consequence, the target will not be matched to the source in XTM Workbench.

That might also cause the translated content not to make it back to Drupal since the source content sent to XTM Cloud and the content in the CMS now differ from each other.

Is it possible to connect a certain Drupal language with multiple XTM Cloud languages by means of one language mapping? I am wondering if I can map one Drupal language with all of its language variants in XTM Cloud.

Language mapping in the Drupal CMS is possible only for one Drupal language and one XTM Cloud language at a time, which means that you cannot do a second language mapping for the languages already used in the first language mapping. If you would also like to create a language mapping for a specific language variant, you might need to consider establishing a separate XTM service provider or changing the mapping within the file that is located in: \drupal\web\modules\tmgmt_xtm\src\Plugin\tmgmt\Translator\countryList.json

In the attachment below, you can find how the languages are mapped between Drupal and XTM. 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 customers?

It is possible to connect multiple XTM customers to the Drupal CMS via the connector but you will have to establish a separate XTM service provider.

This of course can be done on 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, the Drupal connector enables to send a single project for translation in XTM Cloud into multiple target languages. To find out how to do so, read the following article: Drupal: Creating multilingual projects in XTM Cloud.