[UISwitch_language]
Available since Exponential 6.0.15 (in development, not in a release yet).
Summary
The group [UISwitch_language] of settings/uiswitch.ini.
File
settings/uiswitch.ini; override it in settings/override/uiswitch.ini.append.php, in a siteaccess or in an extension.
Settings
| Setting | Default | Description |
|---|---|---|
| Class | expUISwitchLanguageProvider | The display language of the interface: site.ini [RegionalSettings] Locale for this user's requests (translations, date and number formats). Policy: uiswitch/language. |
| Enabled | true | |
| GroupList[] | english; major; regional | The languages a user may choose, shown grouped: first the groups of GroupList[] in their order (each GroupValues_<group>[] in the order given, ranked by how many administrators worldwide need them; why the defaults are what they are: doc/eng-us/features/6.0/ui-switch-languages.md), then every offered language A-Z by its name. A locale is offered only when share/locale/<locale>.ini exists; the siteaccess's own Locale is always offered and choosing it clears the switch. A language without a translation of the interface keeps English texts with its own date and number formats, and says so in the list ("no translation yet"). |
| GroupLabel[<key>] | english=English; major=Major world languages; regional=Regional variants | The group headings (translated in the context kernel/uiswitch/language). |
| GroupValues_english[] | eng-US; eng-GB; eng-AU; eng-CA; eng-IN | |
| GroupValues_major[] | esl-ES; chi-CN; fre-FR; ger-DE; por-BR; jpn-JP; rus-RU; ara-SA; hin-IN; ita-IT; ind-ID; tur-TR; kor-KR; dut-NL; pol-PL; vie-VN; ukr-UA; fas-IR; heb-IL | |
| GroupValues_regional[] | esl-MX; esl-US; fre-CA; fre-CH; ger-AT; ger-CH; por-PT; chi-TW; chi-HK; ara-EG | |
| AllLanguages | enabled | enabled: every locale of share/locale (without the format variants such as eng-GB@euro) is offered and listed A-Z after the groups ("All languages"). disabled: only the groups and AllowedValues[]; those no group names are listed A-Z as "More languages". |
| ListUntranslated | enabled | enabled: languages without a translation of the interface (share/translations/<locale>/translation.ts) are offered too, marked "no translation yet". disabled: only English and the translated languages. |
| AllowedValues[] | (empty array) | More locales to offer, outside the groups (a format variant such as eng-GB@euro, or a list of its own when GroupList[] is empty and AllLanguages=disabled). A test language (TestLanguage=true in its locale file, such as Lorem Ipsum, qlo-ZZ) is never in a group or in the A-Z list of AllLanguages; only naming it here offers it. |
| RememberPreference | disabled | enabled: the choice is also kept in the user's preferences and comes back at the next sign-in. disabled (default): it ends with the session, at logout. |
See also
Generated example: uiswitch.ini [UISwitch_language]
Added to the reference for Exponential 6.0.15: the 4.x reference had no page for this group. The descriptions are the comment lines of settings/uiswitch.ini.
Contributors
- Graham Brookins Updated
Comments
Add a comment