Inheritance diagram for oxLang:

Collaboration diagram for oxLang:

Public Member Functions
	setIsTranslated ($blIsTranslated=true)
	isTranslated ()
	resetBaseLanguage ()
	getBaseLanguage ()
	getObjectTplLanguage ()
	getTplLanguage ()
	getEditLanguage ()
	getLanguageArray ($iLanguage=null, $blOnlyActive=false, $blSort=false)
	getAdminTplLanguageArray ()
	getLanguageAbbr ($iLanguage=null)
	getLanguageNames ()
	translateString ($sStringToTranslate, $iLang=null, $blAdminMode=null)
	getSimilarByKey ($sKey, $iLang=null, $blAdmin=null)
	formatCurrency ($dValue, $oActCur=null)
	formatVat ($dValue, $oActCur=null)
	getLanguageTag ($iLanguage=null)
	validateLanguage ($iLang=null)
	setBaseLanguage ($iLang=null)
	setTplLanguage ($iLang=null)
	getName ()
	getFormLang ()
	getUrlLang ($iLang=null)
	processUrl ($sUrl, $iLang=null)
	detectLanguageByBrowser ()
	getMultiLangTables ()
	getSeoReplaceChars ($iLang)
	getAllShopLanguageIds ()
	getLanguageIds ($iShopId=null)
	getActiveShopLanguageIds ()
Public Member Functions inherited from oxSuperCfg
	__call ($sMethod, $aArgs)
	__construct ()
	getConfig ()
	setConfig ($oConfig)
	getSession ()
	setSession ($oSession)
	getUser ()
	setUser ($oUser)
	isAdmin ()
	setAdminMode ($blAdmin)

Protected Member Functions
	_collectSimilar ($aData, $sKey, $aCollection=array())
	_recodeLangArray ($aLangArray, $sCharset, $blRecodeKeys=false)
	getTranslationsExpectedEncoding ()
	_getLangFilesPathArray ($iLang)
	_getAdminLangFilesPathArray ($iLang)
	_appendLangFile ($aLangFiles, $sFullPath, $sFilePattern="lang")
	_appendCustomLangFiles ($aLangFiles, $sLang, $blForAdmin=false)
	_appendModuleLangFiles ($aLangFiles, $aModulePaths, $sLang, $blForAdmin=false)
	_getLangFileCacheName ($blAdmin, $iLang, $aLangFiles=null)
	_getLanguageFileData ($blAdmin=false, $iLang=0, $aLangFiles=null)
	_getLanguageMap ($iLang, $blAdmin=null)
	_getCacheLanguageId ($blAdmin, $iLang=null)
	_getLangTranslationArray ($iLang=null, $blAdmin=null, $aLangFiles=null)
	_sortLanguagesCallback ($a1, $a2)
	_getActiveModuleInfo ()
	_getDisabledModuleInfo ()
	_getBrowserLanguage ()
	_getLanguageIdsFromDatabase ($iShopId=null)
	_getConfigLanguageValues ($sLanguageParameterName, $iShopId=null)
	_selectLanguageParamValues ($sParamName, $sShopId=null)
	_getLanguageIdsFromLanguageParamsArray ($aLanguageParams)
	_getLanguageIdsFromLanguagesArray ($aLanguages)

Protected Attributes
	$_sName = 'lang'
	$_iBaseLanguageId = null
	$_iTplLanguageId = null
	$_iEditLanguageId = null
	$_aLangCache = array()
	$_aAdminTplLanguageArray = null
	$_aLangAbbr = null
	$_aAdditionalLangFiles = array()
	$_aLangMap = array()
	$_aActiveModuleInfo = null
	$_aDisabledModuleInfo = null
	$_blIsTranslated = true
	$_iObjectTplLanguageId = null

Additional Inherited Members
Static Protected Attributes inherited from oxSuperCfg
static	$_oConfig = null
static	$_oSession = null
static	$_oRights = null
static	$_oActUser = null
static	$_blIsAdmin = null

Detailed Description

Language related utility class

Definition at line 6 of file oxlang.php.

Member Function Documentation

oxLang::_appendCustomLangFiles	(	$aLangFiles,
		$sLang,
		$blForAdmin = `false`
	)

protected

Appends Custom language files cust_lang.php

Parameters

array	$aLangFiles	existing language files
string	$sLang	language abbreviation
bool	$blForAdmin	add files for admin

Returns: array

Definition at line 790 of file oxlang.php.

