Skip to main content

XTM Connect – WordPress 2.0

Translating content items: 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. This information applies for all content types except Strings. String translation is described separately in Translating strings: end-to-end process.

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 or Post, but you can also select other content types (Custom Post or Reusable Block).

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

In the 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 Dashboard tab. In the Dashboard tab screen, you see a list of existing content items. (By default, WPML only shows 200 results at a time, for performance reasons. If you need this to be increased, select the Screen options button in the top right- hand corner of the screen and then change the Number of items per page setting in the Pagination popup to a higher number).

  3. In section 1. Select items for translation, select the content items you want to send for translation. To do so, select the checkbox next to each relevant Title name.

    If the content items you want to send for translation are not displayed, use the filters at the top of the Dashboard tab screen to find and display them. For more details, see Filtering translation 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.

  4. In section 2. Select translation options, choose which languages you want your content to be translated into. You can select one target language, or several, or all target languages, as required. The target languages are shown as national flags on the right of the Dashboard tab screen. An icon under each flag shows whether the item has been translated into that target language or not.

    All the possible translation statuses are listed in a table in the WPML: Translation Management option section.

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

    1. Select All Languages > Do nothing button to deselect all languages.

    2. For each required target language, select the Translate button.

    3. Once you have selected all the target languages you require, select the Add selected content to translation basket button to add the selected languages to the Translation basket.

      Result: the Translation Basket tab is now displayed (previously not present). A red icon on the tab contains a number which tells you how many source items (example: Pages or Strings) have been sent to the Translation Basket.

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

    1. Select the All Languages button.

    2. Select the Translate button.

    3. Once you have selected all the target languages you require, select the Add selected content to translation basket button to add the selected languages to the Translation basket.

      Result: the Translation Basket tab is now displayed (previously not present). A red icon on the tab contains a number which tells you how many source items (example: Pages or Strings) have been sent to the Translation Basket.

  5. Select the Translation Basket tab.

3. Working in the WPML Translation Basket tab screen in the Translation Management screen

A batch, in the WPML Translation Basket tab screen, in the Translation Management module, contains one or more translation jobs (translations into different target languages) for one or more content items. To create a batch in the WPML Translation Basket tab screen, for sending to XTM Connect for translation processing, do the following:

  1. In section 1. Review documents for translation, check that the correct items have been sent to the Translation Basket, from the Dashboard. If not, select the Dashboard tab again, and change your selection. Then send the corrected content for translation again.

  2. In section 2. Set a batch name and deadline, create a batch that contains the items you have sent for translation. To do so:

    • Enter its Batch name. When the batch is sent to XTM Cloud, as a translation job, this batch name is added to the XTM Cloud project name, as a prefix.

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

  3. In section 3. Choose translator or Translation Service, select XTM Connect from the Translator dropdown.

  4. Select the Send all items for translation button. The batch you have created, containing your selected jobs, is sent to XTM Connect for translation processing. You see a Sending your jobs to translation message at the bottom of the screen. When the message text says "All done.", your batch has arrived in XTM Connect, for sending to XTM Cloud.

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

4. Working in the XTM Connect XTM WPML Jobs screen

In the XTM Connect XTM WPML Jobs screen, you can select batches, created in the WPML Translation Basket tab screen (described in section "3. Working in the WPML Translation Basket tab screen in the Translation Management screen", above). You can then send them to XTM Cloud for translation. If required, you can change the Deadline date for a batch, in this screen.

For details, see:

In each case (whether you send a single or multiple batch), select Apply next to the Bulk actions (template selection) dropdown. 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. It is sent when the next scheduled cron job runs. For more information, see Cron job settings (reference).

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.

  • To jump straight to a project, in XTM Cloud, select its Project ID, in the Project ID column, to display and manage the project in the Projects tab in XTM Cloud. You can do this at any time.

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 Translators automatically. When they have translated them (in XTM Workbench), and the translation project is finished, the completed translations are automatically returned to WordPress. 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 Basket 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 (green tick Green_tick_-_translated.png 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.