CTS Auto Translation module

The Extend CTS Auto Translation Module allows you to automatically translate content using Google Translate or Microsoft Translator.

The module connects both external APIs with Magnolia enabling automatic machine-translation with a single click.

You can enable automatic translation in any content app. The CTS Demo module enables automatic translation in the Tour Categories app. 

Installing

<dependency>
  <groupId>info.magnolia</groupId>
  <artifactId>magnolia-module-content-translation-support-extend-auto-translation</artifactId>
  <version>1.7.1</version>
</dependency>

• magnolia-module-content-translation-support-extend-auto-translation.jar

Configuration

The module is configured in /modules/content-translation-support-extend-auto-translation.

How auto translation works

The CTS Demo module enables automatic translation in the Tour Categories app. 

To automatically translate content:

1. Enable automatic translation in a content app. 
2. Make sure you have additional content languages configured and that the fields in the detail subapp that you want to translate have an i18n property set to true. See Enabling multilanguage content for more.
3. Click Automatic translate.
    
4. In the Translation request dialog:
   1. Select target languages.
   2. Select translator.
   3. Optionally, add a comment.
   4. Click Translate.
       
5. You will receive a message in the Pulse when the translation is complete.
6. Edit the item to see the translated content. 
    

Auto translation translators

The module includes two default translator implementations that integrate external translation services:  

• Google: Integrates with Google Translate API.
• Microsoft: Integrates with Microsoft Translator Text API.

Translators are configured in the CTS Common module in /modules/content-translation-support-extend-common/config/translators.

Properties:

Auto translate command

The module registers one command: autoTranslateCommand that chains four commands that are executed sequentially as a single command. The command is used for the commit action in the Translation request dialog. The command classes are part of the CTS Common module. 

The command is registered in /modules/content-translation-support-extend-auto-translation/commands/autoTranslation.

Properties:

Translation request dialog

The Translation request dialog opens when the Automatic translate action is executed.

 In addition to standard fields and actions, the dialog uses the custom auto translate command, translate dialog action definition class and languages select field.

The dialog is configured in /modules/content-translation-support-extend-auto-translation/dialogs/autoTranslationRequest.

Properties:

Here's the Translation request dialog.

Enabling automatic translation in content apps

You can enable automatic content translation in any content app.

Example: Enabling automatic translation in the Contacts app. 

1. Add the i18n property to any field you want to translate in the detail subapp. See Enabling mulitlanguage content for more.
   Example: New Bio text field in the Personal tab in /modules/contacts/apps/contacts/subapps/detail/editor/form/tabs/personal/fields/bio.

   Node name	Value
   editor
   form
   tabs
   personal
   fields
   bio
   class	info.magnolia.ui.form.field.definition.TextFieldDefinition
   i18n	true
   label	Bio
   rows	3

2. Add the Automatic translate action to the browser supapp. The CTS Demo module adds the Automatic translate action to the Tour Categories app. You can copy the action configuration from there. 
   Example: automaticTranslateAction in /modules/contacts/apps/contacts/subApps/browser/actions/automaticTranslateAction.

   Node name	Value
   browser
   actions
   automaticTranslateAction
   availability
   nodes	true
   root	true
   class	info.magnolia.module.contenttranslationsupport.extend.common.action.OpenTranslateDialogActionDefinition
   dialogName	content-translation-support-extend-auto-translation:autoTranslationRequest
   icon	icon-content-translation-app
   label	Automatic translate

3. Add the action to the action bar. 
   Example: automaticTranslateAction in /modules/contacts/apps/contacts/subApps/browser/actionbar/sections/contact/groups/importExportActions/items/automaticTranslateAction.

   Node name
   browser
   actionbar
   sections
   contacts
   groups
   importExportActions
   items
   export
   automaticTranslateAction

4. Test the action in the app. 
   Example: Automatic translate action and dialog in the Contacts app.