oxLang::_appendLangFile	(	$aLangFiles,
		$sFullPath,
		$sFilePattern = `"lang"`
	)

protected

Appends lang or options files if exists, except custom lang files

Parameters

array	$aLangFiles	existing language files
string	$sFullPath	path to language files to append
string	$sFilePattern	file pattern to search for, default is "lang"

Returns: array

Definition at line 767 of file oxlang.php.

oxLang::_appendModuleLangFiles	(	$aLangFiles,
		$aModulePaths,
		$sLang,
		$blForAdmin = `false`
	)

protected

Appends module lang or options files if exists

Parameters

array	$aLangFiles	existing language files
array	$aModulePaths	module language file paths
string	$sLang	language abbreviation
bool	$blForAdmin	add files for admin

Returns: array

Definition at line 821 of file oxlang.php.

oxLang::_collectSimilar	(	$aData,
		$sKey,
		$aCollection = `array()`
	)

protected

Iterates through given array ($aData) and collects data if array key is similar as searchable key ($sKey*). If you pass $aCollection, it will be appended with found items

Parameters

array	$aData	array to search in
string	$sKey	key to look for (looking for similar with strpos)
array	$aCollection	array to append found items [optional]

Returns: array

Definition at line 444 of file oxlang.php.

oxLang::_getActiveModuleInfo ( )

protected

Returns active module Ids with paths

Returns: array

Definition at line 1184 of file oxlang.php.

oxLang::_getAdminLangFilesPathArray ( $iLang )

protected

Returns array with paths where admin language files are stored

Parameters

int $iLang active language

Returns: array

Definition at line 727 of file oxlang.php.

oxLang::_getBrowserLanguage ( )

protected

Gets browser language.

Returns: string

Definition at line 1214 of file oxlang.php.

oxLang::_getCacheLanguageId	(	$blAdmin,
		$iLang = `null`
	)

protected

Returns current language cache language id

Parameters

bool	$blAdmin	admin mode
int	$iLang	language id [optional]

Returns: int

Definition at line 970 of file oxlang.php.

oxLang::_getConfigLanguageValues	(	$sLanguageParameterName,
		$iShopId = `null`
	)

protected

Returns list of all language codes taken from config values of given 'aLanguages' (for all subshops)

Parameters

string	$sLanguageParameterName	language config parameter name
int	$iShopId	shop id

Returns: array

Definition at line 1297 of file oxlang.php.

oxLang::_getDisabledModuleInfo ( )

protected

Returns active module Ids with paths

Returns: array

Definition at line 1199 of file oxlang.php.

oxLang::_getLangFileCacheName	(	$blAdmin,
		$iLang,
		$aLangFiles = `null`
	)

protected

Returns language cache file name

Parameters

bool	$blAdmin	admin or not
int	$iLang	current language id
array	$aLangFiles	language files to load [optional]

Returns: string

Definition at line 852 of file oxlang.php.

oxLang::_getLangFilesPathArray ( $iLang )

protected

Returns array with paths where frontend language files are stored

Parameters

int $iLang active language

Returns: array

Definition at line 675 of file oxlang.php.

oxLang::_getLangTranslationArray	(	$iLang = `null`,
		$blAdmin = `null`,
		$aLangFiles = `null`
	)

protected

get language array from lang translation file

Parameters

int	$iLang	optional language
bool	$blAdmin	admin mode switch
array	$aLangFiles	language files to load [optional]

Returns: array

Definition at line 992 of file oxlang.php.

oxLang::_getLanguageFileData	(	$blAdmin = `false`,
		$iLang = `0`,
		$aLangFiles = `null`
	)

protected

Returns language cache array

Parameters

bool	$blAdmin	admin or not [optional]
int	$iLang	current language id [optional]
array	$aLangFiles	language files to load [optional]

Returns: array

Definition at line 872 of file oxlang.php.

oxLang::_getLanguageIdsFromDatabase ( $iShopId = null )

protected

Gets language Ids for given shopId or for all subshops

Parameters

null $iShopId

Returns: array

Definition at line 1281 of file oxlang.php.

oxLang::_getLanguageIdsFromLanguageParamsArray ( $aLanguageParams )

protected

gets language code array from aLanguageParams array

Parameters

array $aLanguageParams Language parameters

Returns: array

Definition at line 1351 of file oxlang.php.

oxLang::_getLanguageIdsFromLanguagesArray ( $aLanguages )

protected

gets language code array from aLanguages array

Parameters

