Skip to main content

XTM Connect – WordPress 3.0

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:

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.

Note

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

Note

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

Note

If 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:

  • any files sent to XTM Connect – WordPress from WPML are automatically sent straight to XTM Cloud, using the default settings.

  • a project containing those files is automatically created in XTM Cloud, and processed, without any human interaction except translation by Linguists (if human translation is part of the workflow).

Important

Ensure that you have also entered a password in the XTM API Password field, in the Connect to XTM section (described above), .

Note

If 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

Note

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