Docs For Class Translation2

Translation2 (Constructor) [line 96]

Translation2 Translation2(
)

Constructor

[ Top ]

factory [line 122]

object Translation2 &factory(

$driver, [mixed
$options = ''], [array
$params = array()], string
$storageDriver)

Return a Translation2 instance already initialized

Return: instance or PEAR_Error on failure
Access: public

Overridden in child classes as:

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

Parameters:

string	`$storageDriver`	—	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)
	`$driver`	—

[ Top ]

get [line 400]

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.

Parameters:

string	`$stringID`	—
string	`$pageID`	—
string	`$langID`	—
string	`$defaultText`	—	Text to display when the strings in both the default and the fallback lang are empty

[ Top ]

getDecorator [line 210]

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
Access: public

Parameters:

string $decorator — Name of the decorator

[ Top ]

getLang [line 271]

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

Parameters:

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

[ Top ]

getLangs [line 300]

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

get langs

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

Parameters:

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

[ Top ]

getPage [line 442]

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

Get an entire group of strings

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

Parameters:

string	`$pageID`	—
string	`$langID`	—
	`$defaultText`	—

[ Top ]

getRawPage [line 423]

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

Parameters:

string	`$pageID`	—
string	`$langID`	—

[ Top ]

getStringID [line 460]

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

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

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`	—

[ Top ]

replaceEmptyStringsWithKeys [line 369]

void replaceEmptyStringsWithKeys(

$strings, mixed
$params)

Replace empty strings with their stringID

Access: public

Parameters:

mixed	`$params`	—
	`$strings`	—

[ Top ]

setLang [line 233]

void setLang(
string
$langID)

Set default lang

Set the language that shall be used when retrieving strings.

Parameters:

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

[ Top ]

setPageID [line 253]

void setPageID(
[
$pageID = null], string
$langID)

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.

Parameters:

string	`$langID`	—
	`$pageID`	—

[ Top ]

setParams [line 316]

void setParams(
[array
$params = null])

Set parameters for next string

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

Parameters:

array $params —

[ Top ]

_replaceParams [line 335]

void _replaceParams(

$strings, mixed
$params)

Replace parameters in strings

Access: protected

Parameters:

mixed	`$params`	—
	`$strings`	—

[ Top ]

Class: Translation2

Class Overview

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 96]

factory [line 122]

Parameters:

get [line 400]

Parameters:

getDecorator [line 210]

Parameters:

getLang [line 271]

Parameters:

getLangs [line 300]

Parameters:

getPage [line 442]

Parameters:

getRawPage [line 423]

Parameters:

getStringID [line 460]

Parameters:

replaceEmptyStringsWithKeys [line 369]

Parameters:

setLang [line 233]

Parameters:

setPageID [line 253]

Parameters:

setParams [line 316]

Parameters:

_replaceParams [line 335]

Parameters: