*
* Handles multi-language support using flat files *
* -------------------------------------------------------------------------*
* This library is part of the phpGroupWare API *
* http://www.phpgroupware.org/api *
* ------------------------------------------------------------------------ *
* This library is free software; you can redistribute it and/or modify it *
* under the terms of the GNU Lesser General Public License as published by *
* the Free Software Foundation; either version 2.1 of the License, *
* or any later version. *
* This library 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 Lesser General Public License for more details. *
* You should have received a copy of the GNU Lesser General Public License *
* along with this library; if not, write to the Free Software Foundation, *
* Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA *
\**************************************************************************/
/* $Id$ */
// This should be considered experimental. It works, at the app level.
// But, for admin and prefs it really slows things down. See the note
// in the translate() function.
// To use, set $GLOBALS['phpgw_info']["server"]["translation_system"] = "file"; in
// class.translation.inc.php
class translation
{
var $langarray; // Currently loaded translations
var $loaded_apps = array(); // Loaded app langs
/*!
@function translate
@abstract Translate phrase to user selected lang
@param $key phrase to translate
@param $vars vars sent to lang function, passed to us
*/
function translation($appname='phpgwapi',$loadlang='')
{
global $lang;
if($loadlang)
{
$lang = $loadlang;
}
$this->add_app($appname,$lang);
}
function translate($key, $vars=False)
{
global $lang;
if (!@in_array($GLOBALS['phpgw_info']['flags']['currentapp'],$this->loaded_apps) &&
$GLOBALS['phpgw_info']['flags']['currentapp'] != 'home')
{
//echo '
loading app "' . $GLOBALS['phpgw_info']['flags']['currentapp'] . '" for the first time.';
$this->add_app($GLOBALS['phpgw_info']['flags']['currentapp'],$lang);
}
elseif ($GLOBALS['phpgw_info']['flags']['currentapp'] == 'admin' ||
$GLOBALS['phpgw_info']['flags']['currentapp'] == 'preferences')
{
// This is done because for these two apps, all langs must be loaded.
// Note we cannot load for navbar, since it would slow down EVERY page.
// This is true until all common/admin/prefs langs are in the api file only.
@ksort($GLOBALS['phpgw_info']['apps']);
while(list($x,$app) = each($GLOBALS['phpgw_info']['apps']))
{
if (!@in_array($app['name'],$this->loaded_apps))
{
//echo '
loading app "' . $app['name'] . '" for the first time.';
$this->add_app($app['name'],$lang);
}
}
}
if (!$vars)
{
$vars = array();
}
$ret = $key;
if (isset($this->langarray[strtolower ($key)]) && $this->langarray[strtolower ($key)])
{
$ret = $this->langarray[strtolower ($key)];
}
else
{
$ret = $key."*";
}
$ndx = 1;
while( list($key,$val) = each( $vars ) )
{
$ret = preg_replace( "/%$ndx/", $val, $ret );
++$ndx;
}
return $ret;
}
/*!
@function add_app
@abstract loads all app phrases into langarray
@param $lang user lang variable (defaults to en)
*/
function add_app($app,$lang='')
{
define('SEP',filesystem_separator());
//echo '
add_app(): called with app="' . $app . '", lang="' . $userlang . '"';
if (!isset($lang) || !$lang)
{
if (isset($GLOBALS['phpgw_info']['user']['preferences']['common']['lang']) &&
$GLOBALS['phpgw_info']['user']['preferences']['common']['lang'])
{
$userlang = $GLOBALS['phpgw_info']['user']['preferences']['common']['lang'];
}
else
{
$userlang = 'en';
}
}
else
{
$userlang = $lang;
}
$fn = PHPGW_SERVER_ROOT . SEP . $app . SEP . 'setup' . SEP . 'phpgw_' . $userlang . '.lang';
if (!file_exists($fn))
{
$fn = PHPGW_SERVER_ROOT . SEP . $app . SEP . 'setup' . SEP . 'phpgw_en.lang';
}
if (file_exists($fn))
{
$fp = fopen($fn,'r');
while ($data = fgets($fp,8000))
{
list($message_id,$app_name,$null,$content) = explode("\t",$data);
//echo '
add_app(): adding phrase: $this->langarray["'.$message_id.'"]=' . trim($content);
$this->langarray[$message_id] = trim($content);
}
fclose($fp);
}
// stuff class array listing apps that are included already
$this->loaded_apps[] = $app;
}
}
?>