array $aLanguages Languages

Returns: array

Definition at line 1369 of file oxlang.php.

oxLang::_getLanguageMap	(	$iLang,
		$blAdmin = `null`
	)

protected

Returns language map array

Parameters

int	$iLang	language index
bool	$blAdmin	admin mode [default NULL]

Returns: array

Definition at line 934 of file oxlang.php.

oxLang::_recodeLangArray	(	$aLangArray,
		$sCharset,
		$blRecodeKeys = `false`
	)

protected

Goes through language array and recodes its values if encoding does not fit with needed one. Returns recoded data

Parameters

array	$aLangArray	language data
string	$sCharset	charset which was used while making file
bool	$blRecodeKeys	leave keys untouched or recode it

Returns: array

Definition at line 629 of file oxlang.php.

oxLang::_selectLanguageParamValues	(	$sParamName,
		$sShopId = `null`
	)

protected

Returns array of all config values of given paramName

Parameters

string	$sParamName	Parameter name
string \| null	$sShopId	Shop id

Returns: array

Definition at line 1326 of file oxlang.php.

oxLang::_sortLanguagesCallback	(	$a1,
		$a2
	)

protected

Language sorting callback function

Parameters

object	$a1	first value to check
object	$a2	second value to check

Returns: bool

Definition at line 1022 of file oxlang.php.

oxLang::detectLanguageByBrowser ( )

Detect language by user browser settings. Returns language ID if detected, otherwise returns null.

Returns: int

Definition at line 1117 of file oxlang.php.

oxLang::formatCurrency	(	$dValue,
		$oActCur = `null`
	)

Returns formatted number, according to active currency formatting standards.

Parameters

float	$dValue	Plain price
object	$oActCur	Object of active currency

Returns: string

Definition at line 499 of file oxlang.php.

oxLang::formatVat	(	$dValue,
		$oActCur = `null`
	)

Returns formatted vat value, according to formatting standards.

Parameters

float	$dValue	Plain price
object	$oActCur	Object of active currency

Returns: string

Definition at line 517 of file oxlang.php.

oxLang::getActiveShopLanguageIds ( )

Returns available language IDs (abbreviations)

Returns: array

Definition at line 1259 of file oxlang.php.

oxLang::getAdminTplLanguageArray ( )

Returns languages array containing possible admin template translations

Returns: array

Definition at line 334 of file oxlang.php.

oxLang::getAllShopLanguageIds ( )

Returns available language IDs (abbreviations) for all sub shops

Returns: array

Definition at line 1229 of file oxlang.php.

oxLang::getBaseLanguage ( )

Returns active shop language id

Returns: string

Definition at line 135 of file oxlang.php.

oxLang::getEditLanguage ( )

Returns editing object working language id

Returns: string

Definition at line 240 of file oxlang.php.

oxLang::getFormLang ( )

Returns form hidden language parameter

Returns: string

Definition at line 1042 of file oxlang.php.

oxLang::getLanguageAbbr ( $iLanguage = null )

Returns selected language abbreviation

Parameters

int $iLanguage language id [optional]

Returns: string

Definition at line 364 of file oxlang.php.

oxLang::getLanguageArray	(	$iLanguage = `null`,
		$blOnlyActive = `false`,
		$blSort = `false`
	)

Returns array of available languages.

Parameters

integer	$iLanguage	Number if current language (default null)
bool	$blOnlyActive	load only current language or all
bool	$blSort	enable sorting or not

Returns: array

Definition at line 278 of file oxlang.php.

oxLang::getLanguageIds ( $iShopId = null )

Get current Shop language ids.

Parameters

int $iShopId shop id

Returns: array

Definition at line 1243 of file oxlang.php.

oxLang::getLanguageNames ( )

getLanguageNames returns array of language names e.g. array('Deutch', 'English')

public

Returns: array

Definition at line 384 of file oxlang.php.

oxLang::getLanguageTag ( $iLanguage = null )

According to user configuration forms and return language prefix.

Parameters

integer $iLanguage User selected language (default null)

Returns: string

Definition at line 540 of file oxlang.php.

oxLang::getMultiLangTables ( )

Returns all multi language tables

Returns: array

Definition at line 1137 of file oxlang.php.

oxLang::getName ( )

Returns language id param name

Returns: string

Definition at line 1032 of file oxlang.php.

oxLang::getObjectTplLanguage ( )

Returns language id used to load objects according to current template language

Returns: int

Definition at line 203 of file oxlang.php.

