PHP Class I18n

This file is part of AgenDAV. AgenDAV is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version. AgenDAV is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with AgenDAV. If not, see .
Inheritance: extends CI_Model
Afficher le fichier Open project: baserproject/basercms Class Usage Examples

Méthodes publiques

Свойство Type Description
$category string Current category of translation
$defaultDomain string Default domain of translation
$domain string Current domain of translation
$l10n L10n Instance of the L10n class for localization

Protected Properties

Свойство Type Description
$_categories array Translation categories
$_domains array Translation strings for a specific domain read from the .mo or .po files
$_escape string Escape string
$_lang string Current language used for translations
$_noLocale boolean If a translation file is found it is set to false again

Méthodes publiques

Méthode Description
__construct ( ) Constructor, use I18n::getInstance() to get the i18n translation object.
clear ( ) : void Clears the domains internal data array. Useful for testing i18n.
domains ( ) : array Get the loaded domains cache.
getInstance ( ) : I18n Return a static instance of the I18n class
insertArgs ( string $translated, array $args ) : string Puts the parameters in raw translated strings
loadLocaleDefinition ( string $filename ) : mixed Parses a locale definition file following the POSIX standard
loadMo ( string $filename ) : mixed Loads the binary .mo file and returns array of translations
loadPo ( string $filename ) : mixed Loads the text .po file and returns array of translations
translate ( string $singular, string $plural = null, string $domain = null, string $category = self::LC_MESSAGES, integer $count = null, string $language = null, string $context = null ) : string Used by the translation functions in basics.php Returns a translated string based on current language and translation files stored in locale folder

Méthodes protégées

Méthode Description
_bindTextDomain ( string $domain ) : string Binds the given domain to a file in the specified directory.
_parseLiteralValue ( string $string ) : string Auxiliary function to parse a symbol from a locale definition file
_pluralGuess ( string $header, integer $n ) : integer Attempts to find the plural form of a string.
_translateTime ( string $format, string $domain ) : mixed Returns a Time format definition from corresponding domain

Method Details

__construct() public méthode

Constructor, use I18n::getInstance() to get the i18n translation object.
public __construct ( )

_bindTextDomain() protected méthode

Binds the given domain to a file in the specified directory.
protected _bindTextDomain ( string $domain ) : string
$domain string Domain to bind
Résultat string Domain binded

_parseLiteralValue() protected méthode

Auxiliary function to parse a symbol from a locale definition file
protected _parseLiteralValue ( string $string ) : string
$string string Symbol to be parsed
Résultat string parsed symbol

_pluralGuess() protected méthode

Attempts to find the plural form of a string.
See link: http://localization-guide.readthedocs.org/en/latest/l10n/pluralforms.html
See link: https://developer.mozilla.org/en-US/docs/Mozilla/Localization/Localization_and_Plurals#List_of_Plural_Rules
protected _pluralGuess ( string $header, integer $n ) : integer
$header string Type
$n integer Number
Résultat integer plural match

_translateTime() protected méthode

Returns a Time format definition from corresponding domain
protected _translateTime ( string $format, string $domain ) : mixed
$format string Format to be translated
$domain string Domain where format is stored
Résultat mixed translated format string if only value or array of translated strings for corresponding format.

clear() public static méthode

Clears the domains internal data array. Useful for testing i18n.
public static clear ( ) : void
Résultat void

domains() public static méthode

Get the loaded domains cache.
public static domains ( ) : array
Résultat array

getInstance() public static méthode

Return a static instance of the I18n class
public static getInstance ( ) : I18n
Résultat I18n

insertArgs() public static méthode

Puts the parameters in raw translated strings
public static insertArgs ( string $translated, array $args ) : string
$translated string The raw translated string
$args array The arguments to put in the translation
Résultat string Translated string with arguments

loadLocaleDefinition() public static méthode

Parses a locale definition file following the POSIX standard
public static loadLocaleDefinition ( string $filename ) : mixed
$filename string Locale definition filename
Résultat mixed Array of definitions on success or false on failure

loadMo() public static méthode

Loads the binary .mo file and returns array of translations
See link: https://www.gnu.org/software/gettext/manual/html_node/MO-Files.html
public static loadMo ( string $filename ) : mixed
$filename string Binary .mo file to load
Résultat mixed Array of translations on success or false on failure

loadPo() public static méthode

Loads the text .po file and returns array of translations
public static loadPo ( string $filename ) : mixed
$filename string Text .po file to load
Résultat mixed Array of translations on success or false on failure

translate() public static méthode

Used by the translation functions in basics.php Returns a translated string based on current language and translation files stored in locale folder
public static translate ( string $singular, string $plural = null, string $domain = null, string $category = self::LC_MESSAGES, integer $count = null, string $language = null, string $context = null ) : string
$singular string String to translate
$plural string Plural string (if any)
$domain string Domain The domain of the translation. Domains are often used by plugin translations. If null, the default domain will be used.
$category string Category The integer value of the category to use.
$count integer Count Count is used with $plural to choose the correct plural form.
$language string Language to translate string to. If null it checks for language in session followed by Config.language configuration variable.
$context string Context The context of the translation, e.g a verb or a noun.
Résultat string translated string.

Property Details

$_categories protected_oe property

Translation categories
protected array $_categories
Résultat array

$_domains protected_oe property

Translation strings for a specific domain read from the .mo or .po files
protected array $_domains
Résultat array

$_escape protected_oe property

Escape string
protected string $_escape
Résultat string

$_lang protected_oe property

Current language used for translations
protected string $_lang
Résultat string

$_noLocale protected_oe property

If a translation file is found it is set to false again
protected bool $_noLocale
Résultat boolean

$category public_oe property

Current category of translation
public string $category
Résultat string

$defaultDomain public_oe static_oe property

Default domain of translation
public static string $defaultDomain
Résultat string

$domain public_oe property

Current domain of translation
public string $domain
Résultat string

$l10n public_oe property

Instance of the L10n class for localization
public L10n $l10n
Résultat L10n