The "locales" section is where you define all the different language variants available on a Magellan site. You create one definition per language. The language shows in the toolbar language selector dropdown.
When a user selects a language, the Magellan site is configured with the published variant for the locale.
In this example the default (10) is chosen.
"loc_id": "10" |
This is the ID that represents the language/locale. It must be different for each locale, and be unique to the Magellan site. It can be any set of alpha numeric characters, and does not have to be a number. For example, it could be en-gb, en-apac, or fr-ca. It forms part of the URL so if you change it later, any saved URLs by end users will break. For example: |
"loc_description" "English" |
This is a description/name of the language. It is for internal reference and is not displayed in the application. |
"loc_google": "en" |
This is used when the site is configured for automatic translation using the Google translation API. This Magellan feature is currently in Beta and will be fully supported in a future release. Leave at the default setting. |
"loc_ait": "en-us" |
This must match the 4-character locale code used by the json file names found in the \assets\resources folder. Note the first 2 characters must also match the sub-folder name under the resources folder. |
"loc_label": "Locale" |
This is for internal reference and is not displayed in the application. |
"loc_language": "English" |
This is what appears in the language selector. It should be in the target language so a user of that target language can read it and use it to switch to their language. |
"filter_labels": [ { "version": "Version" }], |
This is related to the "defaults" section, which is in Beta for a future release. Leave at the default setting. |