Skip to main content

XTM Connect – WordPress 3.0

Translating WordPress content: end-to-end process

The process for creating translations in WordPress and sending them to XTM Cloud involves two plugins, both of which are installed in WordPress.

Note

The procedures below outline the steps involved in creating a translation in WordPress and sending it to XTM Cloud. From XTM Connect – WordPress 3.0 onwards, this information applies for all content types including Strings. String translation is no longer performed or described separately, as was the case in earlier versions of XTM Connect – WordPress.

To enable any translation projects to be created in WordPress and sent to XTM Cloud, these requirements must be met:

  • WPML, the WordPress Multilingual Plugin must be installed and configured in WordPress.

  • The XTM Connect – WordPress plugin, known as XTM Connect, must be installed and configured in WordPress.

  • In the XTM Connect plugin, it is especially important to ensure that the languages defined in WordPress are mapped to the languages defined in XTM Cloud.

For more details about these plugins, see the Integration overview. For details about general system requirements, see System requirements.

1. Creating content in WordPress

In WordPress, create content for translation. You can also send existing content for translation. This content is usually a WordPress Page, Post or String, but you can also select other content types (Custom Post or Reusable Block).

2. Working in the WPML Translation Dashboard tab screen in the Translation Management screen

In the Translation Dashboard tab screen, do the following:

  1. Select the Translation Management option in the WPML menu, on the left of the screen.

  2. In the Translation Management screen, select the Translation Dashboard tab. In the first section of the Translation Dashboard tab screen, Step 1. Select items for translation, you see a list of existing content items, grouped by type. (By default, WPML only shows 200 results at a time, for performance reasons.).

  3. In the first section, Step 1. Select items for translation, look for the content items you want to send for translation, in the content type-specific lists (Post and so on). Select the content items you require. To do so, select the checkbox to the left of each relevant Title name.

    Warning

    If you select a content item for translation into a particular language, and it is already being translated into that language, the translation task that is in progress will be canceled. You can check which translation tasks are in progress, in a content item, by looking along the item entry to the country flags in this section, Step 1. Select items for translation. An icon below each country flag indicates whether translation into that country's language is in progress.

    We recommend that you are cautious about canceling translation tasks and replacing them with new ones.

    If the content items you want to send for translation are not displayed, use the filters at the top of the Translation Dashboard tab screen to find and display them. For more details, see Filtering content items by different criteria.

    If you have used the filter to find a set of items that you want to translate, you can select them all at the same time.

    To do so, select the checkbox at the top of the screen, on the left, next to the Title column header.

    The content items you select are grouped in a batch.

  4. When you select one or more items for translation, a new Translate your content button is displayed on a bar in the bottom right-hand corner of the Translation Dashboard tab screen.

  5. To start the translation process, select the button. A new section is displayed on screen, below the first section, Step 1. Select items for translation. This new section is called Step 2. Translate your content. In it, in part 1 Content selected for translation, the content items you have selected for translation are listed, grouped by type. You see the word count (Volume) for each item and the Total word count.

  6. In part 2. Translation controls, choose the languages into which you want your content to be translated. You do so by selecting a Translation Method for a language. You can select one target language, or several, or all target languages, as required. The target languages are shown as national flags in the Target language column.

    To select one or a few target languages (even if they have already been translated):

    1. To deselect all languages, find the All Languages entry in the Target language column.

    2. From the Translation Method dropdown, select the Do nothing option. Any translation methods that have been selected for particular target languages are deselected.

    3. For each required target language, from the Translation Method dropdown, select the Assign a translator option. The Choose a translator field is displayed immediately below it.

    4. To use XTM Cloud as your translation service, via XTM Connect – WordPress, select the xtm-wpml-connector option.

      Warning

      If you select the xtm-wpml-connector option for content that is already being translated into a particular language, any translations into that language that are in progress will be canceled. You can check which translations are in progress, in a content item, in the first section, Step 1. Select items for translation.

    5. Once you have selected the xtm-wpml-connector option for all the target languages you require, scroll down to the bottom of the target languages list. You see the Set a batch name and deadline section. For details about it, go to Setting a batch name and deadline, below.

    To select all target languages (even if they have already been translated):

    1. Select the All Languages button.

    2. From the Translation Method dropdown, select the Assign a translator option. The Choose a translator field is displayed immediately below it. Select the Translate button.

    3. To use XTM Cloud as your translation service, via XTM Connect – WordPress, select the xtm-wpml-connector option.

      Warning

      If you select the xtm-wpml-connector option for content that is already being translated into a particular language, any translations into that language that are in progress will be canceled. You can check which translations are in progress, in a content item, in the first section, Step 1. Select items for translation.

    4. Once you have selected the xtm-wpml-connector option for all the target languages, scroll down to the bottom of the target languages list. You see the Set a batch name and deadline section. For details about it, go to Setting a batch name and deadline, below.

