Source for file translation.inc.php

<?php
/* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
SVN Web Control
Copyright ©2006 by sTEFANs
Created on 25.02.2006
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
This program 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 2 of the License, or
(at your option) any later version.
 
This program 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 this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330,
Boston, MA 02111-1307, USA.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
*/
 
/**
 * This file provides functions to translate several string or URLs.
 * The translations themself could be in according files to ease
 * the access and provide a well done structure.
 * 
 * @package Swc
 * @subpackage Inc
 * @author Stefan Schraml
 * @copyright Copyright ©2006 by sTEFANs
 * @license http://opensource.org/licenses/lgpl-license.php GNU General Public License
 * @version v1.0.0
 * @since v1.0.0
 */
 
    /** 
     * Formats a given timestamp into a localized format.
     * @param boolean $short Whether or not (default) the timestamp
     *  should be returned in short or long format.
   * @return string Formatted timestamp string.
   * 
     * @since v1.0.0
     */
    function GetLocalizedTimestamp($timestamp, $short = false){
      LoadTranslationResource();
      return FormatTimestamp($timestamp, $short);
  }
 
    /** 
     * Translates the given ID to the language
     * set in the browser or to english as default language.<br><br>
     * <b>Parameters</b>:This function needs the ID for the
     * string to translate as first argument. Any
     * further arguments are passed to <i>sprintf</i>
     * to format the string with values.<br>
     * If no parameter is applied, an error text
     * (not translated) is returned.
     * 
     * @since v1.0.0
     */
    function T(){
      LoadTranslationResource();
        $arg_cnt = func_num_args();
        $args = func_get_args();
        if ($arg_cnt == 0){
            return "NO-KEY";
        }
        $args[0] = Translate($args[0]);
        if ($arg_cnt == 1){
            return $args[0];
        }
        return call_user_func_array('sprintf', $args);
    }
    
    /** 
     * Determines the languages accepted by the browser.
     * @return array Array of languages accepted by the browser
     *  order by relevance or an empty array if the browser
     *  does not determine accepted languages.
     * 
     * @since v1.0.0
     */
     function &GetBrowserLanguages(){
         static $langs = NULL;
         if ($langs == NULL){
             $langs = array();
             if (isset($_SERVER['HTTP_ACCEPT_LANGUAGE'])){
                 $countries = array();
                 $lang_str = $_SERVER['HTTP_ACCEPT_LANGUAGE'];
                 $langs = explode(',', $lang_str);
                 foreach($langs as $key => $lang){
                     $tmp = explode(';', $lang);
                     $langs[$key] = $tmp[0];
                     // Get country only
                     $tmp = explode('-', $tmp[0]);
                     if (count($tmp) > 1){
                         $countries[] = $tmp[0];
                     }
                 }
                 // Remove double countries
                 foreach($countries as $key => $country){
                     if (array_search($country, $langs) != NULL){
                         unset($countries[$key]);
                     }
                 }
                 $langs = array_merge($langs, $countries);
             }             
         }
         return $langs;
     }
     
    /** 
     * Loads the best fitting translation table resource.
     * The best fitting translation table is the table that
     * 1. meets the country and language code exactly
     * 2. meets the country code only
     * 3. is the default language
     * in this order.<br>
     * Translation tables are looked up in folder
     * <b>STD_RESOURCE_PATH</b> defined in
     * <b>inc/var.inc.php</b>. The name of the file
     * should be in format <b>country-language.php</b>
     * or <b>country</b>, both in ISO 2 letter code
     * as used by browsers.<br>
     * US English for instance is coded <b>en-us</b>,
     * default English is coded <b>en</b>.
     * Translation tables for a language without
     * a country code should be provided.<br>
     * The filename is case insensitive.
     * The file name of the default translation
     * table is defined in <b>inc/var.inc.php</b>
     * by <b>STD_TRANSLATION_TABLE</b>.
     * @return string Code of the loaded language
     * 
     * @since v1.0.0
     */
      function LoadTranslationResource(){
          static $language_code = NULL;
          if ($language_code == NULL){
              $browser_langs = GetBrowserLanguages();
              if ($browser_langs != NULL){
                  $idx = 0;
                  while($idx < count($browser_langs) && $language_code == NULL){
                      $path = STD_RESOURCE_PATH.$browser_langs[$idx].'.php';
                      if (file_exists($path)){
                          include_once($path);
                          $language_code = $browser_langs[$idx];
                      }
                      $idx++;
                  }
              }
              if ($language_code == NULL){
                    include_once(STD_RESOURCE_PATH.STD_TRANSLATION_TABLE);
                  $language_code = 'en';
              }
          }
          return $language_code;
      }
      
?>