Table of Contents
Getting started with Wordbee Beebox
To be able to send files for translation to Wordbee Translation Management software, you first have to login 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 Wordbee Beebox’s services.
- WPML String Translation – this plugin will allow you to translate interface strings.
If you do not have a wpml.org account yet, you can create a new one by simply choosing between our WPML Multilingual CMS and Multilingual CMS Lifetime plans.
As soon as you get access to your wpml.org account, check 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 Wordbee Beebox’s services.
Connecting your site to Wordbee Beebox
Once all the required plugins have been installed and activated, all you need to make sure you have on hand for connecting WPML to a translation service connected to Wordbee Beebox are your Beebox CMS connector credentials API URL, API Project Key, API (Username)Login and API Password.
The steps below describe how to obtain this information from a Beebox Project account. If you do not have login access to a Beebox project please contact your Wordbee Beebox provider for CMS connector credentials.
Finding your Beebox CMS connector credentials
If you are not the administrator of a Beebox server instance, please contact your LSP (Beebox administrator) for your Beebox CMS connector credentials. They are: API URL, API Project Key, API (Username)Login and API Password. Once you have them on hand, move on to the Activating and authenticating Wordbee Beebox section.
If you are the administrator of a Beebox server instance, please go to the For Beebox server administrators section of this guide.
Activating and authenticating Wordbee Beebox
Login to your WordPress website, visit the WPML->Translation Management admin page and switch to the Translation Services tab.
Scroll down to I’m looking for translation management systems and click the link.
Locate Wordbee Beebox from the list and click Activate button to activate it.
Once active, click the Authenticate button to authenticate the service.
A pop-up window will appear in which you can enter your Beebox CMS connector credentials. Enter the values and click the Submit button.
After a few seconds, Beebox will display as an authorized service.
Congratulations! Your Wordbee Beebox account is now connected to your WordPress instance. You are ready to send content for translation.
Sending content for translation
To send documents for translation, open the Translation Dashboard page (WPML->Translation Management) and select the posts and pages you want to have translated using the checkboxes in the first column.
If you have installed and activated WPML String Translation plugin you will also be able to send your theme and plugin strings for professional translation.
Selecting strings and adding them to the translation basket can be done from the WPML -> String Translation administration screen. After selecting some strings, scroll down to the list of languages, select the target languages, and click the Add selected content to translation basket button.
On the Translation Basket tab, you will find a list of all items (posts, pages, and strings) that you have 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 posts and pages mistakenly added and change the “batch name”. When you are ready, simply click Send all items for translation to send everything to Wordbee Beebox.
When the translation basket’s contents have been successfully sent to Wordbee Beebox, you will see a confirmation message such as the one shown below.
At this point, no further action is required from you.
Qualified translators with the matching language pair skills will be notified of the new translation projects. Subsequently, translators will start translating as soon as they accept a translation project.
You can follow the translation progress of the documents you sent to Wordbee Beebox from your Translation Jobs tab.
Receiving completed translations
As soon as a translation job is ready in Wordbee Beebox, it is also ready to be delivered to your website.
Note: If you have configured your Beebox project to allow email notifications, you will receive an email whenever a translation is completed and is ready to be downloaded to your WPML website. If you do not have administrative access to your Beebox project, ask your LSP (Beebox administrator) to enable email notifications for your project.
Depending on your website’s “Translation pickup” configuration, translations will be delivered automatically or will be manually fetched from your WordPress admin panel.
To check your configuration settings, open WPML->Translation Management and switch to Multilingual Content Setup tab. Find the Translation Pickup mode section and check the selected option.
Translation Service will deliver translations automatically using XML-RPC option. This means that as soon as a translation is ready, it will be delivered to your website automatically.
The site will fetch translations manually option implies that completed translations can be downloaded from the Translations Dashboard (WPML->Translation Management), using the Check status and get translations button found at the top of the Translations Dashboard page.
Checking for completed translations
Check for completed jobs by visiting the Translation Jobs tab inside your WPML -> Translation Management.
Locate the batch you want to check and click on the Synchronize status button.
Having your completed translations delivered to your site
Depending on your configuration, 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 switch to the Multilingual Content Setup tab. Find the Translation Pickup mode section and check the selected option.
The Translation Service will deliver translations automatically using XML-RPC option means that as soon as a translation is ready, it will be delivered to your website automatically. You do not need to do anything more but wait for the documents to be delivered to your site.
The site will fetch translations manually option means that completed translations can be downloaded from the Translations Dashboard (WPML->Translation Management), using the Check status and get translations button.
Canceling jobs you’ve already sent
If you must cancel a job please contact your translation team or Wordbee Beebox provider. At this time Wordbee Beebox translation jobs cannot be canceled via the Beebox GUI.
Once a translation job is canceled, you can synchronize what appears under the WPML Translation Jobs tab by clicking on the Synchronize status button.
Having your canceled translations returned to your site
Depending on your Translation pickup mode configuration, this will happen automatically or after you have manually checked for canceled translations.
If you have the Translation Service will deliver translations automatically using XML-RPC option selected, there is no need for you to do anything more at this point but wait.
If you have The site will fetch translations manually option selected, then you will need to use the Check status and get translations button.
In either case, WPML will remove canceled jobs from the Translation Jobs table list.
For Beebox server administrators
After the Beebox CMS project is created visit it’s settings. Click on Edit to be able to edit the settings.
Scroll down to the Text extraction rules setting and click on “Add or update rules”.
Paste the contents of the Beebox Xliff config file in the opened window and save the configuration. Finally do not forget to save the settings.
Once your CMS project is ready, make sure you configure your CMS connector credentials.
When the CMS connector settings section is configured, you will be able to see your API URL, API Project Key, API (Username)Login and API Password.
Once you have copied the fields, we are ready to activate and authenticate Wordbee Beebox from your WordPress administrator.
Optional configuration: If you would like to receive email notifications from Beebox whenever a translation has been completed and is ready to be downloaded to WPML, you can configure this under the Notifications settings of your project.
With your Beebox project correctly configured you are now ready to continue with the Activating and authenticating Wordbee Beebox section.