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:
  1. 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.
      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.
  2. 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.
  3. 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.
  4. 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
  5. 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
    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.
  6. 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.
  7. Configure 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.
  8. Select the newly added language in the Change Language drop-down menu.