Versions Compared

Version Old Version 12 New Version Current
Changes made by

Monika Jayaram

Former user

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Make sure that you have installed a Beebox Server instance or you have subscribed to a hosted Beebox. You can obtain trial versions from Wordbee.

Carefully read the Installation prerequisites before you proceed.

...

Plugin installation

The installation is straightforward:

...

  • Beebox Translation Console-: Pressing this tab would open the main screen of AEM connector which let's user to complete translation workflow i.e. sending items for quotation, sending items for translation, retrieving and importing translations back after translation. 
  • Polling Management Console-: This screen is basically for the administrator users only to select the Frequency (in seconds) for receiving Quotation and translation import background jobs.

Polling configuration (optional)

It is possible to configure the frequency for receiving Quotation and translation import background jobs.

By default, the connector is configured to retrieve:

  • The status of the quotations and jobs every 10 minutes (600 seconds).
  • The translations every 30 minutes (1800 seconds).

To change time interval for any of these jobs, use the Polling Management Console, select the job and

...

press Edit and finally change the update interval as shown below and

...

press Ok.

Configuring the plugin

In order to configure the plugin you require the web location of a Beebox server, a project key and credentials. Please see the Prerequisites page.

Once you have all connection details, proceed as follows:

  • Open your AEM site in administrative mode.
  • Press Beebox Translation Console, following screen would be shown.

Image Removed

  • Press Settings->Wordbee Beebox configuration following screen would come up.

Image Removed

  • Select the source language as configured in Beebox project and fill all Beebox connection details as shown below.
  • Providing proxy details is optional.
  • Press Test, to check AEM site connection with Beebox should you have entered correct details Success message would be shown.
  • Finally, press Submit.
     
Warning
titleConnection problems

There may be many reasons why a connection to the Beebox fails. See Troubleshooting.

 The connection setting page shows these fields:  

 

 

 

Field
Description
Server UrlA URL pointing to the Beebox server. Supplied by the Beebox manager: Prerequisites
Project KeyA key identifying a Beebox project. Supplied by the Beebox manager.
LoginA login to access the Beebox. Supplied by the Beebox manager.
PasswordA password to access the Beebox. Supplied by the Beebox manager.
Source language

The source language that is configured in your AEM site and Beebox project.

 

If a user wants to set proxy, the following details needs to be provided:

  1. Host : IP address of the proxy server.
  2. Port : Port on which the proxy server needs to run.

The proxy server can be authenticated by providing the authentication details:

  1. User name.
  2. Password.

Configuring language

Once your bundle is up and running, make following configurations to start your translation workflows. 

  • You need to know source language i.e you require translation from. Corresponding to each source language, there must be a Beebox project configured. 
  • You need to target languages i.e. you require translation into.
  • Then there is default asset language that will be used as source language for asset(doc, text files). 

To finally configure languages;

...

Rollout configuration (recommended)

This part is related to the configuration of the AEM Rollout feature, to avoid AEM to copy the Beebox properties on the copied pages.

Although it is needed only if you use the Rollout feature of AEM, then please consider configuring these settings.

To disable the copy of these properties,

  • In the AEM administration, select Web Console (i.e. http://localhost:4502/system/console/configMgr)
  • Part 1: Day CQ WCM Rollout Manager
    • Search for
    “Language Info”, you will find a configuration with name “Beebox Language Configuration”. Select it.
  • Press on Edit, the following screen would come up.
    Image Removed

Only these source and target languages will be available for translation. Each source and target language are separated by “=”. For example, “English” with AEM language code as “en” would be represented as en=English

Other languages can be configured in a similar way, with AEM language code on left of “=“ and nice name on right hand side.

Configuring Component Properties

On same URL(http://localhost:4502/system/console/configMgr), search for following three configurations. Although it is needed if you will be using “Rolloutfeature”, still it is recommended that you make this configurations otherwise alsoin the first place.

Add following to “Exclude page properties”:

beebox_translationStatus

...

    • a configuration named Day CQ WCM Rollout Manager and edit it.

      Image Added

    • Add the following properties, in the Excluded Page Properties setting :
      • beebox_lastTranslationDate
      • beebox_translationStatus
      • beebox_translatedTo
      • beebox_

...

WCM Rollout Manager

 

Image Removed

CQ MSM Content update action

Image Removed

 

  • Next is target language configuration. This needs to be done in case beebox language code differs from AEM language code. For example, in AEM if some language code is en_ab whereas in Beebox its en-LA, then it needs to be configured for correct translation to happen. For language codes that do not have locale and are simply “en” and “fr” like, you can start without configuring this.

            Go to Settings -> Language Mappings

Image Removed

  • Path indicator is a user defined input and it is optional. 
  • If the user specifies path indicator, then the target path will be changed accordingly.

           E.g. For site language French(fr),

                 1. If path indicator is not specified, the target path would be as follows:

                  source path: /content/geometrixx-outdoors-4/en/men

                  target path: /content/geometrixx-outdoors-4/fr/men

                 

                 2. If path indicator is specified as fr_FF, the target path would be as follows:

 

                  source path: /content/geometrixx-outdoors-4/en/men

 

                  target path: /content/geometrixx-outdoors-4/fr/fr_FF/men

 NOTE : Path indicator is optional and one time configurable. It is advised not to change it as we will be consdering source lang through path.  Once it is configured, translated pages will be created in the path configured.

TRANSLATION PREVIEW :
  •  This needs to be done if the user wants to save the base url of the site. It can be configured from
            Go to Settings -> Translation Preview.
Image Removed
  • To configure the base url, enter the base url in "Public URL of website" text box and click on "Save" button.

 

...

      • translatedFrom

    • Save the settings.

  • Part 2: CQ MSM Content Update Action
    Also, we need to configure the CQ MSM Content Update Action to avoid AEM to update the Beebox properties of the copied pages, when the parent is modified.
    • Search for a configuration named CQ MSM Content Update Action and edit it.

      Image Added

    • As before, add the following properties in the Excluded Page Properties setting :
      • beebox_lastTranslationDate
      • beebox_translationStatus
      • beebox_translatedTo
      • beebox_translatedFrom

    • Save the settings.

Next step : Configuring the plugin