Docs For Class Translation2

Translation2 Translation2(
)

Constructor

[ Top ]

object Translation2 &factory(
string
$driver, [mixed
$options = ''], [array
$params = array()])

Return a Translation2 instance already initialized

Return: instance or PEAR_Error on failure

Overridden in child classes as:

Translation2_Admin::factory(): Return a Translation2_Admin instance already initialized

Parameters:

string	`$driver`	—	Type of the storage driver
mixed	`$options`	—	Additional options for the storage driver (example: if you are using DB as the storage driver, you have to pass the dsn string here)
array	`$params`	—	Array of parameters for the adapter class (i.e. you can set here the mappings between your table/field names and the ones used by this class)

[ Top ]

string get(
string
$stringID, [string
$pageID = TRANSLATION2_DEFAULT_PAGEID], [string
$langID = null], [string
$defaultText = ''])

Get translated string

First check if the string is cached, if not => fetch the page from the container and cache it for later use. If the string is empty, check the fallback language; if the latter is empty too, then return the $defaultText.

Overridden in child classes as:

Translation2_Decorator::get(): Get translated string

Translation2_Decorator_Iconv::get(): Get the translated string, in the new encoding

Translation2_Decorator_DefaultText::get(): Get translated string

Translation2_Decorator_CacheMemory::get(): Get translated string

Translation2_Decorator_Lang::get(): Get translated string

Translation2_Decorator_ErrorText::get(): Get translated string

Translation2_Decorator_UTF8::get(): Get translated string

Translation2_Decorator_SpecialChars::get(): Get translated string

Translation2_Decorator_CacheLiteFunction::get(): Get translated string

Translation2_Admin_Decorator_Autoadd::get(): Get a translated string

Parameters:

string	`$stringID`	—	ID of the string
string	`$pageID`	—	ID of the page/group containing the string
string	`$langID`	—	ID of the language
string	`$defaultText`	—	Text to display when the string is empty NB: This parameter is only used in the DefaultText decorator

[ Top ]

object Decorator &getDecorator(
string
$decorator)

Return an instance of a decorator

This method is used to get a decorator instance. A decorator can be seen as a filter, i.e. something that can change or handle the values of the objects/vars that pass through.

Return: object reference

Overridden in child classes as:

Translation2_Decorator::getDecorator(): Return an instance of a decorator

Parameters:

string $decorator — Name of the decorator

[ Top ]

mixed getLang(
[string
$langID = null], [string
$format = 'name'])

get lang info

Get some extra information about the language (its full name, the localized error text, ...)

Return: [string | array], depending on $format

Overridden in child classes as:

Translation2_Decorator::getLang(): Get language info

Translation2_Decorator_CacheLiteFunction::getLang(): get lang info

Parameters:

string	`$langID`	—	language ID
string	`$format`	—	['name', 'meta', 'error_text', 'array']

[ Top ]

array|PEAR_Error getLangs(
[string
$format = 'name'])

get langs

Get some extra information about the languages (their full names, the localized error text, their codes, ...)

Overridden in child classes as:

Translation2_Decorator::getLangs(): Get languages

Translation2_Decorator_CacheLiteFunction::getLangs(): get langs

Parameters:

string $format — ['ids', 'names', 'array']

[ Top ]

array getPage(
[string
$pageID = TRANSLATION2_DEFAULT_PAGEID], [string
$langID = null])

Get an entire group of strings

Same as getRawPage, but resort to fallback language and replace parameters when needed

Overridden in child classes as:

Translation2_Decorator::getPage(): Same as getRawPage, but resort to fallback language and replace parameters when needed

Translation2_Decorator_Iconv::getPage(): Same as getRawPage, but apply transformations when needed

Translation2_Decorator_DefaultText::getPage(): Replace empty strings with their $stringID

Translation2_Decorator_CacheMemory::getPage(): Same as getRawPage, but resort to fallback language and replace parameters when needed

Translation2_Decorator_Lang::getPage(): Same as getRawPage, but resort to fallback language and replace parameters when needed

Translation2_Decorator_ErrorText::getPage(): Same as getRawPage, but resort to fallback language and replace parameters when needed

Translation2_Decorator_UTF8::getPage(): Same as getRawPage, but resort to fallback language and replace parameters when needed

Translation2_Decorator_SpecialChars::getPage(): Same as getRawPage, but apply transformations when needed

Translation2_Decorator_CacheLiteFunction::getPage(): Same as getRawPage, but resort to fallback language and replace parameters when needed

Parameters:

string	`$pageID`	—	ID of the page/group containing the string
string	`$langID`	—	ID of the language

[ Top ]

string|PEAR_Error getRaw(
string
$stringID, [string
$pageID = TRANSLATION2_DEFAULT_PAGEID], [string
$langID = null], [string
$defaultText = ''])

Get translated string (as-is)

Overridden in child classes as:

Translation2_Decorator::getRaw(): Get translated string

