Skip to the content
Documentation

[UISwitch_language]

No ratings yet

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

Comments

Add a comment

Comments are read by a moderator before they appear.