oxLang::getSeoReplaceChars ( $iLang )

Get SEO spec. chars replacement list for current language

Parameters

int $iLang language ID

Returns: null

Definition at line 1168 of file oxlang.php.

oxLang::getSimilarByKey	(	$sKey,
		$iLang = `null`,
		$blAdmin = `null`
	)

Returns array( "MY_TRANSLATION_KEY" => "MY_TRANSLATION_VALUE", ... ) by given filter "MY_TRANSLATION_" from language files

Parameters

string	$sKey	key to look
int	$iLang	language files to search [optional]
bool	$blAdmin	admin/non admin mode [optional]

Returns: array

Definition at line 465 of file oxlang.php.

oxLang::getTplLanguage ( )

Returns active shop templates language id If it is not an admin area, template language id is same as base shop language id

Returns: string

Definition at line 225 of file oxlang.php.

oxLang::getTranslationsExpectedEncoding ( )

protected

Returns the encoding all translations will be converted to.

Returns: string

Definition at line 656 of file oxlang.php.

oxLang::getUrlLang ( $iLang = null )

Returns url language parameter

Parameters

int $iLang language id [optional]

Returns: string

Definition at line 1059 of file oxlang.php.

oxLang::isTranslated ( )

Set translation state

Returns: bool

Definition at line 115 of file oxlang.php.

oxLang::processUrl	(	$sUrl,
		$iLang = `null`
	)

Is needed appends url with language parameter Direct usage of this method to retrieve end url result is discouraged - instead see oxUtilsUrl::processUrl

Parameters

string	$sUrl	url to process
int	$iLang	language id [optional]

See Also: oxUtilsUrl::processUrl

Returns: string

Definition at line 1082 of file oxlang.php.

oxLang::resetBaseLanguage ( )

resetBaseLanguage resets base language id cache

public

Definition at line 125 of file oxlang.php.

oxLang::setBaseLanguage ( $iLang = null )

Set base shop language

Parameters

int $iLang Language id

Definition at line 579 of file oxlang.php.

oxLang::setIsTranslated ( $blIsTranslated = true )

Set translation state

Parameters

bool $blIsTranslated State is string translated or not. Default true.

Definition at line 105 of file oxlang.php.

oxLang::setTplLanguage ( $iLang = null )

Validates and sets templates language id

Parameters

int $iLang Language id

Returns: null

Definition at line 601 of file oxlang.php.

oxLang::translateString	(	$sStringToTranslate,
		$iLang = `null`,
		$blAdminMode = `null`
	)

Searches for translation string in file and on success returns translation, otherwise returns initial string.

Parameters

string	$sStringToTranslate	Initial string
int	$iLang	optional language number
bool	$blAdminMode	on special case you can force mode, to load language constant from admin/shops language file

Returns: string

Definition at line 406 of file oxlang.php.

oxLang::validateLanguage ( $iLang = null )

Validate language id. If not valid id, returns default value

Parameters

int $iLang Language id

Returns: int

Definition at line 558 of file oxlang.php.

Member Data Documentation

oxLang::$_aActiveModuleInfo = null

protected

Definition at line 77 of file oxlang.php.

oxLang::$_aAdditionalLangFiles = array()

protected

Definition at line 63 of file oxlang.php.

oxLang::$_aAdminTplLanguageArray = null

protected

Definition at line 49 of file oxlang.php.

oxLang::$_aDisabledModuleInfo = null

protected

Definition at line 84 of file oxlang.php.

oxLang::$_aLangAbbr = null

protected

Definition at line 56 of file oxlang.php.

oxLang::$_aLangCache = array()

protected

Definition at line 42 of file oxlang.php.

oxLang::$_aLangMap = array()

protected

Definition at line 70 of file oxlang.php.

oxLang::$_blIsTranslated = true

protected

Definition at line 91 of file oxlang.php.

oxLang::$_iBaseLanguageId = null

protected

Definition at line 21 of file oxlang.php.

oxLang::$_iEditLanguageId = null

protected

Definition at line 35 of file oxlang.php.

oxLang::$_iObjectTplLanguageId = null

protected

Definition at line 98 of file oxlang.php.

oxLang::$_iTplLanguageId = null

protected

Definition at line 28 of file oxlang.php.

oxLang::$_sName = 'lang'

protected

Definition at line 14 of file oxlang.php.

The documentation for this class was generated from the following file:

core/oxlang.php

Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Member Function Documentation

Member Data Documentation