Configuring the XTM WPML Connector plugin
You make the configuration settings for the XTM WPML Connector plugin (XTM Connect – WordPress) in the XTM WPML Connector Settings screen. There, you can do the following:
Control the connection between XTM Connect – WordPress and XTM Cloud.
Map WordPress languages to XTM Cloud languages. It is important to verify that the language mappings are correct because XTM Cloud languages include language variants such as English (UK) and English (US) or French (France), French (Canada) and French (Switzerland). If a project is created with an incorrect language combination, in XTM Cloud, due to incorrect language mapping in the XTM WPML Connector plugin, the translation memory for your site might not be accessible. This could potentially mean that your translation memory cannot be leveraged.
Configure the automatically sending of projects straight to XTM Connect – WordPress, using the default settings. This can enable projects to be created and sent for translation more quickly.
Connect to XTM Cloud section
In the XTM WPML Connector Settings screen, make these settings in the Connect to XTM Cloud section to configure the connection between XTM Connect – WordPress and XTM Cloud:
UI label | Description |
|---|---|
XTM API URL | Enter the URL of the XTM Cloud system that this instance of will connect to. NoteFor simplicity, just enter the domain that you use. The rest of the address, which is responsible for connecting to the API, will be added automatically by XTM Connect – WordPress. Previously, it was necessary to enter the full wsdl URL. Example: https://api-123.xtm-intl.com/project-manager-gui/services/v2/projectmanager/XTMWebService?wsdl. From release 1.9, it is only necessary to enter the domain URL. Example (in this case): https://api-123.xtm-intl.com. |
XTM API Client name | Specify the name that the User must enter in the Company name field on the XTM Cloud login page. This is the Company's account name in XTM Cloud. The company must have API access to XTM Cloud enabled. |
XTM API User name | Specify the name that the User must enter in the User name field on the XTM Cloud login page. This user's company must have the API enabled in XTM Cloud. We recommend that you create a new user in XTM Cloud, specifically for XTM Connect – WordPress, to distinguish between XTM Connect – WordPress activity and human actions. |
XTM API User ID | Enter the User's ID number, to identify them when they access the XTM API. NoteThe API user ID that the user must enter, to identify them to the API, in this field is their ID number, not their name or email address. They must enter their ID number, otherwise the connection to the API will fail. |
XTM API Password | Specify the string that the User who is identified by the User ID above must enter in the Password field on the XTM Cloud login page. |
Connect to XTM button: to connect to XTM Cloud with the settings made in the fields above it, select the Connect to XTM button. If the settings are valid, the connection to XTM Cloud is created and you see a confirmation message at the top of the screen, below the XTM WPML Connector Settings header. If the settings are invalid, the connection is not created: correct the settings and try again. Do not proceed until the connection to XTM Cloud is created: it is essential.
Note
If you select the Connect to XTM button, as described above, any connections settings you make are not saved as a result: the only purpose of this button is to check whether the connection you are configuring works. To save your settings, you also still need to select the Save all changes button at the bottom of the screen, as described at the bottom of this online help page.
XTM Settings section
UI label | Description |
|---|---|
Customers dropdown | Select the Customers that can be assigned to translation projects created in XTM Cloud, for this instance of WordPress. You can select a single Customer, or several. This selection of Customers is displayed in the XTM WPML Jobs screen for Translation requesters to select, when they create a project. NoteIf you select several Customers, they will all be displayed in the Customers field. You can then, if required, drag them left or right to sort them. The first Customer (on the left, in the list) will be used as the default Customer for projects created in XTM Cloud. |
Default template ID dropdown | To set a default template, which will be used to generate all XTM Cloud translation projects in this instance of WordPress, select it from the dropdown here. |
Project name prefix | Specify a prefix that is to be inserted at the start of the names of translation projects. Later, this prefix will then be used to distinguish projects from other projects in XTM Cloud. Prefix format: can contain a combination of numbers, small and capital letters, underscores, hyphens or special characters. Maximum length: 50 characters. Example: WordPress_. |
Email user response for XTM translation | Enter the email address of the user who is to be notified when a translation project has been completed in XTM Cloud, and returned to WordPress. |
Language Mappings section
In the Language Mappings section, you will see a table containing the languages that are present in your instance of the WPML plugin. The dropdown next to each language contains the language or language variant defined for that WordPress language, in XTM Cloud.
Not every language has language variants. Examples:
French does have language variants such as French (France), French (Canada) and French (Switzerland). (However, there are many more possible French language variants, which might be present in your instance of the WPML plugin.)
Estonian does not have language variants.
For each WordPress language, check that each required, correct XTM Cloud language variant is selected (displayed in the dropdown field).
Default Configuration section
In the Default configuration section, you can set the following:
UI label | Description |
|---|---|
Automatically move jobs from XTM WPML Connector to XTM Cloud, with default settings. checkbox | If you select this checkbox:
ImportantEnsure that you have also entered a password in the XTM API Password field, in the Connect to XTM section (described above), . NoteIf you select this checkbox, the options for creating projects in XTM Connect – WordPress are bypassed. For this reason, the XTM WPML Connector WPML Job List is not used. Projects can then be created and sent for translation more quickly. It is useful to select this setting if you only create translation jobs, and send them for translation, in one way. |
Automatically send files from this translator to XTM Cloud: "First available (Local)" checkbox | NoteThis checkbox is not displayed until you have selected the Automatically move jobs from XTM WPML Connector to XTM Cloud, with default settings. checkbox and then selected the Save all changes button. You need to select this button twice, if you use this setting and the next one: once to activate the display of this checkbox and the dropdown below it, then again after you have made settings in them. If you select this checkbox, files received from the translator you specify are automatically sent to XTM Cloud for translation. (Currently, only the "First available (Local)" translator can be selected.) |
Result: you have configured the settings for the XTM WPML Connector plugin.
To save your settings, select the Save all changes button at the bottom of the screen.