4.5.3. Changing the Language of the UI

Currently, the UI is provided only in US English. You can translate the UI and specify that your own locale is used. The following example shows how to translate the UI into French.

  1. Copy the default locale to openidm/ui/extension/locales:

    $ cd /path/to/openidm/ui/default/admin/public/
    $ cp -r locales ../../../extension/

    The extension/locales folder now contains one locale, en-US.

  2. Create a copy of the en-US locale, in a new folder named fr-FR.

    $ cd /path/to/openidm/ui/extension/locales
    $ cp -r en-US fr-FR 
  3. Translate the values of the properties in the fr-FR/translate.json file. Do not translate the property names. For example:

    ...
    "user" : {
        "user" : "Utilisateur"
        "login" : "Login",
        "profile" : "Profil",
    ....
  4. Change the UI configuration to use the new locale by setting the value of the language property in the openidm/conf/ui-configuration.json file, as follows:

    "language" : "fr-FR",
                    
  5. Refresh your browser window for the modification to be applied.