In order to present a localized version of Optimize to users corresponding to their default Browser language, Optimize provides the possibility to configure localizations.
Default Locale Configuration
The distributions of Optimize contain the default localization files under
The default localizations available are
en for English and
de for German.
Additionally English is configured as the default
fallbackLocale. Fallback in this case means whenever a user has a Browser configured with a language that is not present in the
availableLocales list, Optimize will use the
The default locale configuration in
./config/environment-config.yaml looks like the following.
locales: availableLocales: ['en', 'de'] fallbackLocale: 'en'
For more details on the configuration keys please refer to the localization configuration section.
Custom Locale Configuration
Custom locales can be added by creating a locale file under
./config/localization/ and adding it to the
Please note the following:
Configuring a custom locale means you have to maintain it yourself and update it in the context of an Optimize Upgrade. There is currently no changelog of new localization entries available and it is required that each localization file contains an entry for each key used by Optimize.
As an example, a custom localization can be created by making a copy of the
/config/localization/es.json and adding it to the available locales in
locales: availableLocales: ['en', 'de', 'es'] fallbackLocale: 'en'