Customizing Loginapp REST UI texts and changing translations with the UI SDK

The Loginapp REST UI supports translation and internationalization (i18n).

• It ships with translations for:
• English
• German
• French
• Italian

Note that all text and translation changes made via the UI SDK apply only to UI texts. Any non-UI-related text changes (such as email, SMS, or Cronto texts that are not part of the Loginapp UI) can instead only be changed in custom strings_*.properties files, as described in the section Customizing non-UI-related text elements in the Loginapp REST API.

The UI SDK allows for easy changes to the default translations and/or adding new texts.

Language-specific texts, aka translations, are stored in:
$CUSTOM_DIRECTORY/src/assets/custom/i18n

For example, to change the English text of the Username label on the password page, simply add:

authentication.password.username = Your username

To identify the keys used for a particular use-case, you may enable the option Show Translation Keys in the Loginapp REST UI SDK settings. As a result, the relevant keys are displayed directly in the SDKs development UI. Alternatively, download the templates below which include all built-in translation keys and their default values.

The following i18n property files contain all the default translations for all languages that are provided with Airlock IAM:

de.properties, en.properties, fr.properties, it.properties

These files are provided for reference only. It is recommended to only add (uncomment) keys that need to be customized.

To add a new language, do the following:

1. In $CUSTOM_DIRECTORY/src/sdk/config/custom.sdk.config.js uncomment config.languages and add the new language in the list of available languages.
2. Create a corresponding language file in $CUSTOM_DIRECTORY/src/assets/custom/i18n (e.g. es.properties).
3. Add translations for all used text elements. The built-in properties for the languages shipped with the product are linked above.
4. The new language is now available in the SDK and can be used in dev mode and will be included in the SDK build artifact.

The IAM configuration must be adapted, too: It also defines the set of available languages.

• In the Config Editor, go to Loginapp >> Language Settings
• Add the language to the Valid Languages list.

Depending on the used feature set, there may be other points in the configuration where the new language must be added (e.g. language choice in user registration self-service or user management in the Adminapp).

• Customizing UIs and texts