Installing UI Language Packs


By default, labels, UI messages, help text, etc. within Ingeniux CMS are provided in English. If your organization requires Ingeniux CMS UI to be in a language other than English to serve an international user base, Ingeniux provides localizations in the following languages/locales:

  • English/United States (Default)
  • Spanish/Mexico
  • French/France
  • German/Germany
  • Simplified Chinese/Mainland China
  • Japanese/Japan

Ingeniux CMS users can select the provided languages/locales through the Change Language drop-down menu.

If your organization requires the UI to be display in other languages/locales, administrators can install a UI language pack of your choice.

To install a UI language pack:

  • Add Language Element to Languages.xml:
    1. Navigate to [path-to-cms-site-instance]\App_Data\xml\Custom\languages.
    2. Open languages.xml in a text editor.

      Note: Alternatively, you can edit this file in Visual Studio after opening the API Extensions Development Harness solution within [path-to-cms-site-instance]\App_Data\xml\Custom.

      languages.xml File

    3. Create a Language element, identifying the new name and locale attribute.

      Example: < Language name="Português" locale="pt-br" />

    4. Save your changes.
  • Include a new flag image:
    1. Navigate to [path-to-cms-site-instance]\App_Data\xml\Custom\languages\flags.
    2. Add a new flag image that represents the new language pack.
  • Create a UI language file:
    1. Navigate to [path-to-cms-site-instance]\l10n\client.
    2. Create a new language file that will contain the UI instructions and labels in the following format:

      [language]-[country].xml
      Example: pt-br.xml

    3. Copy the contents of, for example, en-us.xml into the new language file.

    4. Translate the tag values to the target language.

  • Create a TinyMCE file:
    1. Navigate to [path-to-cms-site-instance]\l10n\client\tinymce.
    2. Create a new TinyMCE file in the following format:
      [language].xml
      Example: pt.xml
  • Create a .resx resource file:
    1. Navigate to  [path-to-your-cms-site-instance]\l10n\server.
    2. Add a new schema file with the following filename format:
      [language]-[country].resx
      Example: pt-br.resx

    Note: The .resx resource file format consists of XML entries, which specify objects and strings inside XML tags, such as error messages. One advantage of a .resx file is that it is human-readable so it can be edited manually in a text editor. For information about its format, see Microsoft: Resources in .resx File Format. For information about creating this file programmatically, see Microsoft: Working with .resx Files Programmatically.

  • Create folder and file for email notification:
    1. Navigate to [path-to-cms-site-instance]\App_Data\xml\Custom\emailNotifications.
    2. Create a folder with the following naming scheme: [language]-[country].
      Example: pt-br
    3. Within the new folder, create a new file named workflowNotifications.xml. This file contains workflow information sent to recipients in the selected language. 
  • Configuring locale listing:
    1. Navigate to Administration > System Options > CMS  > WorldView.
    2. In the WorldView Configuration workspace, ensure that the Enable WorldView and the Enable Top Language Selection Menu checkboxes have been selected.
    3. Click the Add New Language button (+).

      WorldView Configuration: Language Settings

    4. Choose Select from Locales Listing from the menu. The language field displays.
    5. In the language field, enter the name of the new language. The drop-down list displays relevant matches.
    6. Choose the appropriate language-locale pair.
  • Select the newly added language in the Change Language drop-down menu.