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.
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.
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
This will take you to a form, which you can fill in less than 2 minutes.
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.
Go to the API Access tab and copy your API Token.
Activating and authenticating POEditor
Login to your WordPress website, then visit WPML-> Translation Management admin page, and click on the Translation Services tab.
Locate the POEditor service from the list and click the Activate button next to it.
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.
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.
After a few seconds, POEditor will display at the top as the authorized service.
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).
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.
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.
When the translation basket’s contents have been successfully sent to POEditor, you will see a confirmation message as shown in the following figure:
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.
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.
You can either select an existing translator,
or invite a new one
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.
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.
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 Check status and get translations button at the top of the page.
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.
When a project is canceled, you can synchronize what appears under the Translation Jobs tab on WPML by clicking on the Synchronize status button.
Canceled jobs are removed from the Translation Jobs tab.