Getting started with Cloudwords
In order to send files to translation in Cloudwords, you must first login to your wpml.org account, then download and install the following plugins on your website:
- WPML Multilingual CMS – which is the core plugin.
- WPML Translation Management. This plugin allows you to connect to Cloudwords.
- WPML String Translation. This plugin will allows you to translate interface strings.
If you do not have a wpml.org account, you can create one by simply choosing between WPML Multilingual CMS or Multilingual CMS Lifetime plans.
As soon as you obtain access to your account, review the detailed step-by-step guide on how to download and install WPML. Please remember to register your site to receive automatic updates and obtain access to Cloudwords services.
If you need help with WPML plugin configuration you can review getting started guide or simply post a question on the support forum.
Connect your site with Cloudwords
Got all plugins installed? If so, let’s go!
If you do not have a Cloudwords account yet, please go to the contact page and simply fill in and submit the form. A Cloudwords representative will get in contact with you to set up the appropriate account.
As soon as you login to your Cloudwords account, please select Settings->My Account from the menu at the top of the page.
Next switch to the API tab and click the Generate Access Key button and copy your Cloudwords API access key.
Return to your website, open WPML->Translation Management page and switch to the Translation Services tab.
Scroll down to I’m looking for translation management systems and click the link. Locate the Cloudwords service in the list and click the Activate button next to it. As soon as the page reloads the Cloudwords service will appear at the top of the page.
Click the Authenticate button to authenticate the service. In the subsequent popup window enter your Cloudwords API access key and click Submit.
Congratulations! Your Cloudwords account is now connected to your WordPress instance.
Sending documents to translation
To start a translation, open the Translation Dashboard page (WPML->Translation Management) and select the posts and pages you want to translate using the checkboxes in the first column.
Scroll down to the list of languages, select the languages to translate and click the button Add selected content to translation basket.
After the page reloads, a new tab appears at the top of the page called Translation Basket. On this tab you will find a list of all items (posts, pages, strings) that you have added to the basket as well as languages to translate. Here you can verify the content you wish to translate, remove posts and pages mistakenly added and change Batch name. Batch name will be visible as a project name in Cloudwords. When you are ready, simply click Send all items for translation to send everything to Cloudwords.
As soon as WPML sends all the information, you will see a confirmation at the bottom of the screen
You must now finish the configuration in Cloudwords. Click on the Translation Jobs tab at the top of the page and you will see a list of all jobs that you have sent to translation thus far.
The content of the basket you have just sent should be visible at the top of the list. Click on the batch name to open the corresponding project in Cloudwords.
If you are not logged in when you click this link, Cloudwords prompts you for credentials and starts the setup wizard.
The subsequent steps allow you to check source files delivered from WPML, define the translation request and kick off the project.
Vendors (translators) will use all provided information, including your translation memory and prepare bids (which appear on the Bids tab of your project). When you accept the bids the translation starts.
Additional details concerning project configuration, workflow and available options in Cloudwords can be found in the Cloudwords documentation.
When the translation is ready in Cloudwords, it can be delivered to your website. Depending on your configuration, either WPML delivers the translations automatically or you must fetch them manually.
To check your configuration, open the WPML->Translation Management and switch to Multilingual Content Setup tab. Locate the Translation Pickup mode section and check the selected option.
If you have selected the option Translation Service will deliver translations automatically using XML-RPC when the translation is ready in Cloudwords, it will be delivered to your website automatically. This means you are not required to click anything, simply wait until the translation is complete.
If you have selected the option The site will fetch translations manually, each time you want to download translations you must first open Translations Dashboard (WPML->Translation Management) and click the Check status and get translations button.
Current job status can be found on the Translation Jobs tab in the Status column.
Jobs marked In progress are those that are waiting for the translation to be delivered. For jobs marked as Complete, the translation has already been delivered and you can click on the Complete link to view.
If for some reason you do not want to translate pages sent from WPML to Cloudwords please remember the following:
- You cannot manually delete jobs from the Translations Job tab on your website.
- You can cancel the project and jobs only in Cloudwords.
- From Cloudwords you can cancel only an entire project. You cannot cancel a single job (for example the translation of one page for one language pair).
If you have yet to complete the configuration in Cloudwords, open the Translation Jobs tab and click the batch name you want to cancel.
This opens the Cloudwords page. On the top-right corner of this page, the Cancel project link is visible.
If you have completed the configuration, but have yet to accept bids, you can always open the project edit page and cancel project using the button at the bottom of the page.
Please remember that canceling projects for which you have already accepted a bid may incur costs from the vendor as work already completed.
Depending on your Translation Pickup mode configuration, information related to canceled projects may be delivered to your website automatically by means of XML-RPC. Otherwise you must click the Get completed translations button on the Translation Dashboard tab to fetch the changes.
WPML will remove all canceled jobs from the Translation Jobs tab.