Wordbee Beebox is a Translation service connector. Send content for translation to your preferred language service provider (LSP).

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.

If you need any help with the WPML plugin configuration, you can go through our getting started guide or just ask a question on the support forum.

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.

Translation Services Tab
Translation Services Tab

Scroll down to I’m looking for translation management systems and click the link.

Translation management systems link
Translation management systems link

Locate Wordbee Beebox from the list and click Activate button to activate it.

Activating Wordbee Beebox
Activating Wordbee Beebox

Once active, click the Authenticate button to authenticate the service.

Authenticating Wordbee Beebox
Authenticating Wordbee Beebox

A pop-up window will appear in which you can enter your Beebox CMS connector credentials. Enter the values and click the Submit button.

Wordbee Beebox authentication dialog window
Wordbee Beebox authentication dialog window

After a few seconds, Beebox will display as an authorized service.

WordBee Beebox is authorized
WordBee Beebox isauthorized

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.

Selecting documents to send for translation
Selecting documents to send for translation

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.

Sending items for translation
Sending items for translation

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.

Basket contents successfully submitted to Wordbee Beebox
Basket contents successfully submitted to Wordbee Beebox

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.

Translation jobs in progress after having been sent for translation
Translation jobs in progress after having been sent for translation

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.

Select translation delivery method
Select translation delivery method

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.

Download completed translations
Download completed translations

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.

Checking for completed translation jobs
Checking for completed translation jobs

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.

Select translation delivery method
Select translation delivery method

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.

Fetching completed translations manually
Fetching completed translations manually

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.

Checking for cancelled translation jobs
Checking for cancelled translation jobs

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.

Manually checking for cancelled translations
Manually checking for cancelled translations

In either case, WPML will remove canceled jobs from the Translation Jobs table list.

For Beebox server administrators

If you are the administrator of a Beebox server instance make sure you follow the Beebox user guide for creating a CMS project and connecting it to a translation vendor.

After the Beebox CMS project is created visit it’s settings. Click on Edit to be able to edit the settings.

Beebox Project settings
Beebox Project settings

Scroll down to the Text extraction rules setting and click on “Add or update rules”.

Text extraction rules
Text extraction 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.

Beebox CMS connector credentials
Beebox CMS connector credentials

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.


See what others say

There are no reviews yet.