language.inc.php File Reference

Namespaces
namespace	studip_core

Functions
	get_accepted_languages ()
	init_i18n ($_language)
	getUserLanguage ($uid)
	getUserLanguagePath ($uid)
	setTempLanguage ($uid=FALSE, $temp_language="")
	restoreLanguage ()
	setLocaleEnv ($language, $language_domain='')

Function Documentation

get_accepted_languages()

get_accepted_languages

(

)

This function tries to find the preferred language

This function tries to find the preferred language. It returns the first accepted language from browser settings, which is installed.

@access public

Returns

string preferred user language, given in "en_GB"-style

Here is the call graph for this function:

Here is the caller graph for this function:

getUserLanguage()

getUserLanguage

(

$uid

)

retrieves preferred language of user from database, falls back to default language

@access public

Parameters

string

the user_id of the user in question

Returns

string the preferred language of the user or the default language

Here is the call graph for this function:

Here is the caller graph for this function:

getUserLanguagePath()

getUserLanguagePath

(

$uid

)

retrieves path to preferred language of user from database

Can be used for sending language specific mails to other users.

@access public

Parameters

string

the user_id of the recipient (function will try to get preferred language from database)

Returns

string the path to the language files, given in "en"-style

Here is the call graph for this function:

Here is the caller graph for this function:

init_i18n()

init_i18n

(

$_language

)

This function starts output via i18n system in the given language

This function starts output via i18n system in the given language. It returns the path to the choosen language.

@access public

Parameters

string

the language to use for output, given in "en_GB"-style

Returns

string the path to the language file, given in "en"-style

Here is the call graph for this function:

Here is the caller graph for this function:

restoreLanguage()

restoreLanguage

(

)

switch i18n back to original language

This function switches i18n system back to the original language. Should be called after writing strings to other users via setTempLanguage().

@access public

Here is the call graph for this function:

Here is the caller graph for this function:

setLocaleEnv()

setLocaleEnv	(		$language,
			$language_domain = ''
	)

set locale to a given language and select translation domain

This function tries to set the appropriate environment variables and locale settings for the given language and also (optionally) sets the translation domain. Note: To support non-POSIX compliant systems (SuSE 9.x, OpenSolaris?), the environment variables LANG and LC_ALL are also set to $language.

@access public

Here is the caller graph for this function:

setTempLanguage()

setTempLanguage	(		$uid = FALSE,
			$temp_language = ""
	)

switch i18n to different language

This function switches i18n system to a different language. Should be called before writing strings to other users into database. Use restoreLanguage() to switch back.

@access public

Parameters

string	the user_id of the recipient (function will try to get preferred language from database)
string	explicit temporary language (set $uid to FALSE to switch to this language)

Here is the call graph for this function:

Here is the caller graph for this function: