Localization and text customization

This howto works for iam-app-cas package 0.6 and newer.

IAM appliance’s CAS offers English and Czech languages by default. Other languages are auto-detected by the application but their translation may be incomplete.

You can add the missing localization strings yourself or even override default localization strings using custom message catalogs in /data/volumes/cas/msgcat/. This directory may contain multiple files:

  • custom_messages.properties - The default message strings file. Also serves for English and as a default fallback when no language-specific string is found.

  • custom_messages_xx.properties - A language-specific message file. The xx string denotes the language locale (e.g. cs for Czech, es for Spanish, etc.). If the file is not here, simply create it.

Those files have standard Java properties file syntax.

Caveats

  • If you want to translate some string that is not already mentioned in the files, you have to look up its key directly in the CAS’s Thymeleaf templates.

  • custom_messages have higher priority than default bundled messages.

    • This means if you want to override some string in English language, you also have to override it in all languages you want to support.

    • Message strings search priority:

      1. custom_messages_xx.properties (xx according to user’s browser locale)

      2. custom_messages.properties

      3. bundled messages_xx.properties (xx according to user’s browser locale)

      4. bundled messages.properties