Manual:$wgLanguageCode

From MediaWiki.org
Jump to: navigation, search
Localization: $wgLanguageCode
Site language code.
Introduced in version: pre 1.1.0
Removed in version: still in use
Allowed values: (string)
Default value: 'en'

Other settings: Alphabetical | By Function

Details[edit | edit source]

Site language code. Usually set automatically with the installer. List of languages codes can be found at languages/Names.php. The code should be in lower case and use hyphen as separator. Examples: en, ku-latn, de-formal, mai.

This specifies which language your page content is in, and also provides the default language for your wiki's interface. While users can switch the language of interface messages in their preferences, anonymous visitors will see the wiki's interface in the content language. Language selector extension provides way to autodetect the language of anonymous users and let them choose their interface language without logging in.

Note Note: If you change this after installation, in MediaWiki 1.18 and above you can clear the message cache by running echo 'MessageCache::singleton()->clear()' | php maintenance/eval.php. Be prepared to update all messages you have customized in your wiki, move your main page and other broken things before and after all caches has been regenerated.

Note Note: In MediaWiki 1.8 or older, if you change this after installation, you should run the maintenance/rebuildmessages.php script to rebuild the user interface messages (MediaWiki namespace). Otherwise, you will not see the interface in the new language, or a mix of the old and new languages. Note that running that script will override any custom interface messages you may have created.

Note Note: $wgContLanguageCode gives the same value as $wgLanguageCode, but is deprecated in favor of $wgLanguageCode.

Change existing users' language settings[edit | edit source]

You can change existing users' language settings with the userOptions.php maintenance script. They will still be able to change their settings back unless you disable that option (see below).

php userOptions.php language --old en --new cs

Disable user selection of language[edit | edit source]

MediaWiki version: 1.16

If you want to have your wiki in a certain language and not allow users to change this setting, there is a new variable in 1.16 and above, $wgHiddenPrefs:

// disable language selection
$wgHiddenPrefs[] = 'language';
// if you want to disable variants as well
$wgHiddenPrefs[] = 'variant';
$wgHiddenPrefs[] = 'noconvertlink';
$wgLanguageCode = 'pt-br';

See also[edit | edit source]

Language: English  • Deutsch • français • 日本語 • polski • português do Brasil