Getting started with GPI
To send files for translation to GPI, you first have to log in to your wpml.org account, and download and install the following plugins on your website:
- WPML Multilingual CMS: the core plugin.
- WPML Translation Management: this plugin will allow you to connect to GPI.
- WPML String Translation: this plugin will enable you to translate interface strings.
As soon as you get access to your wpml.org account, you may refer to our detailed step-by-step guide on how to download and install WPML. Please remember to register your site to receive automatic updates and gain access to GPI’s services.
Table of Contents
- Connecting your website to GPI
- Sending content for translation
- Receiving completed translations
- Canceling translation jobs
Connecting your site to GPI
Once all the required plugins have been installed and activated, all you need to connect WPML to the translation service is your GPI API Keys.
Requesting a GPI account
Alternatively, you can simply click the Contact GPI button and send the details of your website project, including its scope and the languages you require, along with your contact details (please include your phone number).
Receiving your API Keys
After submitting your request, a member of the GPI team will analyze all your information and contact you to discuss your project requirements in detail. Once you have discussed your project, the GPI team member will email an API Key and API Secret Key. You will need these API Keys to connect with GPI through WPML.
Activating and authenticating GPI
Login to your WordPress website, visit the WPML->Translation Management admin page and click on the Translation Services tab.
Locate the GPI service from the list and click the Activate button next to it.
Once the service is activated, click the Authenticate button. Here, you will need the API Keys obtained in the previous step.
A popup window will appear in which you can paste or enter your GPI API Keys. After entering the values, click the Submit button.
After a few seconds, GPI will display at the top as the authorized service.
Congratulations! Your GPI account is now connected to your WordPress account.
Now, you are ready to send content for translation.
Sending your content for translation
To send pages for translation, go to the Translation Management module (WPML->Translation Management)
Select the pages you want to translate by clicking the checkboxes in the first column. Next, select the target languages by checking the boxes, and click the Add selected content to translation basket button.
Go to Translation Management and click on the blinking tab at the top of the page, which is called Translation Basket. On this tab, you will see a list of all the pages (jobs) that you added to the basket, as well as the languages these items are to be translated into.
Here, you can verify the content you wish to translate, remove pages you incorrectly added, and change the Batch name. The Batch name is visible on the Translation Jobs tab and will help you find projects. When you are ready, simply click the Send all items for translation button to send everything to GPI.
When the translation basket’s contents have been successfully sent to GPI, you will see a confirmation message, as shown in the following figure.
Click on the Translation Jobs link in the confirmation message, or click on the Translation Jobs tab at the top of the screen. On the next administration screen, the Batch you just sent to translation will appear.
Receiving a quotation and authorizing your translation
Once your translation basket has been transmitted, GPI will be immediately notified and will carry out a detailed analysis of the batch.
Click on the batch name to be redirected to GPI’s Translation Portal, where you will see a summary of your project (pages sent and a quote) and the languages you selected in WPML.
Receiving completed translations
As soon as a translation job is finished by GPI, it will be ready to be delivered to your website.
Having your completed translations delivered to your site
When translations are complete, you will receive a notification email from GPI.
Go to the Translation jobs tab and click the Synchronize status button first.
Depending on your configuration, translations will be delivered automatically or can be manually fetched from your WordPress admin panel after you click the Synchronize status button.
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 the selected option.
- The option labeled Translation Service will deliver translations automatically using the XML-RPC means that a translation will be delivered to your website automatically after you click the Synchronize status button.
- The option labeled The site will fetch translations manually means that completed translations can be downloaded from the Translations Dashboard (WPML->Translation Management) by using the Check status and get translations button at the bottom of the page after clicking the Synchronize status button.
Once the jobs are fetched, their status in the Translation jobs tab will be changed to “Complete.”
Canceling translation jobs
Although you cannot cancel individual translations from WPML, you can delete an individual job or an entire project from GPI by contacting your GPI Project Manager.
NOTICE: Be aware that cancellation requests for previously submitted work should be sent as soon as possible, as GPI cannot cancel translation work that has already been completed. Unless your commercial terms state otherwise, you will be charged for the work completed.
Having your canceled translations returned to your site
When a project is canceled, information will be returned to your site after you have manually checked for canceled translations. First, click the Synchronize translations button and after a few seconds/minutes (depending on the amount of content), click the Check status and get translations button on the Translation Management Dashboard.
When a project is canceled, it is removed from the Translation Jobs tab in WPML.
How can I know when my translations are complete?
You will receive a notification email from GPI. Go to the Translation Jobs tab and click the Synchronize status button next to the batch you want to fetch. This will trigger a synchronization with GPI’ servers and the jobs will be ready to download.
Click the Check status and get translations button at the top of the Translation Dashboard to download all completed jobs belonging to that batch.