The localization management platform that’s easy to use! Translate your app, website, game or related software in a team or independently using a friendly yet powerful online solution.

To get the best results, POEditor should be used to translate strings only!

Buy WPML for POEditor

Getting Started with POEditor

In order to send files for translation to POEditor, you first have to login to your wpml.org account, and download and install the following plugins on your website:

  • WPML Multilingual CMS: This is the core plugin.
  • WPML Translation Management: This plugin will allow you to connect to POEditor.
  • WPML String Translation: This plugin will allow you to translate interface strings.

If you do not have a wpml.org account, you can create one by simply choosing between our WPML Multilingual CMS or Multilingual CMS Lifetime plans.

Once you have access to your wpml.org account, you can refer to our detailed step-by-step guide on how to download and install WPML. Please remember to register your website to receive automatic updates and gain access to POEditor services.

If you need any help with configuring the WPML plugin, you can go through our getting started guide or post queries on our support forum.

Table of Contents

Connecting your website to POEditor

Once all the required plugins have been installed and activated, you will need your POEditor API Token to connect WPML to the translation service. You will be able to retrieve your API Token after creating your POEditor account.

Creating a POEditor account

You can create a POEditor account for free by visiting the POEditor homepage and clicking on the Try it now for FREE button to sign up.

 

Registration button on the homepage

Registration button on the homepage

 

This will take you to a form, which you can fill in less than 2 minutes.

 

POEditor registration form

 POEditor registration form

Retrieving your API Token

After your account has been created, you will need your API Token to connect with WPML. Login to your POEditor account and click on the Account Settings tab on your Dashboard.

 

Account Settings

Account Settings

 

Go to the API Access tab and copy your API Token.

 

API Access tab

API Access tab

Activating and authenticating POEditor

Login to your WordPress website, then visit WPML-> Translation Management admin page, and click on the Translators tab.

 

Translators tab in WPML

Translators tab in WPML

 

Scroll down to Available Translation Services and click on the Activate button to activate POEditor.

 

Activating POEditor

 Activating POEditor

 

Once the service has been activated, click on the Authenticate button. This is when you will need your API Token, obtained from the previous step.

 

Authenticating POEditor

Authenticating POEditor

 

A popup window will appear, in which you can enter your POEditor API Token. After entering the POEditor API Token value in the API token field, click on the Submit button.

 

POEditor authentication dialog window

POEditor authentication dialog window

 

Congratulations! Your POEditor account is now connected to your WordPress instance.

Now, you are ready to send content for translation.

Sending content for translation

To send strings for translation, go to the String Translation module (WPML->String Translation).

 

String translation module

String translation

 

Select the strings you want to have translated by clicking on the checkboxes in the first column. You can select the target languages by checking the boxes under Translation options, and after doing so, click on the Add to translation basket button.

 

Selecting documents to send for translation

Selecting documents to send for translation

 

Go to Translation Management and click on the blinking tab, labeled Translation Basket, at the top of the page. By clicking on this tab, you will see the list of all the strings that you added to the basket and the languages that these strings are to be translated into.

In the Translation Basket page, you can verify the content you wish to translate, remove strings you mistakenly added, and change the Batch name. The Batch name will be visible on the Translation Jobs tab and will help you find projects. When you are ready to send the strings for translation, simply click on the Send all items for translation button to send all selected items to POEditor.

 

Sending items for translation

Sending items for translation

 

When the translation basket’s contents have been successfully sent to POEditor, you will see a confirmation message as shown in the following figure:

 

Basket contents successfully submitted to POEditor

Basket contents successfully submitted to POEditor

 

Click on the Translation Jobs tab link given in the confirmation message, or click on the Translation Jobs tab at the top of the screen. On the next administration screen, you can click on the link beside the Batch Name label to be redirected to POEditor’s dashboard.

 

Translation Jobs in progress after being sent for translation

Translation Jobs in progress after being sent for translation

POEditor Admin Panel

When you click on the Batch Name label, you will be redirected to your project on POEditor’s website. Here, you will be able to view your project and the languages you selected in WPML.

To begin the translation, click on the Add Contributor button next to the selected target language.

 

POEditor Admin Panel

POEditor Admin Panel

 

You can either select an existing translator,

 

Selecting an existing contributor (translator)

Selecting an existing contributor (translator)

 

or invite a new one

 

Selecting a new contributor (translator)

Selecting a new contributor (translator)

Receiving completed translations

As soon as a translation job has been completed on POEditor, it is ready to be delivered to your website.

Checking for completed translations

You can check for completed jobs by visiting the Translation Jobs tab on in WordPress admin -> WPML -> Translation Management

Locate the batch you want to check and click on the Synchronize status button.

 

synchronize_status

Checking for completed translation jobs

Having your completed translations delivered to your website

Depending on your configuration settings, translations will be delivered automatically or can be manually fetched from your WordPress admin panel.

To check your configuration settings, open WPML->Translation Management and click on the Multilingual Content Setup tab. Find the Translation Pickup mode section and check for the selected option.

 

Selecting translation delivery method

  Selecting translation delivery method

 

The Translation Service will deliver translations automatically using XML-RPC option implies that a translation will be automatically delivered to your website as soon as it is completed.

The site will fetch translations manually option implies that completed translations can be downloaded from the Translations Dashboard (WPML->Translation Management) by using the Get completed translations button at the bottom of the page.

 

Fetching completed translations manually

Fetching completed translations manually

Canceling translation jobs

Although you will not be able to cancel individual translations from WPML, you can delete an entire project from POEditor or only individual languages (jobs). This will be shown as canceled on WPML, and any pending jobs will be reset to the state in which they can be sent for translation again.

Note: Deleting a project from POEditor can cause a loss in the history log of delivered translations.

 

Delete project button

Delete project button

 

Delete individual job button

Delete individual job button

 

When a project is canceled, you can synchronize what appears under the Translation Jobs tab on WPML by clicking on the Synchronize status button.

 

Checking for canceled translation jobs

Checking for canceled translation jobs

 

Canceled jobs are removed from the Translation Jobs tab