Language

Languages/translation handler class

since

1.0

Methods

_

Translate function, mimics the php gettext (alias _) function.

_(string $string, boolean $jsSafe = false, boolean $interpretBackSlashes = true) : string

The function checks if $jsSafe is true, then if $interpretBackslashes is true.

since

1.0

Arguments

$string

stringThe string to translate

$jsSafe

booleanMake the result javascript safe

$interpretBackSlashes

booleanInterpret \t and \n

Response

stringThe translation of the string

__construct

Constructor activating the default information of the language.

__construct(string $lang = null, boolean $debug = false) 
since

1.0

Arguments

$lang

stringThe language

$debug

booleanIndicates if language debugging is enabled.

exists

Checks if a language exists.

exists(string $lang, string $basePath = JPATH_ROOT) : boolean
static

This is a simple, quick check for the directory that should contain language files for the given user.

since

1.0

Arguments

$lang

stringLanguage to check.

$basePath

stringOptional path to check.

Response

booleanTrue if the language exists.

get

Get a metadata language property.

get(string $property, mixed $default = null) : mixed
since

1.0

Arguments

$property

stringThe name of the property.

$default

mixedThe default value.

Response

mixedThe value of the property.

getCallerInfo

Determine who called Language or Text.

getCallerInfo() : array
since

1.0

Response

arrayCaller information.

getDebug

Get the Debug property.

getDebug() : boolean
since

1.0

Response

booleanTrue is in debug mode.

getDefault

Get the default language code.

getDefault() : string
since

1.0

Response

stringLanguage code.

getErrorFiles

Get a list of language files that are in error state.

getErrorFiles() : array
since

1.0

Response

array

getFirstDay

Get the first day of the week for this language.

getFirstDay() : integer
since

1.0

Response

integerThe first day of the week according to the language

getIgnoredSearchWords

Returns an array of ignored search words

getIgnoredSearchWords() : array
deprecated
since

1.0

deprecated

2.0

Response

arrayThe array of ignored search words.

getIgnoredSearchWordsCallback

Getter for ignoredSearchWordsCallback function.

getIgnoredSearchWordsCallback() : callable
deprecated
since

1.0

deprecated

2.0

Response

callableFunction name or the actual function.

getInstance

Returns a language object.

getInstance(string $lang = null, boolean $debug = false) : \Joomla\Language\Language
static deprecated
since

1.0

deprecated

2.0 Use LanguageFactory::getLanguage() instead

Arguments

$lang

stringThe language to use.

$debug

booleanThe debug mode.

Response

\Joomla\Language\LanguageThe Language object.

getKnownLanguages

Returns a list of known languages for an area

getKnownLanguages(string $basePath = JPATH_ROOT) : array
static
since

1.0

Arguments

$basePath

stringThe basepath to use

Response

arraykey/value pair with the language file and real name.

getLanguage

Get the current language code.

getLanguage() : string
since

1.0

Response

stringThe language code

getLanguagePath

Get the path to a language

getLanguagePath(string $basePath = JPATH_ROOT, string $language = null) : string
static
since

1.0

Arguments

$basePath

stringThe basepath to use.

$language

stringThe language tag.

Response

stringlanguage related path or null.

getLocale

Get the language locale based on current language.

getLocale() : array
since

1.0

Response

arrayThe locale according to the language.

getLowerLimitSearchWord

Returns a lower limit integer for length of search words

getLowerLimitSearchWord() : integer
deprecated
since

1.0

deprecated

2.0

Response

integerThe lower limit integer for length of search words (3 if no value was set for a specific language).

getLowerLimitSearchWordCallback

Getter for lowerLimitSearchWordCallback function

getLowerLimitSearchWordCallback() : callable
deprecated
since

1.0

deprecated

2.0

Response

callableFunction name or the actual function.

getMetadata

Returns a associative array holding the metadata.

getMetadata(string $lang) : mixed
static
since

1.0

Arguments

$lang

stringThe name of the language.

Response

mixedIf $lang exists return key/value pair with the language metadata, otherwise return NULL.

getName

Getter for Name.

getName() : string
since

1.0

Response

stringOfficial name element of the language.

getOrphans

Get the list of orphaned strings if being tracked.

getOrphans() : array
since

1.0

Response

arrayOrphaned text.

getPaths

