Manual:$wgLang

From MediaWiki.org
Jump to navigation Jump to search
Other languages:
Deutsch • ‎English • ‎español • ‎français • ‎polski • ‎português do Brasil • ‎čeština • ‎中文 • ‎日本語

Details[edit]

The user language object is the language object selected in user preferences. It is one of two global language objects, the other being $wgContLang . See the page Manual:Language for more information.

$wgLang is initialized towards the end of setup; some hooks are called earlier than that and should avoid using it. When in doubt use $wgUser->isSafeToLoad() to check.

Often used Methods[edit]

This is not an exhaustive list, view class above to see a complete listing.

$wgLang->commaList( $list )
delimit a list of strings according to the conventions of the user's language
$wgLang->getCode()
return the user's language code, for example "en"

Recommended alternative[edit]

It is best that new code avoids using global variables when alternatives exist. In the case of $wgLang, two alternatives exist and can be used:

  • Use an instance of Context class to get the language used in that context, e.g. $contextSource->getLanguage() (see also: Manual:RequestContext.php#Accessors)
  • Use MediaWikiServices to get the content language statically, e.g. MediaWikiServices::getInstance()->getContentLanguage(); (to read more about MediaWikiServices, see Dependency Injection)