This is a simple workaround to provide basic content translation capability to content-editor based apps such as the Stories app.
The translation UX provided in this solution is different from the standard Magnolia translation UX in the page editor and in standard content apps. This workaround will eventually be replaced with a standard translation mechanism in the core product.
Version 1.0 of this Module is compatible with Magnolia EE Pro 5.6.5 and higher.
This module provides a new 'Translate' Action which can be added to the actionbar of a content-editor based app.
The action opens a dialog where the editor can select the language to translate to - then it creates a copy of the item as a sibling node.
The new item has two special properties, a 'master' property which stores a link to the original item, and a language property. The user can then perform the actual translation on this new item.
A new Translate action is available on the composition nodes. The action:
- Opens a light dialog where the user can pick one of the locales configured on the site, and pick whether the existing story content is copied (by default it is not copied.).
- Creates a new composition node at the same level as the original story. Optionally copying the content of the original node.
- Appends the locale to the node name:
- Sets the
localeproperty to the locale.
- Sets the
masterproperty is to the UUID of the "master" node.
locale property is displayed read-only in the outline.
master property is not displayed in the outline.
The module provides, and registers, a small new templating function library,
The library has one method,
storyfn.localizedStory(content) which is used to get the content from the proper node based on the currently active language.
Use storyfn in your templates to get the translated content. A simple example:
When displaying a list of stories, you will probably want to display just the "master" stories, so that you do not display the originals and the translations all in one list. A simple example:
Each translation is stored in its own sibling node, at the same level as the original.
While this structure could theoretically support translatable node names, that is not covered in this workaround. In fact, for simplicity we use the original node name and append the locale.
A translation composition node will contain two additional properties:
- Stores the locale of the translation
- Stores the UUID of the master node, typically the content in the default locale.
These properties will allow the templates to retrieve the proper content for the desired locale.
The source for this module can be found here: https://git.magnolia-cms.com/projects/FORGE/repos/content-editor-i18n/browse
This light module provides a simple end-to-end example of usage: https://git.magnolia-cms.com/projects/FORGE/repos/content-editor-i18n-demo/browse
- The translated item is linked to the original story, but content is not synchronized. When you change the original you must remember to update the translation yourself.
- We don't plan to provide migration for your story translations once the translation feature is officially released. We don't know yet exactly how story translations will be stored. If possible we will try and provide a Groovy script.
Issues, Bugs, Improvements
Either comment on this page or open a ticket here: CEI18N