Translation2_Decorator_CacheMemory::getRaw(): Get translated string (as-is)

Translation2_Decorator_CacheLiteFunction::getRaw(): Get translated string (as-is)

Parameters:

string	`$stringID`	—	ID of the string to be translated
string	`$pageID`	—	ID of the page/group containing the string
string	`$langID`	—	ID of the language
string	`$defaultText`	—	Text to display when the string is empty

[ Top ]

array getRawPage(
[string
$pageID = TRANSLATION2_DEFAULT_PAGEID], [string
$langID = null])

Get the array of strings in a page

Fetch the page (aka "group of strings) from the container, without applying any formatting and without replacing the parameters

Overridden in child classes as:

Translation2_Decorator::getRawPage(): Get the array of strings in a page

Translation2_Decorator_CacheMemory::getRawPage(): Get the array of strings in a page

Translation2_Decorator_CacheLiteFunction::getRawPage(): Get the array of strings in a page

Parameters:

string	`$pageID`	—	ID of the page/group containing the string
string	`$langID`	—	ID of the language

[ Top ]

string getStringID(
string
$string, [string
$pageID = TRANSLATION2_DEFAULT_PAGEID])

Get the stringID for the given string. This method is the reverse of get().

Overridden in child classes as:

Translation2_Decorator::getStringID(): Get the stringID for the given string. This method is the reverse of get().

Translation2_Decorator_DefaultText::getStringID(): Get the stringID for the given string. This method is the reverse of get().

Translation2_Decorator_CacheLiteFunction::getStringID(): Get translated string

Parameters:

string	`$string`	—	This is NOT the stringID, this is a real string. The method will search for its matching stringID, and then it will return the associate string in the selected language.
string	`$pageID`	—	ID of the page/group containing the string

[ Top ]

array replaceEmptyStringsWithKeys(
array
$strings)

Replace empty strings with their stringID

Overridden in child classes as:

Translation2_Decorator::replaceEmptyStringsWithKeys(): Replace empty strings with their stringID

Parameters:

array $strings — array of strings to be replaced if empty

[ Top ]

void|PEAR_Error setCharset(
string
$charset)

Set charset used to read/store the translations

Overridden in child classes as:

Translation2_Decorator::setCharset(): Set charset used to read/store the translations

Parameters:

string $charset — character set (encoding)

[ Top ]

void setContainerOptions(
array
$options)

Set some storage driver options

Access: protected

Overridden in child classes as:

Translation2_Decorator::setContainerOptions(): Set some storage driver options

Parameters:

array $options — array of options

[ Top ]

true|PEAR_Error setLang(
string
$langID)

Set default lang

Set the language that shall be used when retrieving strings.

Overridden in child classes as:

Translation2_Decorator::setLang(): Set default language

Translation2_Decorator_CacheLiteFunction::setLang(): Set default lang

Parameters:

string $langID — language code (for instance, 'en' or 'it')

[ Top ]

self setPageID(
[string
$pageID = null])

Set default page

Set the page (aka "group of strings") that shall be used when retrieving strings. If you set it, you don't have to state it in each get() call.

Overridden in child classes as:

Translation2_Decorator::setPageID(): Set default page

Parameters:

string $pageID — ID of the default page

[ Top ]

self setParams(
[array
$params = null])

Set parameters for next string

Set the replacement for the parameters in the string(s). Parameter delimiters are customizable.

Overridden in child classes as:

Translation2_Decorator::setParams(): Set parameters for next string

Parameters:

array $params — array of replacement parameters

[ Top ]

mixed _replaceParams(
mixed
$strings)

Replace parameters in strings

Access: protected

Overridden in child classes as:

Translation2_Decorator::_replaceParams(): Replace parameters in strings

Parameters:

mixed $strings — strings where the replacements must occur

[ Top ]

void __clone(
)

Clone internal object references

This method is called automatically by PHP5

Access: protected

Overridden in child classes as:

Translation2_Decorator::__clone(): Clone internal object references

[ Top ]

Class: Translation2

Class Overview

Author(s):

Copyright:

Variables

Methods

Child classes:

Inherited Variables

Inherited Methods

Class Details

Class Variables

$currentPageID = null

$lang = array()

$options = array()

$params = array()

$storage = ''

Method Detail

Translation2 (Constructor) [line 125]

factory [line 151]

Parameters:

get [line 512]

Parameters:

getDecorator [line 257]

Parameters:

getLang [line 344]

Parameters:

getLangs [line 380]

Parameters:

getPage [line 555]

Parameters:

getRaw [line 483]

Parameters:

getRawPage [line 535]

Parameters:

getStringID [line 574]

Parameters:

replaceEmptyStringsWithKeys [line 457]

Parameters:

setCharset [line 281]

Parameters:

setContainerOptions [line 201]

Parameters:

setLang [line 301]

Parameters:

setPageID [line 324]

Parameters:

setParams [line 398]

Parameters:

_replaceParams [line 421]

Parameters:

__clone [line 591]