menu

NodeType Translations

Translating the user interface

Support the documentation

This documentation was written by volunteers. Please help support our effort:

Help us improve the documentation

Backend Default Language

The backend default language for editors can be defined in your settings yaml file.

Neos:
  Neos:
    userInterface:
      defaultLanguage: 'en'

Define Translations

To use the translations for NodeType labels or help messages you have to enable it for each label or message by setting the value to the predefined value 'i18n' instead of using normal text.

Example:

'Vendor.Site:Content.YourContentElementName':
  ui:
    help:
      message: 'i18n'
    inspector:
      tabs:
        yourTab:
          label: 'i18n'
      groups:
        yourGroup:
          label: 'i18n'
  properties:
    yourProperty:
      type: string
        ui:
          label: 'i18n'
          help:
            message: 'i18n'

That will instruct Neos to look for translations of these labels. 

To register an XML Localization Interchange File Format (xliff) file for these NodeTypes you have to add the following configuration to the Settings.yaml of your package:

Neos:
  Neos:
    userInterface:
      translation:
        autoInclude:
          'Vendor.Site': ['NodeTypes/*']

Neos will now look for a file Resources/Private/Translations/en/NodeTypes/Content/YourContentElementName.xlf

The translated labels for help, properties, groups, tabs and views are defined in the xliff as follows:

<?xml version="1.0" encoding="UTF-8"?>
<xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
    <file original="" product-name="Vendor.Site" source-language="en" datatype="plaintext">
        <body>
            <trans-unit id="ui.help.message" xml:space="preserve">
                <source>Your help message here</source>
            </trans-unit>
            <trans-unit id="tabs.myTab" xml:space="preserve">
                <source>Your Tab Title</source>
            </trans-unit>
            <trans-unit id="groups.myTab" xml:space="preserve">
                <source>Your Group Title</source>
            </trans-unit>
            <trans-unit id="properties.myProperty" xml:space="preserve">
                <source>Your Property Title</source>
            </trans-unit>
            <trans-unit id="properties.myProperty.ui.help.message" xml:space="preserve">
                <source>Your help message here</source>
            </trans-unit>
        </body>
    </file>
</xliff>

If you want to learn more in details, how this works and how the workflow can be improved read Translating Text in Fusion.

Overriding Translations

Instead of '18n' translatable content can also be defined by a path to a translation string in the format:
Vendor.Package:Xliff.Path.And.Filename:labelType.identifier

The string consists of three parts delimited by a color:

  • First, the Package Key
  • Second, the path towards the xliff file, replacing slashes by dots (relative to Resources/Private/Translations/<language>).
  • Third, the key inside the xliff file.

For the example above that would be Vendor.Site:NodeTypes.Content.YourContentElementName:properties.title:

properties:
  title:
    type: string
      ui:
        label: 'Vendor.Site:NodeTypes.Content.YourContentElementName:properties.title'

If you e.g. want to relabel an existing node property of a different package, you always have to specify the full translation key (pointing to your package’s XLIFF files then).

Tip

In most cases you do not want to change an existing package, instead set the NodeType of the third-party package to abstract: true and build you own NodeType.

Validate Translations

To help you find labels in the Neos editor interface that you still need to translate, you can use the language label scrambling setting in your yaml file. This will replace all translations by a string consisting of only # characters with the same length as the actual translated label. With this setting enabled every still readable string in the backend is either content or non-translated.

Neos:
  Neos:
    userInterface:
      scrambleTranslatedLabels: true

Note

The translation labels used in the javascript ui are parsed to a big json file. While changing xliff files this cached should be flushed, but still it can turn out useful to disable this cache. You can do so by using the following snippet in your Caches.yaml
Neos_Neos_XliffToJsonTranslations:
  backend: Neos\Flow\Cache\Backend\NullBackend