Get a list of language files that have been loaded.

getPaths(string $extension = null) : array
since

1.0

Arguments

$extension

stringAn optional extension name.

Response

array

getPluralSuffixes

Returns an array of suffixes for plural rules.

getPluralSuffixes(integer $count) : array
since

1.0

Arguments

$count

integerThe count number the rule is for.

Response

arrayThe array of suffixes.

getPluralSuffixesCallback

Getter for pluralSuffixesCallback function.

getPluralSuffixesCallback() : callable
deprecated
since

1.0

deprecated

2.0

Response

callableFunction name or the actual function.

getSearchDisplayedCharactersNumber

Returns the number of characters displayed in search results.

getSearchDisplayedCharactersNumber() : integer
deprecated
since

1.0

deprecated

2.0

Response

integerThe number of characters displayed (200 if no value was set for a specific language).

getSearchDisplayedCharactersNumberCallback

Getter for searchDisplayedCharactersNumberCallback function

getSearchDisplayedCharactersNumberCallback() : callable
deprecated
since

1.0

deprecated

2.0

Response

callableFunction name or the actual function.

getTag

Getter for the language tag (as defined in RFC 3066)

getTag() : string
since

1.0

Response

stringThe language tag.

getTransliterator

Getter for transliteration function

getTransliterator() : callable
deprecated
since

1.0

deprecated

2.0

Response

callableThe transliterator function

getUpperLimitSearchWord

Returns an upper limit integer for length of search words

getUpperLimitSearchWord() : integer
deprecated
since

1.0

deprecated

2.0

Response

integerThe upper limit integer for length of search words (20 if no value was set for a specific language).

getUpperLimitSearchWordCallback

Getter for upperLimitSearchWordCallback function

getUpperLimitSearchWordCallback() : callable
deprecated
since

1.0

deprecated

2.0

Response

callableFunction name or the actual function.

getUsed

Get the list of used strings.

getUsed() : array

Used strings are those strings requested and found either as a string or a constant.

since

1.0

Response

arrayUsed strings.

hasKey

Determines is a key exists.

hasKey(string $string) : boolean
since

1.0

Arguments

$string

stringThe key to check.

Response

booleanTrue, if the key exists.

isRtl

Get the RTL property.

isRtl() : boolean
since

1.0

Response

booleanTrue is it an RTL language.

load

Loads a single language file and appends the results to the existing strings

load(string $extension = 'joomla', string $basePath = JPATH_ROOT, string $lang = null, boolean $reload = false, boolean $default = true) : boolean
since

1.0

Arguments

$extension

stringThe extension for which a language file should be loaded.

$basePath

stringThe basepath to use.

$lang

stringThe language to load, default null for the current language.

$reload

booleanFlag that will force a language to be reloaded if set to true.

$default

booleanFlag that force the default language to be loaded if the current does not exist.

Response

booleanTrue if the file has successfully loaded.

loadLanguage

Loads a language file.

loadLanguage(string $filename, string $extension = 'unknown') : boolean

This method will not note the successful loading of a file - use load() instead.

see \Joomla\Language\Language::load()
since

1.0

Arguments

$filename

stringThe name of the file.

$extension

stringThe name of the extension.

Response

booleanTrue if new strings have been added to the language

parse

Parses a language file.

parse(string $filename) : array
since

1.0

note

As of 2.0, this method will no longer support parsing QQ into quotes

Arguments

$filename

stringThe name of the file.

Response

arrayThe array of parsed strings.

parseLanguageFiles

Searches for language directories within a certain base dir.

parseLanguageFiles(string $dir = null) : array
static
since

1.0

Arguments

$dir

stringdirectory of files.

Response

arrayArray holding the found languages as filename => real name pairs.

parseXmlLanguageFile

Parse XML file for language information.

parseXmlLanguageFile(string $path) : array
static
since

1.0

throws

\RuntimeException

Arguments

$path

stringPath to the XML files.

Response

arrayArray holding the found metadata as a key => value pair.

setDebug

Set the Debug property.

setDebug(boolean $debug) : boolean
since

1.0

Arguments

$debug

booleanThe debug setting.

Response

booleanPrevious value.

setDefault

Set the default language code.

setDefault(string $lang) : string
since

1.0

Arguments

$lang

stringThe language code.