Setting a batch name and deadline
  1. In the Set a batch name and deadline section, below the target languages list, you configure a WPML batch, containing your selected content items, which will be processed in the XTM WPML Jobs screen, described below.

    In the Batch name field, you see an automatically-generated name for the batch you are creating. If required, enter a custom name for this batch, to make it easier to identify later.

  2. Select the Suggested deadline date field for the batch. A date picker popup, containing a calendar, is displayed.

    This Suggested deadline date becomes the Deadline date in the XTM Connect – WordPress XTM WPML Jobs tab screen. It specifies when the translation has to be finished in XTM Cloud and returned to WordPress.

  3. If you want to change the time at which the batch is to be returned to WordPress, select it (on the right-hand side of the date picker) before you change the date.

  4. To change the date, pick a date in the future, in the calendar, to select it. The date picker popup closes and your new deadline settings are applied for the selected batch.

    Note

    You must pick a date in the future: dates in the past are invalid and will not be processed.

Triggering batch translation
  1. When you have selected selected the xtm-wpml-connector option for all the required target languages (avoiding those for which translation is in progress, unless new translations are really required), the Translate button below the Suggested deadline date field is activated.

    To send the batch you have created for translation, select the Translate button.

    Result: when the batch has been sent, a confirmation message is displayed in a popup.

  2. To close the popup, select the Ok button at the bottom. The screen is refreshed and you return to the top of the first section, Step 1. Select items for translation.

  3. On the left of the screen, select the XTM button. You see the XTM WPML Jobs screen.

3. Working in the XTM Connect XTM WPML Jobs screen

In the XTM Connect XTM WPML Jobs screen:
  1. Select entire batches, or translation jobs (containing individual content items) in them, for translation. They are created in the WPML Translation dashboard tab screen (described in section "2. Working in the WPML Translation Dashboard tab screen in the Translation Management screen", above).

  2. If required, you can change the Deadline date for a batch, in this screen.

  3. Send the selected batches or translation jobs to XTM Cloud for translation.

    For details, see Assigning a template to one or more translation jobs and sending them to XTM Cloud.

    You generate a translation project, assigned to the selected Customer and containing your selected jobs, in XTM Connect. The translation project is sent to XTM Cloud for translation.

    Each selected translation job is sent to XTM Cloud immediately, with the same template, which you have just selected.

5. Optional: Viewing translation project details in the XTM Connect XTM WPML Projects screen

If required, now select the XTM Project List option in the XTM menu, on the left of the screen. You see the XTM WPML Projects screen. It contains details about current translation projects. You can also filter or cancel projects there.

6. Optional: Viewing or managing translation projects in XTM Cloud

In the Projects tab, in XTM Cloud, you see the project. Its name (in the Name column) will vary, depending on how your instance of XTM Cloud is configured, but the name could, for example:

The translation jobs are sent to the XTM Cloud Linguists (translators) automatically. When they have translated them (in XTM Workbench), and the translation project is finished, the completed translations are returned to WordPress automatically. The Translation requester (in WordPress) is informed by email. (That person is specified in the Email user response for XTM translation setting in the XTM WPML Connector plugin configuration).

7. The final stages: checking and editing the translated texts

If you now check each returned project's Status, in the XTM Connect XTM WPML Projects screen, you will see that it is Finished.

In the WPML Translation Dashboard tab screen, in the Translation Management screen, in the line that contains the project, the languages sent for translation in XTM Cloud, and returned, are marked as translated (tick mark below the relevant country flag). You can now:

Result: you have selected website content, in WordPress, and sent it to XTM Cloud in a translation project, for translation. The finished translation project has been returned to WordPress. The translated content has been uploaded to the website. You have checked it and the finalized content is now ready for users to visit.