+ * @copyright 2004-2007 Lorenzo Alberton, Ian Eure
+ * @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
+ * @version CVS: $Id$
+ * @link http://pear.php.net/package/Translation2
+ */
+
+/**
+ * Load Translation2_Decorator class
+ */
+require_once 'Translation2/Admin/Decorator.php';
+
+/**
+ * Automatically add requested strings
+ *
+ * This Decorator will add strings to a language when a request for them to be
+ * translated happens. The 'autoaddlang' option must be set to the language the
+ * strings will be added as.
+ *
+ * Example:
+ *
+ * $tr =& Translation2_Admin::factory(...);
+ * $tr->setLang('en');
+ * $tr =& $tr->getAdminDecorator('Autoadd');
+ * $tr->setOption('autoaddlang', 'en');
+ * ...
+ * $tr->get('Entirely new string', 'samplePage', 'de');
+ *
+ *
+ * 'Entirely new string' will be added to the English language table.
+ *
+ * @category Internationalization
+ * @package Translation2
+ * @author Ian Eure
+ * @copyright 2004-2007 Ian Eure
+ * @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
+ * @link http://pear.php.net/package/Translation2
+ * @since 2.0.0beta3
+ */
+class Translation2_Admin_Decorator_Autoadd extends Translation2_Admin_Decorator
+{
+ /**
+ * Language to add strings in
+ *
+ * @var string
+ */
+ var $autoaddlang = '';
+
+ /**
+ * Get a translated string
+ *
+ * @param string $stringID string ID
+ * @param string $pageID page/group ID
+ * @param string $langID language ID
+ *
+ * @return string
+ * @see Translation2::get()
+ */
+ function get($stringID, $pageID = TRANSLATION2_DEFAULT_PAGEID, $langID = null)
+ {
+ $pageID = ($pageID == TRANSLATION2_DEFAULT_PAGEID ? $this->translation2->currentPageID : $pageID);
+ $string = $this->translation2->get($stringID, $pageID, $langID);
+ if (PEAR::isError($string)
+ || !strlen($string)
+ && !empty($this->autoaddlang)
+ && $langID == $this->autoaddlang) {
+ // Make sure we add a stub for all languages we know about.
+ $langs = array();
+ foreach ($this->translation2->getLangs('ids') as $lang) {
+ $langs[$lang] = '';
+ }
+ $langs[$this->autoaddlang] = $stringID;
+
+ // Add the string
+ $this->translation2->add($stringID, $pageID, $langs);
+ }
+ return $string;
+ }
+}
+?>
\ No newline at end of file
diff --git a/Container.php b/Translation2/Container.php
similarity index 100%
rename from Container.php
rename to Translation2/Container.php
diff --git a/Translation2/Container/dataobjectsimple.php b/Translation2/Container/dataobjectsimple.php
new file mode 100644
index 0000000..d1bac9f
--- /dev/null
+++ b/Translation2/Container/dataobjectsimple.php
@@ -0,0 +1,255 @@
+
+ * @copyright 2004-2008 Alan Knowles
+ * @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
+ * @version CVS: $Id$
+ * @link http://pear.php.net/package/Translation2
+ */
+
+/**
+ * require Translation2_Container class and DB_DataObjects
+ */
+require_once 'Translation2/Container.php';
+require_once 'DB/DataObject.php';
+
+/**
+ * Simple storage driver for fetching data from a db with DB_DataObject
+ *
+ * This storage driver can use all databases which are supported
+ * by the PEAR::DB abstraction layer to fetch data.
+ *
+ * Database Structure:
+ *
+ * // meta data etc. not supported yet...
+ *
+ * create table translations (
+ * id int(11) auto_increment not null primary key,
+ * string_id int(11),
+ * page varchar(128),
+ * lang varchar(10),
+ * translation text
+ * );
+ * alter table translations add index page (page);
+ * alter table translations add index lang (lang);
+ * alter table translations add index string_id (string_id);
+ *
+ *
+ * - then just run the dataobjects createtables script.
+ *
+ * @category Internationalization
+ * @package Translation2
+ * @author Alan Knowles
+ * @copyright 2004-2008 Alan Knowles
+ * @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
+ * @version CVS: $Id$
+ * @link http://pear.php.net/package/Translation2
+ */
+class Translation2_Container_dataobjectsimple extends Translation2_Container
+{
+ // {{{ init
+
+ /**
+ * Initialize the container
+ *
+ * @param string $table table name
+ *
+ * @return boolean true
+ */
+ function init($table = null)
+ {
+ $this->_setDefaultOptions();
+ if (!empty($table)) {
+ $this->options['table'] = $table;
+ }
+ return true;
+ }
+
+ // }}}
+ // {{{ _setDefaultOptions()
+
+ /**
+ * Set some default options
+ *
+ * @return void
+ * @access private
+ */
+ function _setDefaultOptions()
+ {
+ $this->options['table'] = 'translations';
+ }
+
+ // }}}
+ // {{{ fetchLangs()
+
+ /**
+ * Fetch the available langs if they're not cached yet.
+ *
+ * @return void
+ */
+ function fetchLangs()
+ {
+ $do = DB_DataObject::factory($this->options['table']);
+ $do->selectAdd();
+ $do->selectAdd('distinct lang');
+ $do->find();
+
+ $ret = array();
+ while ($do->fetch()) {
+ $l = $do->lang;
+ $ret[$l] = array(
+ 'id' => $l,
+ 'name' => $l,
+ 'meta' => '',
+ 'error_text' => '',
+ );
+ }
+ $this->langs = $ret;
+ }
+
+ // }}}
+ // {{{ getPage()
+
+ /**
+ * Returns an array of the strings in the selected page
+ *
+ * @param string $pageID page/group ID
+ * @param string $langID language ID
+ *
+ * @return array
+ */
+ function getPage($pageID = null, $langID = null)
+ {
+ $langID = $this->_getLangID($langID);
+ if (PEAR::isError($langID)) {
+ return $langID;
+ }
+
+ // First get the array of string IDs
+ $do = DB_DataObject::factory($this->options['table']);
+ $do->lang = '-';
+ $do->page = $pageID;
+ $do->find();
+
+ $stringIDs = array();
+ while ($do->fetch()) {
+ $stringIDs[$do->string_id] = $do->translation;
+ }
+
+ // Now get the array of strings
+ $do = DB_DataObject::factory($this->options['table']);
+ $do->page = $pageID;
+ $do->lang = $langID;
+
+ $do->find();
+ $translations = array();
+ while ($do->fetch()) {
+ $translations[$do->string_id] = $do->translation;
+ }
+
+ // Construct an associative array of stringIDs and translations
+ $strings = array();
+ foreach ($translations as $key => $value) {
+ $strings[$stringIDs[$key]] = $value;
+ }
+
+ return $strings;
+ }
+
+ // }}}
+ // {{{ getOne()
+
+ /**
+ * Get a single item from the container, without caching the whole page
+ *
+ * @param string $stringID string ID
+ * @param string $pageID page/group ID
+ * @param string $langID language ID
+ *
+ * @return string
+ */
+ function getOne($string, $pageID = null, $langID = null)
+ {
+ $langID = $langID ? $langID : (isset($this->currentLang['id']) ? $this->currentLang['id'] : '-');
+ // get the string id
+ $do = DB_DataObject::factory($this->options['table']);
+ $do->lang = '-';
+ $do->page = $pageID;
+ $do->translation = $string;
+ // we dont have the base language translation..
+ if (!$do->find(true)) {
+ return '';
+ }
+ $stringID = $do->string_id;
+
+ $do = DB_DataObject::factory($this->options['table']);
+ $do->lang = $langID;
+ $do->page = $pageID;
+ $do->string_id = $stringID;
+ //print_r($do);
+ $do->selectAdd();
+ $do->selectAdd('translation');
+ if (!$do->find(true)) {
+ return '';
+ }
+ return $do->translation;
+
+ }
+
+ // }}}
+ // {{{ getStringID()
+
+ /**
+ * Get the stringID for the given string
+ *
+ * @param string $string string
+ * @param string $pageID page/group ID
+ *
+ * @return string
+ */
+ function getStringID($string, $pageID = null)
+ {
+ // get the english version...
+
+ $do = DB_DataObject::factory($this->options['table']);
+ $do->lang = $this->currentLang['id'];
+ $do->page = $pageID;
+ $do->translation = $string;
+ if ($do->find(true)) {
+ return '';
+ }
+ return $do->string_id;
+ }
+
+ // }}}
+}
+?>
\ No newline at end of file
diff --git a/Translation2/Container/db.php b/Translation2/Container/db.php
new file mode 100644
index 0000000..8143023
--- /dev/null
+++ b/Translation2/Container/db.php
@@ -0,0 +1,359 @@
+
+ * @author Ian Eure
+ * @copyright 2004-2008 Lorenzo Alberton, Ian Eure
+ * @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
+ * @version CVS: $Id$
+ * @link http://pear.php.net/package/Translation2
+ */
+
+/**
+ * require Translation2_Container class
+ */
+require_once 'Translation2/Container.php';
+
+/**
+ * Storage driver for fetching data from a database
+ *
+ * This storage driver can use all databases which are supported
+ * by the PEAR::DB abstraction layer to fetch data.
+ *
+ * @category Internationalization
+ * @package Translation2
+ * @author Lorenzo Alberton
+ * @author Ian Eure
+ * @copyright 2004-2008 Lorenzo Alberton, Ian Eure
+ * @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
+ * @version CVS: $Id$
+ * @link http://pear.php.net/package/Translation2
+ */
+class Translation2_Container_db extends Translation2_Container
+{
+ // {{{ class vars
+
+ /**
+ * DB object
+ * @var object
+ */
+ var $db = null;
+
+ /**
+ * query counter
+ * @var integer
+ * @access private
+ */
+ var $_queries = 0;
+
+ // }}}
+ // {{{ init
+
+ /**
+ * Initialize the container
+ *
+ * @param mixed &$db string DSN or object DB instance
+ *
+ * @return boolean|PEAR_Error object if something went wrong
+ */
+ function init(&$db)
+ {
+ $this->_setDefaultOptions();
+ if (PEAR::isError($err = $this->_connect($db))) {
+ return $err;
+ }
+ return true;
+ }
+
+ // }}}
+ // {{{ _connect()
+
+ /**
+ * Connect to database by using the given DSN string
+ *
+ * @param mixed &$db string DSN or object DB instance
+ *
+ * @return boolean|PEAR_Error object if something went wrong
+ * @access private
+ */
+ function _connect(&$db)
+ {
+ if (is_object($db) && is_a($db, 'DB_Common')) {
+ // Passed an existing instance
+ $this->db =& $db;
+ } else if (is_string($db) || is_array($db)) {
+ // Passed a DSN
+ include_once 'DB.php';
+ $this->db =& DB::connect($db);
+ } else {
+ // Passed something invalid
+ return PEAR::raiseError('The given dsn was not valid in file '
+ . __FILE__ . ' at line ' . __LINE__,
+ TRANSLATION2_ERROR_CANNOT_CONNECT,
+ PEAR_ERROR_RETURN);
+ }
+
+ if (PEAR::isError($this->db)) {
+ return $this->db;
+ }
+ return true;
+ }
+
+ // }}}
+ // {{{ _setDefaultOptions()
+
+ /**
+ * Set some default options
+ *
+ * @access private
+ * @return void
+ */
+ function _setDefaultOptions()
+ {
+ $this->options['langs_avail_table'] = 'langs';
+ $this->options['lang_id_col'] = 'id';
+ $this->options['lang_name_col'] = 'name';
+ $this->options['lang_meta_col'] = 'meta';
+ $this->options['lang_errmsg_col'] = 'error_text';
+ $this->options['lang_encoding_col'] = 'encoding';
+
+ $this->options['strings_default_table'] = 'i18n';
+ $this->options['strings_tables'] = array(); // 'lang_id' => 'table_name'
+ $this->options['string_id_col'] = 'id';
+ $this->options['string_page_id_col'] = 'page_id';
+ $this->options['string_page_id_col_length'] = 50;
+ $this->options['string_text_col'] = '%s'; // col_name if one table per lang is used,
+ // or a pattern (i.e. "tr_%s" => "tr_EN_US")
+ }
+
+ // }}}
+ // {{{ setCharset()
+
+ /**
+ * Set charset used to read/store the translations
+ *
+ * @param string $charset character set (encoding)
+ *
+ * @return PEAR_Error on failure
+ */
+ function setCharset($charset)
+ {
+ if (in_array('setcharset', array_map('strtolower', get_class_methods($this->db)))) {
+ return $this->db->setCharset($charset);
+ }
+ return $this->db->query('SET NAMES ' .$this->db->quoteSmart($charset));
+ }
+
+ // }}}
+ // {{{ fetchLangs()
+
+ /**
+ * Fetch the available langs if they're not cached yet.
+ *
+ * @return PEAR_Error on failure
+ */
+ function fetchLangs()
+ {
+ $query = sprintf('SELECT %s AS id, %s AS name, %s AS meta, %s AS error_text, %s AS encoding FROM %s',
+ $this->db->quoteIdentifier($this->options['lang_id_col']),
+ $this->db->quoteIdentifier($this->options['lang_name_col']),
+ $this->db->quoteIdentifier($this->options['lang_meta_col']),
+ $this->db->quoteIdentifier($this->options['lang_errmsg_col']),
+ $this->db->quoteIdentifier($this->options['lang_encoding_col']),
+ $this->db->quoteIdentifier($this->options['langs_avail_table'])
+ );
+
+ ++$this->_queries;
+ $res = $this->db->getAll($query, DB_FETCHMODE_ASSOC);
+ if (PEAR::isError($res)) {
+ return $res;
+ }
+ foreach ($res as $row) {
+ $row = array_change_key_case($row, CASE_LOWER);
+ $this->langs[$row['id']] = $row;
+ }
+ }
+
+ // }}}
+ // {{{ getPage()
+
+ /**
+ * Returns an array of the strings in the selected page
+ *
+ * @param string $pageID page/group ID
+ * @param string $langID language ID
+ *
+ * @return array
+ */
+ function getPage($pageID = null, $langID = null)
+ {
+ $langID = $this->_getLangID($langID);
+ if (PEAR::isError($langID)) {
+ return $langID;
+ }
+ $lang_col = $this->_getLangCol($langID);
+ $table = $this->_getLangTable($langID);
+
+ $query = sprintf('SELECT %s, %s FROM %s WHERE %s ',
+ $this->db->quoteIdentifier($this->options['string_id_col']),
+ $this->db->quoteIdentifier($lang_col),
+ $this->db->quoteIdentifier($table),
+ $this->db->quoteIdentifier($this->options['string_page_id_col'])
+ );
+
+ if (is_null($pageID)) {
+ $query .= 'IS NULL';
+ } else {
+ $query .= ' = ' . $this->db->quote($pageID);
+ }
+
+ ++$this->_queries;
+ $res = $this->db->getAssoc($query);
+ return $res;
+ }
+
+ // }}}
+ // {{{ getOne()
+
+ /**
+ * Get a single item from the container
+ *
+ * @param string $stringID string ID
+ * @param string $pageID page/group ID
+ * @param string $langID language ID
+ *
+ * @return string
+ */
+ function getOne($stringID, $pageID = null, $langID = null)
+ {
+ $langID = $this->_getLangID($langID);
+ if (PEAR::isError($langID)) {
+ return $langID;
+ }
+ $lang_col = $this->_getLangCol($langID);
+ $table = $this->_getLangTable($langID);
+
+ $query = sprintf('SELECT %s FROM %s WHERE %s = %s AND %s',
+ $this->db->quoteIdentifier($lang_col),
+ $this->db->quoteIdentifier($table),
+ $this->db->quoteIdentifier($this->options['string_id_col']),
+ $this->db->quote($stringID),
+ $this->db->quoteIdentifier($this->options['string_page_id_col'])
+ );
+
+ if (is_null($pageID)) {
+ $query .= ' IS NULL';
+ } else {
+ $query .= ' = ' . $this->db->quote($pageID);
+ }
+
+ ++$this->_queries;
+ return $this->db->getOne($query);
+ }
+
+ // }}}
+ // {{{ getStringID()
+
+ /**
+ * Get the stringID for the given string
+ *
+ * @param string $string string
+ * @param string $pageID page/group ID
+ *
+ * @return string
+ */
+ function getStringID($string, $pageID = null)
+ {
+ $lang_col = $this->_getLangCol($this->currentLang['id']);
+ $table = $this->_getLangTable($this->currentLang['id']);
+ $query = sprintf('SELECT %s FROM %s WHERE %s = %s AND %s',
+ $this->db->quoteIdentifier($this->options['string_id_col']),
+ $this->db->quoteIdentifier($table),
+ $this->db->quoteIdentifier($lang_col),
+ $this->db->quote($string),
+ $this->db->quoteIdentifier($this->options['string_page_id_col'])
+ );
+ if (is_null($pageID)) {
+ $query .= ' IS NULL';
+ } else {
+ $query .= ' = ' . $this->db->quote($pageID);
+ }
+ ++$this->_queries;
+ return $this->db->getOne($query);
+ }
+
+ // }}}
+ // {{{ _getLangTable()
+
+ /**
+ * Get the table a language is stored in
+ *
+ * @param string $langID language ID
+ *
+ * @return string table $langID is stored in
+ * @access private
+ */
+ function _getLangTable($langID)
+ {
+ if (isset($this->options['strings_tables'][$langID])) {
+ return $this->options['strings_tables'][$langID];
+ }
+ return str_replace('%s', $langID, $this->options['strings_default_table']);
+ }
+
+ // }}}
+ // {{{ _getLangCol()
+
+ /**
+ * Get the column a language's string is stored in
+ *
+ * @param string $langID Language
+ *
+ * @return string column $langID is stored in
+ * @access private
+ */
+ function _getLangCol($langID)
+ {
+ static $cols;
+ if (!isset($cols[$langID])) {
+ if (isset($this->options['string_text_col']) &&
+ !empty($this->options['string_text_col'])) {
+ $cols[$langID] = str_replace('%s', $langID, $this->options['string_text_col']);
+ } else {
+ $cols[$langID] = $langID;
+ }
+ }
+ return $cols[$langID];
+ }
+
+ // }}}
+}
+?>
\ No newline at end of file
diff --git a/Translation2/Container/gettext.php b/Translation2/Container/gettext.php
new file mode 100644
index 0000000..e39230b
--- /dev/null
+++ b/Translation2/Container/gettext.php
@@ -0,0 +1,351 @@
+
+ * @author Michael Wallner
+ * @copyright 2004-2008 Lorenzo Alberton, Michael Wallner
+ * @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
+ * @version CVS: $Id$
+ * @link http://pear.php.net/package/Translation2
+ */
+
+/**
+ * require Translation2_Container class
+ */
+require_once 'Translation2/Container.php';
+
+/**
+ * require I18Nv2 for locale handling
+ */
+require_once 'I18Nv2.php';
+
+/**
+ * Storage driver for fetching data with gettext
+ *
+ * This storage driver requires the gettext extension
+ * and the PEAR::I18Nv2 class for locale handling
+ *
+ * @category Internationalization
+ * @package Translation2
+ * @author Lorenzo Alberton
+ * @author Michael Wallner
+ * @copyright 2004-2008 Lorenzo Alberton, Michael Wallner
+ * @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
+ * @version CVS: $Id$
+ * @link http://pear.php.net/package/Translation2
+ * @see /docs/gettext_readme.txt for an usage example
+ */
+class Translation2_Container_gettext extends Translation2_Container
+{
+ // {{{ class vars
+
+ /**
+ * domain bindings
+ * @var array
+ * @access private
+ */
+ var $_domains = array();
+
+ /**
+ * @var array
+ * @access private
+ */
+ var $cachedDomains = array();
+
+ /**
+ * @var boolean
+ * @access private
+ */
+ var $_native = false;
+
+ // }}}
+ // {{{ init
+
+ /**
+ * Initialize the container
+ *
+ * @param array $options gettext parameters
+ *
+ * @return boolean|PEAR_Error object if domains INI file doesn't exist
+ */
+ function init($options)
+ {
+ $this->_setDefaultOptions();
+ $this->_parseOptions($options);
+ $this->_native = (
+ function_exists('gettext') &&
+ (strtolower($this->options['file_type']) == 'mo') &&
+ !$this->options['blank_on_missing']
+ );
+
+ $this->_domains = @parse_ini_file($this->options['domains_path_file']);
+
+ if (!$this->_domains) {
+ return $this->raiseError(sprintf(
+ 'Cannot find domains INI file "%s" [%s on line %d]',
+ $this->options['domains_path_file'], __FILE__, __LINE__
+ ),
+ TRANSLATION2_ERROR_CANNOT_FIND_FILE
+ );
+ }
+
+ if ($this->_native) {
+ foreach ((array) $this->_domains as $domain => $path) {
+ bindtextdomain($domain, $path);
+ }
+ textdomain($this->options['default_domain']);
+ }
+ $this->setLang($this->options['default_lang']);
+
+ return true;
+ }
+
+ // }}}
+ // {{{ _setDefaultOptions()
+
+ /**
+ * Set some default options
+ *
+ * @access private
+ * @return void
+ */
+ function _setDefaultOptions()
+ {
+ $this->options['langs_avail_file'] = 'langs.ini';
+ $this->options['domains_path_file'] = 'domains.ini';
+ $this->options['default_domain'] = 'messages';
+ $this->options['carriage_return'] = "\n";
+ $this->options['file_type'] = 'mo';
+ $this->options['default_lang'] = 'en';
+ $this->options['default_encoding'] = 'iso-8859-1';
+ $this->options['blank_on_missing'] = false;
+ }
+
+ // }}}
+ // {{{ _switchLang()
+
+ /**
+ * Set the given langID
+ *
+ * @param string $langID new langID
+ *
+ * @return string previous langID
+ * @access private
+ */
+ function _switchLang($langID)
+ {
+ $langID = $this->_getLangID($langID);
+ $oldLang = $this->currentLang['id'];
+ $this->setLang($langID);
+ return $oldLang;
+ }
+
+ // }}}
+ // {{{ fetchLangs()
+
+ /**
+ * Fetch the available langs if they're not cached yet.
+ *
+ * @return void
+ */
+ function fetchLangs()
+ {
+ $this->langs = @parse_ini_file($this->options['langs_avail_file'], true);
+ foreach ((array) $this->langs as $id => $lang) {
+ $this->langs[$id]['id'] = $id;
+ }
+ }
+
+ // }}}
+ // {{{ setLang()
+
+ /**
+ * Sets the current lang
+ *
+ * @param string $langID language ID
+ *
+ * @return array language data
+ */
+ function setLang($langID)
+ {
+ if (!PEAR::isError($langData = parent::setLang($langID))) {
+ I18Nv2::setLocale($langID);
+ }
+ return $langData;
+ }
+
+ // }}}
+ // {{{ getPage()
+
+ /**
+ * Get all the strings from a domain (parsing the .mo file)
+ *
+ * @param string $pageID page/group ID
+ * @param string $langID language ID
+ *
+ * @return array|PEAR_Error
+ */
+ function getPage($pageID = null, $langID = null)
+ {
+ $oldLang = $this->_switchLang($langID);
+ $curLang = $this->currentLang['id'];
+
+ if (empty($pageID) || $pageID == TRANSLATION2_DEFAULT_PAGEID) {
+ $pageID = $this->options['default_domain'];
+ }
+
+ if (isset($this->cachedDomains[$curLang][$pageID])) {
+ $this->_switchLang($oldLang);
+ return $this->cachedDomains[$curLang][$pageID];
+ }
+
+ if (!isset($this->_domains[$pageID])) {
+ $this->_switchLang($oldLang);
+ return $this->raiseError(sprintf(
+ 'The domain "%s" was not specified in the domains INI '.
+ 'file "%s" [%s on line %d]', $pageID,
+ $this->options['domains_path_file'], __FILE__, __LINE__
+ ),
+ TRANSLATION2_ERROR_DOMAIN_NOT_SET
+ );
+ }
+
+ include_once 'File/Gettext.php';
+ $gtFile = &File_Gettext::factory($this->options['file_type']);
+
+ $path = $this->_domains[$pageID] .'/'. $curLang .'/LC_MESSAGES/';
+ $file = $path . $pageID .'.'. $this->options['file_type'];
+
+ if (PEAR::isError($e = $gtFile->load($file))) {
+ if (is_file($file)) {
+ $this->_switchLang($oldLang);
+ return $this->raiseError(sprintf(
+ '%s [%s on line %d]', $e->getMessage(), __FILE__, __LINE__
+ ),
+ TRANSLATION2_ERROR, PEAR_ERROR_RETURN
+ );
+ }
+ $this->_switchLang($oldLang);
+ return $this->raiseError(sprintf(
+ 'Cannot find file "%s" [%s on line %d]',
+ $file, __FILE__, __LINE__
+ ),
+ TRANSLATION2_ERROR_CANNOT_FIND_FILE, PEAR_ERROR_RETURN
+ );
+ }
+
+ $this->cachedDomains[$curLang][$pageID] = $gtFile->strings;
+ $this->_switchLang($oldLang);
+ return $gtFile->strings;
+ }
+
+ // }}}
+ // {{{ getOne()
+
+ /**
+ * Get a single item from the container, without caching the whole page
+ *
+ * @param string $stringID string ID
+ * @param string $pageID page/group ID
+ * @param string $langID language ID
+ *
+ * @return string
+ */
+ function getOne($stringID, $pageID = null, $langID = null)
+ {
+ // native mode
+ if ($this->_native) {
+ $oldLang = $this->_switchLang($langID);
+ $curLang = $this->currentLang['id'];
+
+ if (empty($pageID) || $pageID == TRANSLATION2_DEFAULT_PAGEID) {
+ $pageID = $this->options['default_domain'];
+ }
+
+ $string = dgettext($pageID, $stringID);
+
+ $this->_switchLang($oldLang);
+ return $string;
+ }
+
+ // use File_Gettext
+ $page = $this->getPage($pageID, $langID);
+ if (PEAR::isError($page = $this->getPage($pageID, $langID))) {
+ if ($page->getCode() == TRANSLATION2_ERROR_CANNOT_FIND_FILE) {
+ $page = array();
+ } else {
+ return $this->raiseError($page->getMessage(), $page->getCode());
+ }
+ }
+
+ // return original string if there's no translation available
+ if (isset($page[$stringID]) && strlen($page[$stringID])) {
+ return $page[$stringID];
+ } else if (false == $this->options['blank_on_missing']) {
+ return $stringID;
+ } else {
+ return '';
+ }
+ }
+
+ // }}}
+ // {{{ getStringID()
+
+ /**
+ * Get the stringID for the given string
+ *
+ * @param string $string string
+ * @param string $pageID page/group ID
+ *
+ * @return string|PEAR_Error
+ */
+ function getStringID($string, $pageID = null)
+ {
+ if (empty($pageID) || $pageID == TRANSLATION2_DEFAULT_PAGEID) {
+ $pageID = $this->options['default_domain'];
+ }
+
+ if (!array_key_exists($pageID, $this->_domains)) {
+ return $this->raiseError(sprintf(
+ 'The domain "%s" was not specified in the domains '.
+ 'INI file "%s" [%s on line %d]', $pageID,
+ $this->options['domains_path_file'], __FILE__, __LINE__
+ ),
+ TRANSLATION2_ERROR_DOMAIN_NOT_SET
+ );
+ }
+
+ return array_search($string, $this->getPage($pageID));
+ }
+
+ // }}}
+}
+?>
\ No newline at end of file
diff --git a/Translation2/Container/mdb.php b/Translation2/Container/mdb.php
new file mode 100644
index 0000000..26c77ec
--- /dev/null
+++ b/Translation2/Container/mdb.php
@@ -0,0 +1,339 @@
+
+ * @copyright 2004-2008 Lorenzo Alberton
+ * @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
+ * @version CVS: $Id$
+ * @link http://pear.php.net/package/Translation2
+ */
+
+/**
+ * require Translation2_Container class
+ */
+require_once 'Translation2/Container.php';
+
+/**
+ * Storage driver for fetching data from a database
+ *
+ * This storage driver can use all databases which are supported
+ * by the PEAR::MDB abstraction layer to fetch data.
+ *
+ * @category Internationalization
+ * @package Translation2
+ * @author Lorenzo Alberton
+ * @copyright 2004-2008 Lorenzo Alberton
+ * @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
+ * @version CVS: $Id$
+ * @link http://pear.php.net/package/Translation2
+ */
+class Translation2_Container_mdb extends Translation2_Container
+{
+
+ // {{{ class vars
+
+ /**
+ * MDB object
+ * @var object
+ */
+ var $db = null;
+
+ /**
+ * query counter
+ * @var integer
+ * @access private
+ */
+ var $_queries = 0;
+
+ // }}}
+ // {{{ init
+
+ /**
+ * Initialize the container
+ *
+ * @param string &$db Connection data or MDB object
+ *
+ * @return boolean|PEAR_Error object if something went wrong
+ */
+ function init(&$db)
+ {
+ $this->_setDefaultOptions();
+ if (PEAR::isError($err = $this->_connect($db))) {
+ return $err;
+ }
+ return true;
+ }
+
+ // }}}
+ // {{{ _connect()
+
+ /**
+ * Connect to database by using the given DSN string
+ *
+ * @param mixed &$db DSN string | array | mdb object
+ *
+ * @return boolean|PEAR_Error on error
+ * @access private
+ */
+ function _connect(&$db)
+ {
+ if (is_object($db) && is_a($db, 'MDB_Common')) {
+ $this->db = &$db;
+ } elseif (is_string($db) || is_array($db)) {
+ include_once 'MDB.php';
+ $this->db =& MDB::connect($db);
+ } elseif (is_object($db) && MDB::isError($db)) {
+ return PEAR::raiseError($db->getMessage(), $db->code);
+ } else {
+ return PEAR::raiseError('The given dsn was not valid in file '
+ . __FILE__ . ' at line ' . __LINE__,
+ TRANSLATION2_ERROR_CANNOT_CONNECT,
+ PEAR_ERROR_RETURN);
+ }
+
+ if (PEAR::isError($this->db)) {
+ return $this->db;
+ }
+ return true;
+ }
+
+ // }}}
+ // {{{ _setDefaultOptions()
+
+ /**
+ * Set some default options
+ *
+ * @access private
+ * @return void
+ */
+ function _setDefaultOptions()
+ {
+ $this->options['langs_avail_table'] = 'langs';
+ $this->options['lang_id_col'] = 'id';
+ $this->options['lang_name_col'] = 'name';
+ $this->options['lang_meta_col'] = 'meta';
+ $this->options['lang_errmsg_col'] = 'error_text';
+ $this->options['lang_encoding_col'] = 'encoding';
+
+ $this->options['strings_default_table'] = 'i18n';
+ $this->options['strings_tables'] = array(); // 'lang_id' => 'table_name'
+ $this->options['string_id_col'] = 'id';
+ $this->options['string_page_id_col'] = 'page_id';
+ $this->options['string_page_id_col_length'] = 50;
+ $this->options['string_text_col'] = '%s'; // col_name if one table per lang is used,
+ // or a pattern (i.e. "tr_%s" => "tr_EN_US")
+ }
+
+ // }}}
+ // {{{ fetchLangs()
+
+ /**
+ * Fetch the available langs if they're not cached yet.
+ *
+ * @return PEAR_Error on error
+ */
+ function fetchLangs()
+ {
+ $query = sprintf('SELECT %s AS id, %s AS name, %s AS meta, %s AS error_text, %s AS encoding FROM %s',
+ $this->db->quoteIdentifier($this->options['lang_id_col']),
+ $this->db->quoteIdentifier($this->options['lang_name_col']),
+ $this->db->quoteIdentifier($this->options['lang_meta_col']),
+ $this->db->quoteIdentifier($this->options['lang_errmsg_col']),
+ $this->db->quoteIdentifier($this->options['lang_encoding_col']),
+ $this->db->quoteIdentifier($this->options['langs_avail_table'])
+ );
+
+ ++$this->_queries;
+ $res = $this->db->getAll($query, null, array(), null, MDB_FETCHMODE_ASSOC);
+ if (PEAR::isError($res)) {
+ return $res;
+ }
+ foreach ($res as $row) {
+ $row = array_change_key_case($row, CASE_LOWER);
+ $this->langs[$row['id']] = $row;
+ }
+ }
+
+ // }}}
+ // {{{ getPage()
+
+ /**
+ * Returns an array of the strings in the selected page
+ *
+ * @param string $pageID page/group ID
+ * @param string $langID language ID
+ *
+ * @return array|PEAR_Error on error
+ */
+ function getPage($pageID = null, $langID = null)
+ {
+ $langID = $this->_getLangID($langID);
+ if (PEAR::isError($langID)) {
+ return $langID;
+ }
+ $lang_col = $this->_getLangCol($langID);
+ $table = $this->_getLangTable($langID);
+
+ $query = sprintf('SELECT %s, %s FROM %s WHERE %s ',
+ $this->db->quoteIdentifier($this->options['string_id_col']),
+ $this->db->quoteIdentifier($lang_col),
+ $this->db->quoteIdentifier($table),
+ $this->db->quoteIdentifier($this->options['string_page_id_col'])
+ );
+
+ if (is_null($pageID)) {
+ $query .= 'IS NULL';
+ } else {
+ $query .= ' = ' . $this->db->getTextValue($pageID);
+ }
+
+ ++$this->_queries;
+ $res = $this->db->getAssoc($query);
+ return $res;
+ }
+
+ // }}}
+ // {{{ getOne()
+
+ /**
+ * Get a single item from the container
+ *
+ * @param string $stringID string ID
+ * @param string $pageID page/group ID
+ * @param string $langID language ID
+ *
+ * @return string
+ */
+ function getOne($stringID, $pageID = null, $langID = null)
+ {
+ $langID = $this->_getLangID($langID);
+ if (PEAR::isError($langID)) {
+ return $langID;
+ }
+ $lang_col = $this->_getLangCol($langID);
+ $table = $this->_getLangTable($langID);
+
+ $query = sprintf('SELECT %s FROM %s WHERE %s = %s AND %s',
+ $this->db->quoteIdentifier($lang_col),
+ $this->db->quoteIdentifier($table),
+ $this->db->quoteIdentifier($this->options['string_id_col']),
+ $this->db->getTextValue($stringID),
+ $this->db->quoteIdentifier($this->options['string_page_id_col'])
+ );
+
+ if (is_null($pageID)) {
+ $query .= ' IS NULL';
+ } else {
+ $query .= ' = ' . $this->db->getTextValue($pageID);
+ }
+
+ ++$this->_queries;
+ return $this->db->getOne($query);
+ }
+
+ // }}}
+ // {{{ getStringID()
+
+ /**
+ * Get the stringID for the given string
+ *
+ * @param string $string string
+ * @param string $pageID page/group ID
+ *
+ * @return string
+ */
+ function getStringID($string, $pageID = null)
+ {
+ $lang_col = $this->_getLangCol($this->currentLang['id']);
+ $table = $this->_getLangTable($this->currentLang['id']);
+ $query = sprintf('SELECT %s FROM %s WHERE %s = %s AND %s',
+ $this->db->quoteIdentifier($this->options['string_id_col']),
+ $this->db->quoteIdentifier($table),
+ $this->db->quoteIdentifier($lang_col),
+ $this->db->getTextValue($string),
+ $this->db->quoteIdentifier($this->options['string_page_id_col'])
+ );
+ if (is_null($pageID)) {
+ $query .= ' IS NULL';
+ } else {
+ $query .= ' = ' . $this->db->getTextValue($pageID);
+ }
+ ++$this->_queries;
+ return $this->db->getOne($query);
+ }
+
+ // }}}
+ // {{{ _getLangTable()
+
+ /**
+ * Get the table a language is stored in
+ *
+ * @param string $langID language ID
+ *
+ * @return string table $langID is stored in
+ * @access private
+ */
+ function _getLangTable($langID)
+ {
+ if (isset($this->options['strings_tables'][$langID])) {
+ return $this->options['strings_tables'][$langID];
+ }
+ return str_replace('%s', $langID, $this->options['strings_default_table']);
+ }
+
+ // }}}
+ // {{{ _getLangCol()
+
+ /**
+ * Get the column a language's string is stored in
+ *
+ * @param string $langID language ID
+ *
+ * @return string column $langID is stored in
+ * @access private
+ */
+ function _getLangCol($langID)
+ {
+ static $cols;
+ if (!isset($cols[$langID])) {
+ if (isset($this->options['string_text_col']) &&
+ !empty($this->options['string_text_col'])) {
+ $cols[$langID] = str_replace('%s', $langID, $this->options['string_text_col']);
+ } else {
+ $cols[$langID] = $langID;
+ }
+ }
+ return $cols[$langID];
+ }
+
+ // }}}
+}
+?>
\ No newline at end of file
diff --git a/Translation2/Container/mdb2.php b/Translation2/Container/mdb2.php
new file mode 100644
index 0000000..69303d2
--- /dev/null
+++ b/Translation2/Container/mdb2.php
@@ -0,0 +1,362 @@
+
+ * @copyright 2004-2008 Lorenzo Alberton
+ * @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
+ * @version CVS: $Id$
+ * @link http://pear.php.net/package/Translation2
+ */
+
+/**
+ * require Translation2_Container class
+ */
+require_once 'Translation2/Container.php';
+
+/**
+ * Storage driver for fetching data from a database
+ *
+ * This storage driver can use all databases which are supported
+ * by the PEAR::MDB2 abstraction layer to fetch data.
+ *
+ * @category Internationalization
+ * @package Translation2
+ * @author Lorenzo Alberton
+ * @copyright 2004-2008 Lorenzo Alberton
+ * @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
+ * @version CVS: $Id$
+ * @link http://pear.php.net/package/Translation2
+ */
+class Translation2_Container_mdb2 extends Translation2_Container
+{
+ // {{{ class vars
+
+ /**
+ * MDB2 object
+ * @var object
+ */
+ var $db = null;
+
+ /**
+ * query counter
+ * @var integer
+ * @access private
+ */
+ var $_queries = 0;
+
+ // }}}
+ // {{{ init
+
+ /**
+ * Initialize the container
+ *
+ * @param string &$db Connection data or MDB2 object
+ *
+ * @return boolean|PEAR_Error object if something went wrong
+ */
+ function init(&$db)
+ {
+ $this->_setDefaultOptions();
+ if (PEAR::isError($err = $this->_connect($db))) {
+ return $err;
+ }
+ return true;
+ }
+
+ // }}}
+ // {{{ _connect()
+
+ /**
+ * Connect to database by using the given DSN string
+ *
+ * @param mixed &$db DSN string | array | MDB2 object
+ *
+ * @return boolean|PEAR_Error on error
+ * @access private
+ */
+ function _connect(&$db)
+ {
+ if (is_object($db) && is_a($db, 'MDB2_Driver_Common')) {
+ $this->db = &$db;
+ } elseif (is_string($db) || is_array($db)) {
+ include_once 'MDB2.php';
+ $this->db =& MDB2::connect($db);
+ } elseif (is_object($db) && MDB2::isError($db)) {
+ return PEAR::raiseError($db->getMessage(), $db->code);
+ } else {
+ return PEAR::raiseError('The given dsn was not valid in file '
+ . __FILE__ . ' at line ' . __LINE__,
+ TRANSLATION2_ERROR_CANNOT_CONNECT,
+ PEAR_ERROR_RETURN);
+ }
+
+ if (PEAR::isError($this->db)) {
+ return $this->db;
+ }
+ return true;
+ }
+
+ // }}}
+ // {{{ _setDefaultOptions()
+
+ /**
+ * Set some default options
+ *
+ * @return void
+ * @access private
+ */
+ function _setDefaultOptions()
+ {
+ $this->options['langs_avail_table'] = 'langs';
+ $this->options['lang_id_col'] = 'id';
+ $this->options['lang_name_col'] = 'name';
+ $this->options['lang_meta_col'] = 'meta';
+ $this->options['lang_errmsg_col'] = 'error_text';
+ $this->options['lang_encoding_col'] = 'encoding';
+
+ $this->options['strings_default_table'] = 'i18n';
+ $this->options['strings_tables'] = array(); // 'lang_id' => 'table_name'
+ $this->options['string_id_col'] = 'id';
+ $this->options['string_page_id_col'] = 'page_id';
+ $this->options['string_page_id_col_length'] = 50;
+ $this->options['string_text_col'] = '%s'; // col_name if one table per lang is used,
+ // or a pattern (i.e. "tr_%s" => "tr_EN_US")
+ }
+
+ // }}}
+ // {{{ setCharset()
+
+ /**
+ * Set charset used to read/store the translations
+ *
+ * @param string $charset character set (encoding)
+ *
+ * @return PEAR_Error on error
+ */
+ function setCharset($charset)
+ {
+ return $this->db->setCharset($charset);
+ }
+
+ // }}}
+ // {{{ fetchLangs()
+
+ /**
+ * Fetch the available langs if they're not cached yet.
+ *
+ * @return PEAR_Error on error
+ */
+ function fetchLangs()
+ {
+ $query = sprintf('SELECT %s AS id, %s AS name, %s AS meta, %s AS error_text, %s AS encoding FROM %s',
+ $this->db->quoteIdentifier($this->options['lang_id_col'], true),
+ $this->db->quoteIdentifier($this->options['lang_name_col'], true),
+ $this->db->quoteIdentifier($this->options['lang_meta_col'], true),
+ $this->db->quoteIdentifier($this->options['lang_errmsg_col'], true),
+ $this->db->quoteIdentifier($this->options['lang_encoding_col'], true),
+ $this->db->quoteIdentifier($this->options['langs_avail_table'], true)
+ );
+
+ ++$this->_queries;
+ $res = $this->db->queryAll($query, null, MDB2_FETCHMODE_ASSOC);
+ if (PEAR::isError($res)) {
+ return $res;
+ }
+ foreach ($res as $row) {
+ $row = array_change_key_case($row, CASE_LOWER);
+ $this->langs[$row['id']] = $row;
+ }
+ }
+
+ // }}}
+ // {{{ getPage()
+
+ /**
+ * Returns an array of the strings in the selected page
+ *
+ * @param string $pageID page/group ID
+ * @param string $langID language ID
+ *
+ * @return array
+ */
+ function getPage($pageID = null, $langID = null)
+ {
+ $langID = $this->_getLangID($langID);
+ if (PEAR::isError($langID)) {
+ return $langID;
+ }
+ $lang_col = $this->_getLangCol($langID);
+ $table = $this->_getLangTable($langID);
+
+ $query = sprintf('SELECT %s, %s FROM %s WHERE %s ',
+ $this->db->quoteIdentifier($this->options['string_id_col'], true),
+ $this->db->quoteIdentifier($lang_col, true),
+ $this->db->quoteIdentifier($table, true),
+ $this->db->quoteIdentifier($this->options['string_page_id_col'], true)
+ );
+
+ if (is_null($pageID)) {
+ $query .= 'IS NULL';
+ } else {
+ $query .= ' = ' . $this->db->quote($pageID, 'text');
+ }
+
+ ++$this->_queries;
+ $res = $this->db->query($query);
+ if (PEAR::isError($res)) {
+ return $res;
+ }
+
+ $strings = array();
+ while (list($key, $value) = $res->fetchRow(MDB2_FETCHMODE_ORDERED)) {
+ $strings[$key] = $value;
+ }
+ $res->free();
+ return $strings;
+ }
+
+ // }}}
+ // {{{ getOne()
+
+ /**
+ * Get a single item from the container
+ *
+ * @param string $stringID string ID
+ * @param string $pageID page/group ID
+ * @param string $langID language ID
+ *
+ * @return string
+ */
+ function getOne($stringID, $pageID = null, $langID = null)
+ {
+ $langID = $this->_getLangID($langID);
+ if (PEAR::isError($langID)) {
+ return $langID;
+ }
+ $lang_col = $this->_getLangCol($langID);
+ $table = $this->_getLangTable($langID);
+
+ $query = sprintf('SELECT %s FROM %s WHERE %s = %s AND %s',
+ $this->db->quoteIdentifier($lang_col, true),
+ $this->db->quoteIdentifier($table, true),
+ $this->db->quoteIdentifier($this->options['string_id_col'], true),
+ $this->db->quote($stringID, 'text'),
+ $this->db->quoteIdentifier($this->options['string_page_id_col'], true)
+ );
+
+ if (is_null($pageID)) {
+ $query .= ' IS NULL';
+ } else {
+ $query .= ' = ' . $this->db->quote($pageID, 'text');
+ }
+
+ ++$this->_queries;
+ return $this->db->queryOne($query);
+ }
+
+ // }}}
+ // {{{ getStringID()
+
+ /**
+ * Get the stringID for the given string
+ *
+ * @param string $string string
+ * @param string $pageID page/group ID
+ *
+ * @return string
+ */
+ function getStringID($string, $pageID = null)
+ {
+ $lang_col = $this->_getLangCol($this->currentLang['id']);
+ $table = $this->_getLangTable($this->currentLang['id']);
+ $query = sprintf('SELECT %s FROM %s WHERE %s = %s AND %s',
+ $this->db->quoteIdentifier($this->options['string_id_col'], true),
+ $this->db->quoteIdentifier($table, true),
+ $this->db->quoteIdentifier($lang_col, true),
+ $this->db->quote($string, 'text'),
+ $this->db->quoteIdentifier($this->options['string_page_id_col'], true)
+ );
+ if (is_null($pageID)) {
+ $query .= ' IS NULL';
+ } else {
+ $query .= ' = ' . $this->db->quote($pageID, 'text');
+ }
+ ++$this->_queries;
+ return $this->db->queryOne($query);
+ }
+
+ // }}}
+ // {{{ _getLangTable()
+
+ /**
+ * Get the table a language is stored in
+ *
+ * @param string $langID language ID
+ *
+ * @return string table $langID is stored in
+ * @access private
+ */
+ function _getLangTable($langID)
+ {
+ if (isset($this->options['strings_tables'][$langID])) {
+ return $this->options['strings_tables'][$langID];
+ }
+ return str_replace('%s', $langID, $this->options['strings_default_table']);
+ }
+
+ // }}}
+ // {{{ _getLangCol()
+
+ /**
+ * Get the column a language's string is stored in
+ *
+ * @param string $langID language ID
+ *
+ * @return string column $langID is stored in
+ * @access private
+ */
+ function _getLangCol($langID)
+ {
+ static $cols;
+ if (!isset($cols[$langID])) {
+ if (isset($this->options['string_text_col']) &&
+ !empty($this->options['string_text_col'])) {
+ $cols[$langID] = str_replace('%s', $langID, $this->options['string_text_col']);
+ } else {
+ $cols[$langID] = $langID;
+ }
+ }
+ return $cols[$langID];
+ }
+
+ // }}}
+}
+?>
\ No newline at end of file
diff --git a/Translation2/Container/xml.php b/Translation2/Container/xml.php
new file mode 100644
index 0000000..8fab9cb
--- /dev/null
+++ b/Translation2/Container/xml.php
@@ -0,0 +1,500 @@
+
+ * @author Olivier Guilyardi
+ * @copyright 2004-2008 Lorenzo Alberton, Olivier Guilyardi
+ * @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
+ * @version CVS: $Id$
+ * @link http://pear.php.net/package/Translation2
+ */
+
+/**
+ * require Translation2_Container class
+ */
+require_once 'Translation2/Container.php';
+/**
+ * require XML_Unserializer class
+ */
+require_once 'XML/Unserializer.php';
+/**
+ * Document Type Definition
+ */
+define('TRANSLATION2_DTD',
+ "\n" .
+ "\n" .
+ "\n" .
+ "\n" .
+ "\n" .
+ "\n" .
+ "\n" .
+ "\n" .
+ "\n" .
+ "\n" .
+ "\n" .
+ "\n" .
+ "\n" .
+ "\n" .
+ "\n"
+);
+
+/**
+ * Storage driver for fetching data from a XML file
+ *
+ * Example file :
+ *
+ *
+ *
+ *
+ *
+ * English
+ * Custom meta data
+ * Non disponible en français
+ * iso-8859-1
+ *
+ *
+ *
+ *
+ *
+ *
+ * Chat
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ * @category Internationalization
+ * @package Translation2
+ * @author Lorenzo Alberton
+ * @author Olivier Guilyardi
+ * @copyright 2004-2008 Lorenzo Alberton, Olivier Guilyardi
+ * @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
+ * @link http://pear.php.net/package/Translation2
+ */
+class Translation2_Container_xml extends Translation2_Container
+{
+ // {{{ class vars
+
+ /**
+ * Unserialized XML data
+ * @var object
+ */
+ var $_data = null;
+
+ /**
+ * XML file name
+ * @var string
+ */
+ var $_filename;
+
+ // }}}
+ // {{{ init
+
+ /**
+ * Initialize the container
+ *
+ * @param array $options - 'filename': Path to the XML file
+ *
+ * @return boolean|PEAR_Error object if something went wrong
+ */
+ function init($options)
+ {
+ $this->_filename = $options['filename'];
+ unset($options['filename']);
+ $this->_setDefaultOptions();
+ $this->_parseOptions($options);
+
+ return $this->_loadFile();
+ }
+
+ // }}}
+ // {{{ _loadFile()
+
+ /**
+ * Load an XML file into memory, and eventually decode the strings from UTF-8
+ *
+ * @return boolean|PEAR_Error
+ * @access private
+ */
+ function _loadFile()
+ {
+ $keyAttr = array (
+ 'lang' => 'id',
+ 'page' => 'key',
+ 'string' => 'key',
+ 'tr' => 'lang'
+ );
+ if (!$fp = @fopen($this->_filename, 'r')) {
+ return new PEAR_Error ("Can\'t read from the XML source: {$this->_filename}");
+ }
+ @flock($fp, LOCK_SH);
+ $unserializer = &new XML_Unserializer (array('keyAttribute' => $keyAttr));
+ if (PEAR::isError($status = $unserializer->unserialize($this->_filename, true))) {
+ fclose($fp);
+ return $status;
+ }
+ fclose($fp);
+
+ // unserialize data
+ $this->_data = $unserializer->getUnserializedData();
+ $this->fixEmptySets($this->_data);
+ $this->_fixDuplicateEntries();
+
+ // Handle default language settings.
+ // This allows, for example, to rapidly write the meta data as:
+ //
+ //
+ //
+
+ $defaults = array(
+ 'name' => '',
+ 'meta' => '',
+ 'error_text' => '',
+ 'encoding' => 'iso-8859-1'
+ );
+
+ foreach ($this->_data['languages'] as $lang_id => $settings) {
+ if (empty($settings)) {
+ $this->_data['languages'][$lang_id] = $defaults;
+ } else {
+ $this->_data['languages'][$lang_id] =
+ array_merge($defaults, $this->_data['languages'][$lang_id]);
+ }
+ }
+
+ // convert lang metadata from UTF-8
+ if (PEAR::isError($e = $this->_convertLangEncodings('from_xml', $this->_data))) {
+ return $e;
+ }
+
+ // convert encodings of the translated strings from xml (somehow heavy)
+ return $this->_convertEncodings('from_xml', $this->_data);
+ }
+
+ // }}}
+ // {{{ _convertEncodings()
+
+ /**
+ * Convert strings to/from XML unique charset (UTF-8)
+ *
+ * @param string $direction ['from_xml' | 'to_xml']
+ * @param array &$data Data buffer to operate on
+ *
+ * @return boolean|PEAR_Error
+ */
+ function _convertEncodings($direction, &$data)
+ {
+ if ($direction == 'from_xml') {
+ $source_encoding = 'UTF-8';
+ } else {
+ $target_encoding = 'UTF-8';
+ }
+
+ foreach ($data['pages'] as $page_id => $page_content) {
+ foreach ($page_content as $str_id => $translations) {
+ foreach ($translations as $lang => $str) {
+ if ($direction == 'from_xml') {
+ $target_encoding =
+ strtoupper($data['languages'][$lang]['encoding']);
+ } else {
+ $source_encoding =
+ strtoupper($data['languages'][$lang]['encoding']);
+ }
+ if ($target_encoding != $source_encoding) {
+ $res = iconv($source_encoding, $target_encoding, $str);
+ if ($res === false) {
+ $msg = 'Encoding conversion error ' .
+ "(source encoding: $source_encoding, ".
+ "target encoding: $target_encoding, ".
+ "processed string: \"$str\"";
+ return $this->raiseError($msg,
+ TRANSLATION2_ERROR_ENCODING_CONVERSION,
+ PEAR_ERROR_RETURN,
+ E_USER_WARNING);
+ }
+ $data['pages'][$page_id][$str_id][$lang] = $res;
+ }
+ }
+ }
+ }
+ return true;
+ }
+
+ // }}}
+ // {{{ _convertLangEncodings()
+
+ /**
+ * Convert lang data to/from XML unique charset (UTF-8)
+ *
+ * @param string $direction ['from_xml' | 'to_xml']
+ * @param array &$data Data buffer to operate on
+ *
+ * @return boolean|PEAR_Error
+ */
+ function _convertLangEncodings($direction, &$data)
+ {
+ static $fields = array('name', 'meta', 'error_text');
+
+ if ($direction == 'from_xml') {
+ $source_encoding = 'UTF-8';
+ } else {
+ $target_encoding = 'UTF-8';
+ }
+
+ foreach ($data['languages'] as $lang_id => $lang) {
+ if ($direction == 'from_xml') {
+ $target_encoding = strtoupper($lang['encoding']);
+ } else {
+ $source_encoding = strtoupper($lang['encoding']);
+ }
+ //foreach (array_keys($lang) as $field) {
+ foreach ($fields as $field) {
+ if ($target_encoding != $source_encoding && !empty($lang[$field])) {
+ $res = iconv($source_encoding, $target_encoding, $lang[$field]);
+ if ($res === false) {
+ $msg = 'Encoding conversion error ' .
+ "(source encoding: $source_encoding, ".
+ "target encoding: $target_encoding, ".
+ "processed string: \"$lang[$field]\"";
+ return $this->raiseError($msg,
+ TRANSLATION2_ERROR_ENCODING_CONVERSION,
+ PEAR_ERROR_RETURN,
+ E_USER_WARNING);
+ }
+ $data['languages'][$lang_id][$field] = $res;
+ }
+ }
+ }
+ return true;
+ }
+
+ // }}}
+ // {{{ _fixDuplicateEntries()
+
+ /**
+ * Remove duplicate entries from the xml data
+ *
+ * @return void
+ */
+ function _fixDuplicateEntries()
+ {
+ foreach ($this->_data['pages'] as $pagename => $pagedata) {
+ foreach ($pagedata as $stringname => $stringvalues) {
+ if (is_array(array_pop($stringvalues))) {
+ $this->_data['pages'][$pagename][$stringname] =
+ call_user_func_array(array($this, '_merge'), $stringvalues);
+ }
+ }
+ }
+ }
+
+ // }}}
+ // {{{ fixEmptySets()
+
+ /**
+ * Turn empty strings returned by XML_Unserializer into empty arrays
+ *
+ * Note: this method is public because called statically by the t2xmlchk.php
+ * script. It is not meant to be called by user-space code.
+ *
+ * @param array &$data array of languages/pages
+ *
+ * @return void
+ * @access public
+ * @static
+ */
+ function fixEmptySets(&$data)
+ {
+ if (PEAR::isError($this->_data) && ($this->_data->code == XML_UNSERIALIZER_ERROR_NO_UNSERIALIZATION)) {
+ //empty file... create skeleton
+ $this->_data = array(
+ 'languages' => array(),
+ 'pages' => array(),
+ );
+ }
+ if (is_string($data['languages']) and trim($data['languages']) == '') {
+ $data['languages'] = array();
+ }
+ if (is_string($data['pages']) and trim($data['pages']) == '') {
+ $data['pages'] = array();
+ } else {
+ foreach ($data['pages'] as $pageName => $strings) {
+ //if (is_string($strings) and trim($strings) == '') {
+ if (is_string($strings)) {
+ $data['pages'][$pageName] = array();
+ } else {
+ foreach ($strings as $stringName => $translations) {
+ if (is_string($translations) and trim($translations) == '') {
+ $data['pages'][$pageName][$stringName] = array();
+ }
+ }
+ }
+ }
+ }
+ }
+
+ // }}}
+ // {{{ _merge()
+
+ /**
+ * Wrapper for array_merge()
+ *
+ * @param array $arr1 reference
+ *
+ * @return array
+ */
+ function _merge()
+ {
+ $return = array();
+ foreach (func_get_args() as $arg) {
+ $return = array_merge($return, $arg);
+ }
+ return $return;
+ }
+
+ // }}}
+ // {{{ _setDefaultOptions()
+
+ /**
+ * Set some default options
+ *
+ * @return void
+ * @access private
+ */
+ function _setDefaultOptions()
+ {
+ //save changes on shutdown or in real time?
+ $this->options['save_on_shutdown'] = true;
+ }
+
+ // }}}
+ // {{{ fetchLangs()
+
+ /**
+ * Fetch the available langs
+ *
+ * @return void
+ */
+ function fetchLangs()
+ {
+ $res = array();
+ foreach ($this->_data['languages'] as $id => $spec) {
+ $spec['id'] = $id;
+ $res[$id] = $spec;
+ }
+ $this->langs = $res;
+ }
+
+ // }}}
+ // {{{ getPage()
+
+ /**
+ * Returns an array of the strings in the selected page
+ *
+ * @param string $pageID page/group ID
+ * @param string $langID language ID
+ *
+ * @return array
+ */
+ function getPage($pageID = null, $langID = null)
+ {
+ $langID = $this->_getLangID($langID);
+ if (PEAR::isError($langID)) {
+ return $langID;
+ }
+ $pageID = (is_null($pageID)) ? '#NULL' : $pageID;
+ $pageID = (empty($pageID) && (0 !== $pageID)) ? '#EMPTY' : $pageID;
+
+ $result = array();
+ foreach ($this->_data['pages'][$pageID] as $str_id => $translations) {
+ $result[$str_id] = isset($translations[$langID])
+ ? $translations[$langID]
+ : null;
+ }
+
+ return $result;
+ }
+
+ // }}}
+ // {{{ getOne()
+
+ /**
+ * Get a single item from the container
+ *
+ * @param string $stringID string ID
+ * @param string $pageID page/group ID
+ * @param string $langID language ID
+ *
+ * @return string
+ */
+ function getOne($stringID, $pageID = null, $langID = null)
+ {
+ $langID = $this->_getLangID($langID);
+ if (PEAR::isError($langID)) {
+ return $langID;
+ }
+ $pageID = (is_null($pageID)) ? '#NULL' : $pageID;
+ return isset($this->_data['pages'][$pageID][$stringID][$langID])
+ ? $this->_data['pages'][$pageID][$stringID][$langID]
+ : null;
+ }
+
+ // }}}
+ // {{{ getStringID()
+
+ /**
+ * Get the stringID for the given string
+ *
+ * @param string $string string
+ * @param string $pageID page/group ID
+ *
+ * @return string
+ */
+ function getStringID($string, $pageID = null)
+ {
+ $pageID = (is_null($pageID)) ? '#NULL' : $pageID;
+
+ foreach ($this->_data['pages'][$pageID] as $stringID => $translations) {
+ if (array_search($string, $translations) !== false) {
+ return $stringID;
+ }
+ }
+
+ return '';
+ }
+
+ // }}}
+}
+?>
\ No newline at end of file
diff --git a/Decorator.php b/Translation2/Decorator.php
similarity index 100%
rename from Decorator.php
rename to Translation2/Decorator.php
diff --git a/Translation2/Decorator/CacheLiteFunction.php b/Translation2/Decorator/CacheLiteFunction.php
new file mode 100644
index 0000000..227d8e4
--- /dev/null
+++ b/Translation2/Decorator/CacheLiteFunction.php
@@ -0,0 +1,452 @@
+
+ * @copyright 2004-2007 Lorenzo Alberton
+ * @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
+ * @version CVS: $Id$
+ * @link http://pear.php.net/package/Translation2
+ */
+
+/**
+ * Load Translation2 decorator base class
+ * and Cache_Lite_Function class
+ */
+require_once 'Translation2/Decorator.php';
+require_once 'Cache/Lite/Function.php';
+
+/**
+ * Decorator to cache fetched data using the Cache_Lite_Function class.
+ *
+ * @category Internationalization
+ * @package Translation2
+ * @author Lorenzo Alberton
+ * @copyright 2004-2007 Lorenzo Alberton
+ * @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
+ * @version CVS: $Id$
+ * @link http://pear.php.net/package/Translation2
+ */
+class Translation2_Decorator_CacheLiteFunction extends Translation2_Decorator
+{
+ // {{{ class vars
+
+ /**
+ * Cache_Lite_Function object
+ * @var object
+ */
+ var $cacheLiteFunction = null;
+
+ /**
+ * @var int (default 1)
+ * @access private
+ */
+ var $tempVarNameGenerator = 1;
+
+ /**
+ * @var string
+ * @access private
+ */
+ var $tempVarName = null;
+
+ /**
+ * Cache lifetime (in seconds)
+ * @var int $lifeTime
+ * @access private
+ */
+ var $lifeTime = 3600;
+
+ /**
+ * Directory where to put the cache files
+ * (make sure to add a trailing slash)
+ * @var string $cacheDir
+ * @access private
+ */
+ var $cacheDir = '/tmp/';
+
+ /**
+ * Enable / disable fileLocking. Can avoid cache corruption under bad
+ * circumstances.
+ * @var string $cacheDir
+ * @access private
+ */
+ var $fileLocking = true;
+
+ /**
+ * Enable / disable caching
+ * (can be very useful to debug cached scripts)
+ * @var boolean $caching
+ */
+ var $caching = true;
+
+ /**
+ * Frequency of cache cleaning.
+ * Higher values mean lower cleaning probability.
+ * Set 0 to disable. Set 1 to clean at every request.
+ * @var boolean $caching
+ */
+ var $cleaningFrequency = 0;
+
+ /**
+ * Name of default cache group.
+ * @var string $defaultGroup
+ */
+ var $defaultGroup = 'Translation2';
+
+ // }}}
+ // {{{ _prepare()
+
+ /**
+ * Istanciate a new Cache_Lite_Function object
+ * and get the name for an unused global variable,
+ * needed by Cache_Lite_Function
+ *
+ * @return void
+ * @access private
+ */
+ function _prepare()
+ {
+ if (is_null($this->cacheLiteFunction)) {
+ $cache_options = array(
+ 'caching' => $this->caching,
+ 'cacheDir' => $this->cacheDir,
+ 'lifeTime' => $this->lifeTime,
+ 'fileLocking' => $this->fileLocking,
+ 'defaultGroup' => $this->defaultGroup,
+
+ );
+ $this->cacheLiteFunction = new Cache_Lite_Function($cache_options);
+ }
+
+ $this->_cleanCache();
+ }
+
+ // }}}
+ // {{{ setLang()
+
+ /**
+ * Set default lang
+ *
+ * Set the language that shall be used when retrieving strings.
+ *
+ * @param string $langID language code (for instance, 'en' or 'it')
+ *
+ * @return void
+ */
+ function setLang($langID)
+ {
+ // WITHOUT THIS, IT DOESN'T WORK
+ global $translation2_storage_cachelitefunction_temp;
+ //generate temp variable
+ $translation2_storage_cachelitefunction_temp = $this->translation2->storage;
+
+ $this->_prepare();
+ $res = $this->cacheLiteFunction->call(
+ 'translation2_storage_cachelitefunction_temp->setLang', $langID);
+ if (PEAR::isError($res)) {
+ return $res;
+ }
+ $this->translation2->lang = $res;
+
+ }
+
+ // }}}
+ // {{{ setCacheOption()
+
+ /**
+ * Set a Cache_Lite option
+ *
+ * Passes a Cache_Lite option forward to the Cache_Lite object
+ * See Cache_Lite constructor for available options
+ *
+ * @param string $name name of the option
+ * @param string $value new value of the option
+ *
+ * @return self
+ * @access public
+ * @see Cache_Lite::setOption()
+ */
+ function setCacheOption($name, $value)
+ {
+ $this->_prepare();
+ $this->cacheLiteFunction->setOption($name, $value);
+ return $this;
+ }
+
+ // }}}
+ // {{{ getLang()
+
+ /**
+ * get lang info
+ *
+ * Get some extra information about the language (its full name,
+ * the localized error text, ...)
+ *
+ * @param string $langID language ID
+ * @param string $format ['name', 'meta', 'error_text', 'array']
+ *
+ * @return mixed [string | array], depending on $format
+ */
+ function getLang($langID = null, $format = 'name')
+ {
+ $langs = $this->getLangs('array');
+
+ if (is_null($langID)) {
+ if (!isset($this->lang['id']) || !array_key_exists($this->lang['id'], $langs)) {
+ $msg = 'Translation2::getLang(): unknown language "'.$langID.'".'
+ .' Use Translation2::setLang() to set a default language.';
+ return $this->storage->raiseError($msg, TRANSLATION2_ERROR_UNKNOWN_LANG);
+ }
+ $langID = $this->lang['id'];
+ }
+
+ if ($format == 'array') {
+ return $langs[$langID];
+ } elseif (isset($langs[$langID][$format])) {
+ return $langs[$langID][$format];
+ } elseif (isset($langs[$langID]['name'])) {
+ return $langs[$langID]['name'];
+ }
+ $msg = 'Translation2::getLang(): unknown language "'.$langID.'".'
+ .' Use Translation2::setLang() to set a default language.';
+ return $this->storage->raiseError($msg, TRANSLATION2_ERROR_UNKNOWN_LANG);
+ }
+
+ // }}}
+ // {{{ getLangs()
+
+ /**
+ * get langs
+ *
+ * Get some extra information about the languages (their full names,
+ * the localized error text, their codes, ...)
+ *
+ * @param string $format ['ids', 'names', 'array']
+ *
+ * @return array
+ */
+ function getLangs($format = 'name')
+ {
+ // WITHOUT THIS, IT DOESN'T WORK
+ global $translation2_cachelitefunction_temp;
+ //generate temp variable
+ $translation2_cachelitefunction_temp = $this->translation2;
+
+ $this->_prepare();
+ return $this->cacheLiteFunction->call('translation2_cachelitefunction_temp->getLangs',
+ $format);
+ }
+
+ // }}}
+ // {{{ getRaw()
+
+ /**
+ * Get translated string (as-is)
+ *
+ * First check if the string is cached, if not => fetch the page
+ * from the container and cache it for later use.
+ *
+ * @param string $stringID string ID
+ * @param string $pageID page/group ID
+ * @param string $langID language ID
+ * @param string $defaultText Text to display when the strings in both
+ * the default and the fallback lang are empty
+ *
+ * @return string
+ */
+ function getRaw($stringID, $pageID = TRANSLATION2_DEFAULT_PAGEID, $langID = null, $defaultText = '')
+ {
+ // WITHOUT THIS, IT DOESN'T WORK
+ global $translation2_cachelitefunction_temp;
+ //generate temp variable
+ $translation2_cachelitefunction_temp = $this->translation2;
+
+ if ($pageID == TRANSLATION2_DEFAULT_PAGEID) {
+ $pageID = $this->translation2->currentPageID;
+ }
+ $langID = empty($langID) ? $this->translation2->lang['id'] : $langID;
+
+ $this->_prepare();
+
+ return $this->cacheLiteFunction->call('translation2_cachelitefunction_temp->getRaw',
+ $stringID, $pageID, $langID, $defaultText);
+ }
+
+ // }}}
+ // {{{ get()
+
+ /**
+ * Get translated string
+ *
+ * First check if the string is cached, if not => fetch the page
+ * from the container and cache it for later use.
+ *
+ * @param string $stringID string ID
+ * @param string $pageID page/group ID
+ * @param string $langID language ID
+ * @param string $defaultText Text to display when the strings in both
+ * the default and the fallback lang are empty
+ *
+ * @return string
+ */
+ function get($stringID, $pageID = TRANSLATION2_DEFAULT_PAGEID, $langID = null, $defaultText = '')
+ {
+ // WITHOUT THIS, IT DOESN'T WORK
+ global $translation2_cachelitefunction_temp;
+ //generate temp variable
+ $translation2_cachelitefunction_temp = $this->translation2->storage;
+
+ if ($pageID == TRANSLATION2_DEFAULT_PAGEID) {
+ $pageID = $this->translation2->currentPageID;
+ }
+ $langID = empty($langID) ? $this->translation2->lang['id'] : $langID;
+
+ $this->_prepare();
+
+ $string = $this->cacheLiteFunction->call('translation2_cachelitefunction_temp->getOne',
+ $stringID, $pageID, $langID);
+ if (empty($string)) {
+ return $defaultText;
+ }
+ return $this->translation2->_replaceParams($string);
+ }
+
+ // }}}
+ // {{{ getRawPage()
+
+ /**
+ * Get the array of strings in a page
+ *
+ * First check if the strings are cached, if not => fetch the page
+ * from the container and cache it for later use.
+ *
+ * @param string $pageID page/group ID
+ * @param string $langID language ID
+ *
+ * @return array
+ */
+ function getRawPage($pageID = TRANSLATION2_DEFAULT_PAGEID, $langID = null)
+ {
+ // WITHOUT THIS, IT DOESN'T WORK
+ global $translation2_cachelitefunction_temp;
+ //generate temp variable
+ $translation2_cachelitefunction_temp = $this->translation2;
+
+ if ($pageID == TRANSLATION2_DEFAULT_PAGEID) {
+ $pageID = $this->translation2->currentPageID;
+ }
+ $langID = empty($langID) ? $this->translation2->lang['id'] : $langID;
+
+ $this->_prepare();
+
+ return $this->cacheLiteFunction->call('translation2_cachelitefunction_temp->getRawPage',
+ $pageID, $langID);
+ }
+
+ // }}}
+ // {{{ getPage()
+
+ /**
+ * Same as getRawPage, but resort to fallback language and
+ * replace parameters when needed
+ *
+ * @param string $pageID page/group ID
+ * @param string $langID language ID
+ *
+ * @return array
+ */
+ function getPage($pageID = TRANSLATION2_DEFAULT_PAGEID, $langID = null)
+ {
+ // WITHOUT THIS, IT DOESN'T WORK
+ global $translation2_cachelitefunction_temp;
+ //generate temp variable
+ $translation2_cachelitefunction_temp = $this->translation2;
+
+ if ($pageID == TRANSLATION2_DEFAULT_PAGEID) {
+ $pageID = $this->translation2->currentPageID;
+ }
+ $langID = empty($langID) ? $this->translation2->lang['id'] : $langID;
+
+ $this->_prepare();
+
+ return $this->cacheLiteFunction->call('translation2_cachelitefunction_temp->getPage',
+ $pageID, $langID);
+ }
+
+ // }}}
+ // {{{ getStringID()
+
+ /**
+ * Get translated string
+ *
+ * @param 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.
+ * @param string $pageID page/group ID
+ *
+ * @return string
+ */
+ function getStringID($string, $pageID=TRANSLATION2_DEFAULT_PAGEID)
+ {
+ // WITHOUT THIS, IT DOESN'T WORK
+ global $translation2_cachelitefunction_temp;
+ //generate temp variable
+ $translation2_cachelitefunction_temp = $this->translation2;
+
+ if ($pageID == TRANSLATION2_DEFAULT_PAGEID) {
+ $pageID = $this->translation2->currentPageID;
+ }
+ $this->_prepare();
+
+ return $this->cacheLiteFunction->call('translation2_cachelitefunction_temp->getStringID',
+ $string, $pageID);
+ }
+
+ // }}}
+ // {{{ _cleanCache()
+
+ /**
+ * Statistically purge the cache
+ *
+ * @return void
+ */
+ function _cleanCache()
+ {
+ if ($this->cleaningFrequency > 0) {
+ if (mt_rand(1, $this->cleaningFrequency) == 1) {
+ $this->cacheLiteFunction->clean($this->defaultGroup);
+ }
+ }
+ }
+
+ // }}}
+}
+?>
\ No newline at end of file
diff --git a/Translation2/Decorator/CacheMemory.php b/Translation2/Decorator/CacheMemory.php
new file mode 100644
index 0000000..e9eaab1
--- /dev/null
+++ b/Translation2/Decorator/CacheMemory.php
@@ -0,0 +1,229 @@
+
+ * @copyright 2004-2007 Lorenzo Alberton
+ * @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
+ * @version CVS: $Id$
+ * @link http://pear.php.net/package/Translation2
+ */
+
+/**
+ * Load Translation2 decorator base class
+ */
+require_once 'Translation2/Decorator.php';
+
+/**
+ * Allows redefinition of alternate key for empty pageID
+ */
+if (!defined('TRANSLATION2_EMPTY_PAGEID_KEY')) {
+ define('TRANSLATION2_EMPTY_PAGEID_KEY', 'array_key_4_empty_pageID');
+}
+/**
+ * Allows redefinition of alternate key for null pageID
+ */
+if (!defined('TRANSLATION2_NULL_PAGEID_KEY')) {
+ define('TRANSLATION2_NULL_PAGEID_KEY', 'array_key_4_null_pageID');
+}
+
+/**
+ * Decorator to cache fetched data in memory
+ *
+ * @category Internationalization
+ * @package Translation2
+ * @author Lorenzo Alberton
+ * @copyright 2004-2007 Lorenzo Alberton
+ * @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
+ * @version CVS: $Id$
+ * @link http://pear.php.net/package/Translation2
+ */
+class Translation2_Decorator_CacheMemory extends Translation2_Decorator
+{
+ // {{{ class vars
+
+ /**
+ * Translated strings array
+ * Used for cache purposes.
+ * No parameter substitution or fallback langs here.
+ * @var array
+ * @access protected
+ */
+ var $rawData = array();
+
+ /**
+ * set prefetch on/off
+ * @var boolean
+ * @access protected
+ */
+ var $prefetch = true;
+
+ // }}}
+ // {{{ _getPageIDKey()
+
+ /**
+ * return a valid array key based on pageID value
+ *
+ * @param mixed $pageID (string or null)
+ *
+ * @return string
+ * @access private
+ */
+ function _getPageIDKey($pageID)
+ {
+ if (is_null($pageID)) {
+ return TRANSLATION2_NULL_PAGEID_KEY;
+ }
+ if (empty($pageID)) {
+ return TRANSLATION2_EMPTY_PAGEID_KEY;
+ }
+ if ($pageID == TRANSLATION2_DEFAULT_PAGEID) {
+ return $this->translation2->currentPageID;
+ }
+ return $pageID;
+ }
+
+ // }}}
+ // {{{ getRaw()
+
+ /**
+ * Get translated string (as-is)
+ *
+ * First check if the string is cached, if not => fetch the page
+ * from the container and cache it for later use.
+ *
+ * @param string $stringID string ID
+ * @param string $pageID page/group ID
+ * @param string $langID language ID
+ * @param string $defaultText Text to display when the strings in both
+ * the default and the fallback lang are empty
+ *
+ * @return string
+ */
+ function getRaw($stringID, $pageID = TRANSLATION2_DEFAULT_PAGEID, $langID = null, $defaultText = null)
+ {
+ $pageID_key = $this->_getPageIDKey($pageID);
+ $langID_key = empty($langID) ? $this->translation2->lang['id'] : $langID;
+
+ if (!array_key_exists($langID_key, $this->rawData)) {
+ $this->rawData[$langID_key] = array();
+ }
+
+ if ($this->prefetch) {
+ $this->getRawPage($pageID, $langID);
+ }
+ if (array_key_exists($pageID_key, $this->rawData[$langID_key])) {
+ if (PEAR::isError($this->rawData[$langID_key][$pageID_key])) {
+ return $this->rawData[$langID_key][$pageID_key];
+ }
+ $str = (isset($this->rawData[$langID_key][$pageID_key][$stringID]) ?
+ $this->rawData[$langID_key][$pageID_key][$stringID] : ''); //empty string or null value?
+ } else {
+ $str = $this->translation2->getRaw($stringID, $pageID, $langID, $defaultText);
+ }
+ return $str;
+ }
+
+ // }}}
+ // {{{ get()
+
+ /**
+ * Get translated string
+ *
+ * First check if the string is cached, if not => fetch the page
+ * from the container and cache it for later use.
+ *
+ * @param string $stringID string ID
+ * @param string $pageID page/group ID
+ * @param string $langID language ID
+ * @param string $defaultText Text to display when the strings in both
+ * the default and the fallback lang are empty
+ *
+ * @return string
+ */
+ function get($stringID, $pageID = TRANSLATION2_DEFAULT_PAGEID, $langID = null, $defaultText = null)
+ {
+ $str = $this->getRaw($stringID, $pageID, $langID, $defaultText);
+ return $this->_replaceParams($str);
+ }
+
+ // }}}
+ // {{{ getRawPage()
+
+ /**
+ * Get the array of strings in a page
+ *
+ * First check if the strings are cached, if not => fetch the page
+ * from the container and cache it for later use.
+ *
+ * @param string $pageID page/group ID
+ * @param string $langID language ID
+ *
+ * @return array
+ */
+ function getRawPage($pageID = TRANSLATION2_DEFAULT_PAGEID, $langID = null)
+ {
+ $pageID_key = $this->_getPageIDKey($pageID);
+ $langID_key = empty($langID) ? $this->translation2->lang['id'] : $langID;
+
+ if (!array_key_exists($langID_key, $this->rawData)) {
+ $this->rawData[$langID_key] = array();
+ }
+ if (!array_key_exists($pageID_key, $this->rawData[$langID_key])) {
+ $this->rawData[$langID_key][$pageID_key] =
+ $this->translation2->getRawPage($pageID, $langID);
+ }
+ return $this->rawData[$langID_key][$pageID_key];
+ }
+
+ // }}}
+ // {{{ getPage()
+
+ /**
+ * Same as getRawPage, but resort to fallback language and
+ * replace parameters when needed
+ *
+ * @param string $pageID page/group ID
+ * @param string $langID language ID
+ *
+ * @return array
+ */
+ function getPage($pageID = TRANSLATION2_DEFAULT_PAGEID, $langID = null)
+ {
+ $pageID_key = $this->_getPageIDKey($pageID);
+ $langID_key = empty($langID) ? $this->translation2->lang['id'] : $langID;
+
+ $this->getRawPage($pageID, $langID);
+ return $this->_replaceParams($this->rawData[$langID_key][$pageID_key]);
+ }
+
+ // }}}
+}
+?>
\ No newline at end of file
diff --git a/Translation2/Decorator/DefaultText.php b/Translation2/Decorator/DefaultText.php
new file mode 100644
index 0000000..4ba46a9
--- /dev/null
+++ b/Translation2/Decorator/DefaultText.php
@@ -0,0 +1,196 @@
+
+ * @author Rolf 'Red' Ochsenbein
+ * @copyright 2004-2007 Lorenzo Alberton, Rolf 'Red' Ochsenbein
+ * @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
+ * @version CVS: $Id$
+ * @link http://pear.php.net/package/Translation2
+ */
+
+/**
+ * Load Translation2 decorator base class
+ */
+require_once 'Translation2/Decorator.php';
+
+/**
+ * Decorator to provide a fallback text for empty strings.
+ *
+ * If the string is empty, return the defaultText parameter.
+ * If the defaultText parameter is empty too, then return
+ * "$emptyPostfix.$outputString.$emptyPrefix", the three variables
+ * being class properties you can set to a custom string.
+ *
+ * @category Internationalization
+ * @package Translation2
+ * @author Lorenzo Alberton
+ * @author Rolf 'Red' Ochsenbein
+ * @copyright 2004-2007 Lorenzo Alberton, Rolf 'Red' Ochsenbein
+ * @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
+ * @version CVS: $Id$
+ * @link http://pear.php.net/package/Translation2
+ */
+class Translation2_Decorator_DefaultText extends Translation2_Decorator
+{
+ // {{{ class vars
+
+ /**
+ * String appended to the returned string when the string is empty
+ * and it's replaced by its $stringID. It can be used to mark unreplaced
+ * strings.
+ * @var string
+ * @access protected
+ */
+ var $emptyPostfix = '';
+
+ /**
+ * String prepended to the returned string when the string is empty
+ * and it's replaced by its $stringID. It can be used to mark unreplaced
+ * strings.
+ * @var string
+ * @access protected
+ */
+ var $emptyPrefix = '';
+
+ /**
+ * String to output when there was no translation
+ * %stringID% will be replaced with the stringID
+ * %stringID_url% will replaced with a urlencoded stringID
+ * %url% will be replaced with the targeted url
+ * @var string
+ * @access protected
+ */
+ //var $outputString = '%stringID%(T)';
+ var $outputString = '%stringID%';
+
+ /**
+ * Targeted URL of strings without translations
+ * @var string
+ * @access protected
+ */
+ var $url = '#';
+
+ // }}}
+ // {{{ get()
+
+ /**
+ * Get translated string
+ *
+ * If the string is empty, return the $defaultText if not empty,
+ * the $stringID otherwise.
+ *
+ * @param string $stringID string ID
+ * @param string $pageID page/group ID
+ * @param string $langID language ID
+ * @param string $defaultText Text to display when the string is empty
+ *
+ * @return string
+ */
+ function get($stringID, $pageID = TRANSLATION2_DEFAULT_PAGEID, $langID = null, $defaultText = '')
+ {
+ if ($pageID == TRANSLATION2_DEFAULT_PAGEID) {
+ $pageID = $this->translation2->currentPageID;
+ }
+ $str = $this->translation2->get($stringID, $pageID, $langID);
+ if (!empty($str)) {
+ return $str;
+ }
+ if (!empty($defaultText)) {
+ return $this->_replaceParams($defaultText);
+ }
+
+ $search = array(
+ '%stringID%',
+ '%stringID_url%',
+ '%pageID_url%',
+ '%url%'
+ );
+ $replace = array(
+ $stringID,
+ urlencode($stringID),
+ urlencode($pageID),
+ $this->url
+ );
+ return $this->_replaceParams(
+ $this->emptyPrefix
+ .str_replace($search, $replace, $this->outputString)
+ .$this->emptyPostfix
+ );
+ //$str = (empty($defaultText) ? $this->emptyPrefix.$stringID.$this->emptyPostfix : $defaultText);
+ }
+
+ // }}}
+ // {{{ getPage()
+
+ /**
+ * Replace empty strings with their $stringID
+ *
+ * @param string $pageID page/group ID
+ * @param string $langID language ID
+ *
+ * @return array
+ */
+ function getPage($pageID = TRANSLATION2_DEFAULT_PAGEID, $langID = null)
+ {
+ $data = $this->translation2->getPage($pageID, $langID);
+ return $this->replaceEmptyStringsWithKeys($data);
+ }
+
+ // }}}
+ // {{{ getStringID
+
+ /**
+ * Get the stringID for the given string. This method is the reverse of get().
+ * If the requested string is unknown to the system,
+ * the requested string will be returned.
+ *
+ * @param 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.
+ * @param string $pageID page/group ID
+ *
+ * @return string
+ */
+ function &getStringID($string, $pageID = TRANSLATION2_DEFAULT_PAGEID)
+ {
+ if ($pageID == TRANSLATION2_DEFAULT_PAGEID) {
+ $pageID = $this->translation2->currentPageID;
+ }
+ $stringID = $this->storage->getStringID($string, $pageID);
+ if (empty($stringID)) {
+ $stringID = $string;
+ }
+ return $stringID;
+ }
+}
+?>
\ No newline at end of file
diff --git a/Translation2/Decorator/ErrorText.php b/Translation2/Decorator/ErrorText.php
new file mode 100644
index 0000000..386a183
--- /dev/null
+++ b/Translation2/Decorator/ErrorText.php
@@ -0,0 +1,108 @@
+
+ * @copyright 2004-2007 Lorenzo Alberton
+ * @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
+ * @version CVS: $Id$
+ * @link http://pear.php.net/package/Translation2
+ */
+
+/**
+ * Load Translation2 decorator base class
+ */
+require_once 'Translation2/Decorator.php';
+
+/**
+ * Decorator to provide a fallback text for empty strings.
+ *
+ * @category Internationalization
+ * @package Translation2
+ * @author Lorenzo Alberton
+ * @copyright 2004-2007 Lorenzo Alberton
+ * @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
+ * @version CVS: $Id$
+ * @link http://pear.php.net/package/Translation2
+ */
+class Translation2_Decorator_ErrorText extends Translation2_Decorator
+{
+ // {{{ get()
+
+ /**
+ * Get translated string
+ *
+ * If the string is empty, return the error message
+ *
+ * @param string $stringID string ID
+ * @param string $pageID page/group ID
+ * @param string $langID language ID
+ * @param string $defaultText Text to display when the string is empty
+ *
+ * @return string
+ */
+ function get($stringID, $pageID = TRANSLATION2_DEFAULT_PAGEID, $langID = null, $defaultText = '')
+ {
+ $str = $this->translation2->get($stringID, $pageID, $langID, $defaultText);
+ if (empty($str)) {
+ $str = $this->translation2->getLang(null, 'error_text');
+ }
+ return $str;
+ }
+
+ // }}}
+ // {{{ getPage()
+
+ /**
+ * Same as getRawPage, but resort to fallback language and
+ * replace parameters when needed
+ *
+ * @param string $pageID page/group ID
+ * @param string $langID language ID
+ *
+ * @return array
+ */
+ function getPage($pageID = TRANSLATION2_DEFAULT_PAGEID, $langID = null)
+ {
+ $data = $this->translation2->getPage($pageID, $langID);
+ if (PEAR::isError($data)) {
+ return $data;
+ }
+ $error_text = str_replace('"', '\"', $this->translation2->getLang(null, 'error_text'));
+ array_walk(
+ $data,
+ create_function('&$w', 'if (empty($w)) $w = "'.$error_text.'";')
+ );
+ return $data;
+ }
+
+ // }}}
+}
+?>
\ No newline at end of file
diff --git a/Translation2/Decorator/Iconv.php b/Translation2/Decorator/Iconv.php
new file mode 100644
index 0000000..e97da41
--- /dev/null
+++ b/Translation2/Decorator/Iconv.php
@@ -0,0 +1,156 @@
+
+ * @author Sergey Korotkov
+ * @copyright 2004-2007 Lorenzo Alberton, Sergey Korotkov
+ * @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
+ * @version CVS: $Id$
+ * @link http://pear.php.net/package/Translation2
+ */
+
+/**
+ * Load Translation2 decorator base class
+ */
+require_once 'Translation2/Decorator.php';
+
+/**
+ * Translation2 Iconv Decorator
+ *
+ * Decorator to change the encoding of the stored translation to the
+ * one given in the 'encoding' option.
+ *
+ *
+ * $tr->setOptions(array('encoding' => 'UTF-8'));
+ *
+ *
+ * @category Internationalization
+ * @package Translation2
+ * @author Lorenzo Alberton
+ * @author Sergey Korotkov
+ * @copyright 2004-2007 Lorenzo Alberton, Sergey Korotkov
+ * @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
+ * @version CVS: $Id$
+ * @link http://pear.php.net/package/Translation2
+ * @see http://www.php.net/htmlentities for a list of available encodings.
+ */
+class Translation2_Decorator_Iconv extends Translation2_Decorator
+{
+ // {{{ class vars
+
+ /**
+ * @var string
+ * @access private
+ */
+ var $encoding = 'ISO-8859-1';
+
+ /**
+ * @var array
+ * @access private
+ */
+ var $lang_encodings;
+
+ // }}}
+ // {{{ _getEncoding()
+
+ /**
+ * Get the encoding for the given langID
+ *
+ * @param string $langID language ID
+ *
+ * @return string encoding
+ * @access private
+ */
+ function _getEncoding($langID = null)
+ {
+ if (!is_array($this->lang_encodings)) {
+ $this->lang_encodings = array();
+ foreach ($this->translation2->getLangs('encodings') as $langID => $encoding) {
+ $this->lang_encodings[$langID] = $encoding;
+ }
+ }
+ if (!is_null($langID) && isset($this->lang_encodings[$langID])) {
+ return $this->lang_encodings[$langID];
+ }
+ return $this->lang['encoding'];
+ }
+
+ // }}}
+ // {{{ get()
+
+ /**
+ * Get the translated string, in the new encoding
+ *
+ * @param string $stringID string ID
+ * @param string $pageID page/group ID
+ * @param string $langID language ID
+ * @param string $defaultText Text to display when the string is empty
+ *
+ * @return string
+ */
+ function get($stringID, $pageID = TRANSLATION2_DEFAULT_PAGEID, $langID = null, $defaultText = null)
+ {
+ $str = $this->translation2->get($stringID, $pageID, $langID, $defaultText);
+ if (PEAR::isError($str) || empty($str)) {
+ return $str;
+ }
+ return iconv($this->_getEncoding($langID), $this->encoding, $str);
+ }
+
+ // }}}
+ // {{{ getPage()
+
+ /**
+ * Same as getRawPage, but apply transformations when needed
+ *
+ * @param string $pageID page/group ID
+ * @param string $langID language ID
+ *
+ * @return array
+ */
+ function getPage($pageID = TRANSLATION2_DEFAULT_PAGEID, $langID = null)
+ {
+ $data = $this->translation2->getPage($pageID, $langID);
+ if (PEAR::isError($data)) {
+ return $data;
+ }
+ $input_encoding = $this->_getEncoding($langID);
+ foreach (array_keys($data) as $k) {
+ if (!empty($data[$k])) {
+ $data[$k] = iconv($input_encoding, $this->encoding, $data[$k]);
+ }
+ }
+ return $data;
+ }
+
+ // }}}
+}
+?>
\ No newline at end of file
diff --git a/Translation2/Decorator/Lang.php b/Translation2/Decorator/Lang.php
new file mode 100644
index 0000000..6cc6710
--- /dev/null
+++ b/Translation2/Decorator/Lang.php
@@ -0,0 +1,149 @@
+
+ * @copyright 2004-2007 Lorenzo Alberton
+ * @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
+ * @version CVS: $Id$
+ * @link http://pear.php.net/package/Translation2
+ */
+
+/**
+ * Load Translation2 decorator base class
+ */
+require_once 'Translation2/Decorator.php';
+
+/**
+ * Decorator to provide a fallback language for empty strings.
+ *
+ * @category Internationalization
+ * @package Translation2
+ * @author Lorenzo Alberton
+ * @copyright 2004-2007 Lorenzo Alberton
+ * @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
+ * @version CVS: $Id$
+ * @link http://pear.php.net/package/Translation2
+ */
+class Translation2_Decorator_Lang extends Translation2_Decorator
+{
+ // {{{ class vars
+
+ /**
+ * fallback lang
+ * @var string
+ * @access protected
+ */
+ var $fallbackLang;
+
+ // }}}
+ // {{{ setOption()
+
+ /**
+ * set Decorator option (intercept 'fallbackLang' option).
+ * I don't know why it's needed, but it doesn't work without.
+ *
+ * @param string $option option name
+ * @param mixed $value option value
+ *
+ * @return self
+ */
+ function setOption($option, $value=null)
+ {
+ if ($option == 'fallbackLang') {
+ $this->fallbackLang = $value;
+ return $this;
+ }
+ return parent::setOption($option, $value);
+ }
+
+ // }}}
+ // {{{ get()
+
+ /**
+ * Get translated string
+ *
+ * If the string is empty, check the fallback language
+ *
+ * @param string $stringID string ID
+ * @param string $pageID page/group ID
+ * @param string $langID language ID
+ * @param string $defaultText Text to display when the strings in both
+ * the default and the fallback lang are empty
+ *
+ * @return string
+ */
+ function get($stringID, $pageID = TRANSLATION2_DEFAULT_PAGEID, $langID = null, $defaultText = '')
+ {
+ $str = $this->translation2->get($stringID, $pageID, $langID, $defaultText);
+ if (empty($str)) {
+ $str = $this->translation2->get($stringID, $pageID, $this->fallbackLang);
+ }
+ return $str;
+ }
+
+ // }}}
+ // {{{ getPage()
+
+ /**
+ * Same as getRawPage, but resort to fallback language and
+ * replace parameters when needed
+ *
+ * @param string $pageID page/group ID
+ * @param string $langID language ID
+ *
+ * @return array
+ */
+ function getPage($pageID = TRANSLATION2_DEFAULT_PAGEID, $langID = null)
+ {
+ $data1 = $this->translation2->getPage($pageID, $langID);
+ if (PEAR::isError($data1)) {
+ return $data1;
+ }
+ $data2 = $this->translation2->getPage($pageID, $this->fallbackLang);
+ if (PEAR::isError($data2)) {
+ return $data2;
+ }
+ foreach ($data1 as $key => $val) {
+ if (empty($val)) {
+ $data1[$key] = $data2[$key];
+ }
+ }
+ // append keys when fallback lang contains more than current
+ $diff = array_diff(array_keys($data2), array_keys($data1));
+ foreach ($diff as $key) {
+ $data1[$key] = $data2[$key];
+ }
+ return $data1;
+ }
+
+ // }}}
+}
+?>
\ No newline at end of file
diff --git a/Translation2/Decorator/SpecialChars.php b/Translation2/Decorator/SpecialChars.php
new file mode 100644
index 0000000..d08894f
--- /dev/null
+++ b/Translation2/Decorator/SpecialChars.php
@@ -0,0 +1,125 @@
+
+ * @copyright 2004-2007 Lorenzo Alberton
+ * @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
+ * @version CVS: $Id$
+ * @link http://pear.php.net/package/Translation2
+ */
+
+/**
+ * Load Translation2 decorator base class
+ */
+require_once 'Translation2/Decorator.php';
+
+/**
+ * Decorator to replace special chars with the matching html entities.
+ *
+ * You can set the charset to use (the default being 'ISO-8859-1'):
+ *
+ * $tr->setOptions(array('charset' => 'UTF-8'));
+ *
+ *
+ * @category Internationalization
+ * @package Translation2
+ * @author Lorenzo Alberton
+ * @copyright 2004-2007 Lorenzo Alberton
+ * @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
+ * @version CVS: $Id$
+ * @link http://pear.php.net/package/Translation2
+ * @see http://www.php.net/htmlentities for a list of available charsets.
+ */
+class Translation2_Decorator_SpecialChars extends Translation2_Decorator
+{
+ // {{{ class vars
+
+ /**
+ * @var string
+ * @access protected
+ */
+ var $charset = 'ISO-8859-1';
+
+ // }}}
+ // {{{ get()
+
+ /**
+ * Get translated string
+ *
+ * replace special chars with the matching html entities
+ *
+ * @param string $stringID string ID
+ * @param string $pageID page/group ID
+ * @param string $langID language ID
+ * @param string $defaultText Text to display when the string is empty
+ *
+ * @return string
+ */
+ function get($stringID, $pageID=TRANSLATION2_DEFAULT_PAGEID, $langID=null, $defaultText=null)
+ {
+ $str = $this->translation2->get($stringID, $pageID, $langID, $defaultText);
+ if (PEAR::isError($str)) {
+ return $str;
+ }
+ if (!empty($str)) {
+ $str = htmlentities($str, ENT_QUOTES, $this->charset);
+ }
+ return $str;
+ }
+
+ // }}}
+ // {{{ getPage()
+
+ /**
+ * Same as getRawPage, but apply transformations when needed
+ *
+ * @param string $pageID page/group ID
+ * @param string $langID language ID
+ *
+ * @return array
+ */
+ function getPage($pageID=TRANSLATION2_DEFAULT_PAGEID, $langID=null)
+ {
+ $data = $this->translation2->getPage($pageID, $langID);
+ if (PEAR::isError($data)) {
+ return $data;
+ }
+ foreach ($data as $key => $val) {
+ if (!empty($val)) {
+ $data[$key] = htmlentities($val, ENT_QUOTES, $this->charset);
+ }
+ }
+ return $data;
+ }
+
+ // }}}
+}
+?>
\ No newline at end of file
diff --git a/Translation2/Decorator/UTF8.php b/Translation2/Decorator/UTF8.php
new file mode 100644
index 0000000..c834bea
--- /dev/null
+++ b/Translation2/Decorator/UTF8.php
@@ -0,0 +1,114 @@
+
+ * @copyright 2004-2007 Lorenzo Alberton
+ * @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
+ * @version CVS: $Id$
+ * @link http://pear.php.net/package/Translation2
+ */
+
+/**
+ * Load Translation2 decorator base class
+ */
+require_once 'Translation2/Decorator.php';
+
+/**
+ * Decorator to convert UTF-8 strings to ISO-8859-1
+ *
+ * @category Internationalization
+ * @package Translation2
+ * @author Lorenzo Alberton
+ * @copyright 2004-2007 Lorenzo Alberton
+ * @license http://www.debian.org/misc/bsd.license BSD License (3 Clause)
+ * @version CVS: $Id$
+ * @link http://pear.php.net/package/Translation2
+ */
+class Translation2_Decorator_UTF8 extends Translation2_Decorator
+{
+ // {{{ get()
+
+ /**
+ * Get translated string
+ *
+ * Decode the UTF-8 string to ISO-8859-1
+ *
+ * @param string $stringID string ID
+ * @param string $pageID page/group ID
+ * @param string $langID language ID
+ * @param string $defaultText Text to display when the strings in both
+ * the default and the fallback lang are empty
+ *
+ * @return string
+ */
+ function get($stringID, $pageID = TRANSLATION2_DEFAULT_PAGEID, $langID = null, $defaultText = null)
+ {
+ $str = $this->translation2->get($stringID, $pageID, $langID);
+ if (PEAR::isError($str)) {
+ return $str;
+ }
+ if (!empty($str)) {
+ $str = utf8_decode($str); //decodes an UTF-8 string to ISO-8859-1
+ }
+ return $str;
+ }
+
+ // }}}
+ // {{{ getPage()
+
+ /**
+ * Same as getRawPage, but resort to fallback language and
+ * replace parameters when needed
+ *
+ * Decode each UTF-8 string in the group to ISO-8859-1
+ *
+ * @param string $pageID page/group ID
+ * @param string $langID language ID
+ *
+ * @return array
+ */
+ function getPage($pageID = TRANSLATION2_DEFAULT_PAGEID, $langID = null)
+ {
+ $data = $this->translation2->getPage($pageID, $langID);
+ if (PEAR::isError($data)) {
+ return $data;
+ }
+ foreach ($data as $key => $val) {
+ if (!empty($val)) {
+ $data[$key] = utf8_decode($val);
+ }
+ }
+ return $data;
+ }
+
+ // }}}
+}
+?>
\ No newline at end of file
diff --git a/package.xml b/package.xml
index 313eb22..de173b6 100644
--- a/package.xml
+++ b/package.xml
@@ -57,7 +57,7 @@ Req #16787 default 'latin1_swedish_ci' db created with collation set t
utf8_unicode_ci - quipo
-
+
@@ -124,7 +124,7 @@ utf8_unicode_ci - quipo
-
+