Response

stringPrevious value.

setIgnoredSearchWordsCallback

Setter for the ignoredSearchWordsCallback function

setIgnoredSearchWordsCallback(callable $function) : callable
deprecated
since

1.0

deprecated

2.0

Arguments

$function

callableFunction name or actual function.

Response

callableThe previous function.

setLanguage

Set the language attributes to the given language.

setLanguage(string $lang) : string
deprecated

Once called, the language still needs to be loaded using Language::load().

since

1.0

deprecated

2.0

Arguments

$lang

stringLanguage code.

Response

stringPrevious value.

setLowerLimitSearchWordCallback

Setter for the lowerLimitSearchWordCallback function.

setLowerLimitSearchWordCallback(callable $function) : callable
deprecated
since

1.0

deprecated

2.0

Arguments

$function

callableFunction name or actual function.

Response

callableThe previous function.

setPluralSuffixesCallback

Set the pluralSuffixes function.

setPluralSuffixesCallback(callable $function) : callable
deprecated
since

1.0

deprecated

2.0 The plural suffix method must be set in a language's localise file.

Arguments

$function

callableFunction name or actual function.

Response

callableThe previous function.

setSearchDisplayedCharactersNumberCallback

Setter for the searchDisplayedCharactersNumberCallback function.

setSearchDisplayedCharactersNumberCallback(callable $function) : callable
deprecated
since

1.0

deprecated

2.0

Arguments

$function

callableFunction name or the actual function.

Response

callableThe previous function.

setTransliterator

Set the transliteration function.

setTransliterator(callable $function) : callable
deprecated
since

1.0

deprecated

2.0 The transliterator must be set in a language's localise file.

Arguments

$function

callableFunction name or the actual function.

Response

callableThe previous function.

setUpperLimitSearchWordCallback

Setter for the upperLimitSearchWordCallback function

setUpperLimitSearchWordCallback(callable $function) : callable
deprecated
since

1.0

deprecated

2.0

Arguments

$function

callableFunction name or the actual function.

Response

callableThe previous function.

transliterate

Transliterate function

transliterate(string $string) : string

This method processes a string and replaces all accented UTF-8 characters by unaccented ASCII-7 "equivalents".

since

1.0

throws

\RuntimeException

Arguments

$string

stringThe string to transliterate.

Response

stringThe transliteration of the string.

Properties

languages

Language instance container

static deprecated
since

1.0

deprecated

2.0

Type(s)

array

languageFactory

Cached LanguageFactory object

static deprecated
since

1.3.0

deprecated

2.0

Type(s)

\Joomla\Language\LanguageFactory

debug

Debug language, If true, highlights if string isn't found.

since

1.0

Type(s)

boolean

default

The default language, used when a language file in the requested language does not exist.

since

1.0

Type(s)

string

orphans

An array of orphaned text.

since

1.0

Type(s)

array

metadata

Array holding the language metadata.

since

1.0

Type(s)

array

locale

Array holding the language locale or boolean null if none.

since

1.0

Type(s)

array|boolean

lang

The language to load.

since

1.0

Type(s)

string

paths

A nested array of language files that have been loaded

since

1.0

Type(s)

array

errorfiles

List of language files that are in error state

since

1.0

Type(s)

array

strings

Translations

deprecated
since

1.0

deprecated

2.0

Type(s)

array

used

An array of used text, used during debugging.

since

1.0

Type(s)

array

counter

Counter for number of loads.

since

1.0

Type(s)

integer

override

An array used to store overrides.

since

1.0

Type(s)

array

transliterator

Name of the transliterator function for this language.

since

1.0

Type(s)

string

pluralSuffixesCallback

Name of the pluralSuffixesCallback function for this language.

since

1.0

Type(s)

callable

ignoredSearchWordsCallback

Name of the ignoredSearchWordsCallback function for this language.

since

1.0

Type(s)

callable

lowerLimitSearchWordCallback

Name of the lowerLimitSearchWordCallback function for this language.

since

1.0

Type(s)

callable

upperLimitSearchWordCallback

Name of the uppperLimitSearchWordCallback function for this language

since

1.0

Type(s)

callable

searchDisplayedCharactersNumberCallback

Name of the searchDisplayedCharactersNumberCallback function for this language.

since

1.0

Type(s)

callable