Skip to main content

XTM Connect – WordPress 2.0

Translating strings: end-to-end process

In WordPress, "string" is a special content type. For details, see String.

The procedure for translating WordPress strings is very similar to the procedure for translating other content (such as Pages or Posts). The only major difference is in the way that strings are selected for sending to XTM Cloud, for translation.

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

To enable translations containing WordPress strings 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. In it, the String Translation module is used for string translation, alongside the Translation Management module, which is also used for other translations.

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

Note

The procedures below outline the steps involved in creating a translation containing strings in WordPress and sending it to XTM Cloud. This information only applies for Strings. Translation of other content types is described separately in Translating content items: end-to-end process.

1. Creating string content in WordPress

In WordPress, create string content for translation. You can also send existing string content for translation.

2. Working in the WPML String translation screen

In the main WordPress screen, do the following, to send string content for translation:

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

  2. In the String translation screen, use the filter to find the existing strings you want to send for translation.

  3. Select the strings that you want to send for translation:

    • To select one or more several strings, but not all of them, select the checkbox by each relevant string Domain name, in the Domain column. Every string belongs to a Domain, but mght not have its own individual Name.

    • To select all strings, select the checkbox to the left of the Domain column heading. The checkboxes next to all strings, in the Domain column, are selected.

  4. Scroll to the Translate selected strings section at the bottom of the strings list. There, you will select the languages into which you want the selected strings to be translated. You can send a string for translation into one or more languages:

    • To translate the selected strings into all available target languages, select the All languages checkbox. The checkbox next to each target language is selected.

    • To translate the selected strings into one or more specific target languages, but not all target languages, first deselect the All languages checkbox. The checkbox next to each target language is deselected.

      Then select the checkbox next to each required target language.

  5. When you have selected the required target language(s), select the Add selected strings to translation basket button. They are sent to the Translation Basket tab screen in the WPML Translation Managment screen.

    From this point, the procedure for translating strings is the same as for other content types such as pages and posts. A batch, created in the WPML Translation Basket tab screen for sending to XTM Cloud, can contain both strings and other content types.

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 String translation. If not, select the String translation 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.