Jump to content

Manual:$wgLanguageCode

From mediawiki.org
(Redirected from Content language)
Language, regional and character encoding settings: $wgLanguageCode
Site language code.
Introduced in version:Before 1.1.0
Removed in version:Still in use
Allowed values:(string)
Default value:'en'

Details

The site language code is usually set automatically with the installer. List of languages codes can be found at includes/languages/data/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. Extension:LanguageSelector provides a way to auto-detect the language of anonymous users and let them choose their interface language without logging in.

If you change this after installation, in MediaWiki 1.18 and above you can clear the message cache by running echo 'MediaWiki\MediaWikiServices::getInstance()->getMessageCache()->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.
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.
$wgContLanguageCode gives the same value as $wgLanguageCode, but is deprecated in favor of $wgLanguageCode. (removed in 1.35)


Change existing users' language settings

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

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