class.ilLanguage.php

Go to the documentation of this file.

<?php
/* Copyright (c) 1998-2009 ILIAS open source, Extended GPL, see docs/LICENSE */


class ilLanguage
{
        var $ilias;
        
        var $text;
        
        var $lang_default;

        var $lang_user;

        var $lang_path;

        var $lang_key;

        var $lang_name;

        var $separator = "#:#";
        
        var $comment_separator = "###";

        var $loaded_modules;

        function ilLanguage($a_lang_key)
        {
                global $ilias,$log,$ilIliasIniFile,$ilUser,$ilSetting;

                // store used modules and topics in a global variable
                // ($lng seems to be initialized more than once)
                global $ilias_lang_used_topics;
                global $ilias_lang_used_modules;
                $this->used_topics =& $ilias_lang_used_topics;
                $this->used_modules =& $ilias_lang_used_modules;

                $this->ilias =& $ilias;

                if (!isset($log))
                {
                        if (is_object($ilias))
                        {
                                require_once "./Services/Logging/classes/class.ilLog.php";
                                $this->log = new ilLog(ILIAS_LOG_DIR,ILIAS_LOG_FILE,$ilias->getClientId(),ILIAS_LOG_ENABLED);
                        }
                }
                else
                {
                        $this->log =& $log;
                }

                $this->lang_key = $a_lang_key;
                
                $this->text = array();
                $this->loaded_modules = array();
                //$this->lang_path = ILIAS_ABSOLUTE_PATH.substr($this->ilias->ini->readVariable("language","path"),1);

                // if no directory was found fall back to default lang dir
                //if (!is_dir($this->lang_path))
                //{
                        $this->lang_path = ILIAS_ABSOLUTE_PATH."/lang";
                //}
                $this->cust_lang_path = ILIAS_ABSOLUTE_PATH."/Customizing/global/lang";

                $this->lang_default = $ilIliasIniFile->readVariable("language","default");
                if (is_object($ilSetting) && $ilSetting->get("language") != "")
                {
                        $this->lang_default = $ilSetting->get("language");
                }
                $this->lang_user = $ilUser->prefs["language"];
                
                $langs = $this->getInstalledLanguages();
                
                if (!in_array($this->lang_key,$langs))
                {
                        $this->lang_key = $this->lang_default;
                }

                $this->loadLanguageModule("common");

                return true;
        }

        function getLangKey()
        {
                return $this->lang_key;
        }
        
        function getDefaultLanguage()
        {
                return $this->lang_default ? $this->lang_default : 'en';
        }
        
        function txtlng($a_module, $a_topic, $a_language)
        {
                if (strcmp($a_language, $this->lang_key) == 0)
                {
                        return $this->txt($a_topic);
                }
                else
                {
                        return ilLanguage::_lookupEntry($a_language, $a_module, $a_topic);
                }
        }

        function txt($a_topic, $a_default_lang_fallback_mod = "")
        {
                if (empty($a_topic))
                {
                        return "";
                }

                // remember the used topics
                $this->used_topics[$a_topic] = $a_topic;

                $translation = "";
                if (isset($this->text[$a_topic]))
                {
                        $translation = $this->text[$a_topic];
                }

                if ($translation == "" && $a_default_lang_fallback_mod != "")
                {
                        // #13467 - try current language first (could be missing module)
                        if($this->lang_key != $this->lang_default)
                        {
                                $translation = ilLanguage::_lookupEntry($this->lang_key,
                                        $a_default_lang_fallback_mod, $a_topic);
                        }                       
                        // try default language last
                        if($translation == "" || $translation == "-".$a_topic."-")
                        {
                                $translation = ilLanguage::_lookupEntry($this->lang_default,
                                        $a_default_lang_fallback_mod, $a_topic);
                        }               
                }


                if ($translation == "")
                {
                        if (ILIAS_LOG_ENABLED && is_object($this->log))
                        {
                                $this->log->writeLanguageLog($a_topic,$this->lang_key);
                        }
                        return "-".$a_topic."-";
                }
                else
                {
                        return $translation;
                }
        }
        
        public function exists($a_topic)
        {
                return isset($this->text[$a_topic]);
        }
        
        function loadLanguageModule ($a_module)
        {
                global $ilDB;

                if (in_array($a_module, $this->loaded_modules))
                {
                        return;
                }

                $this->loaded_modules[] = $a_module;

                // remember the used modules globally
                $this->used_modules[$a_module] = $a_module;

                $lang_key = $this->lang_key;

                if (empty($this->lang_key))
                {
                        $lang_key = $this->lang_user;
                }

/*
                $query = "SELECT identifier,value FROM lng_data " .
                                "WHERE lang_key = '" . $lang_key."' " .
                                "AND module = '$a_module'";
                $r = $this->ilias->db->query($query);

                while ($row = $r->fetchRow(DB_FETCHMODE_OBJECT))
                {
                        $this->text[$row->identifier] = $row->value;
                }
*/

                $q = "SELECT * FROM lng_modules " .
                                "WHERE lang_key = ".$ilDB->quote($lang_key, "text")." AND module = ".
                                $ilDB->quote($a_module, "text");
                $r = $ilDB->query($q);
                $row = $r->fetchRow(DB_FETCHMODE_ASSOC);
                
                $new_text = unserialize($row["lang_array"]);
                if (is_array($new_text))
                {
                        $this->text = array_merge($this->text, $new_text);
                }
        }
        
        
        function getInstalledLanguages()
        {
                include_once("./Services/Object/classes/class.ilObject.php");
                $langlist = ilObject::_getObjectsByType("lng");
                
                foreach ($langlist as $lang)
                {
                        if (substr($lang["desc"], 0, 9) == "installed")
                        {
                                $languages[] = $lang["title"];
                        }
                
                }

                return $languages ? $languages : array();
        }
        
        function _lookupEntry($a_lang_key, $a_mod, $a_id)
        {
                global $ilDB;
                
                $set = $ilDB->query($q = sprintf("SELECT * FROM lng_data WHERE module = %s ".
                        "AND lang_key = %s AND identifier = %s",
                        $ilDB->quote((string) $a_mod, "text"), $ilDB->quote((string) $a_lang_key, "text"),
                        $ilDB->quote((string) $a_id, "text")));
                $rec = $ilDB->fetchAssoc($set);
                
                if ($rec["value"] != "")
                {
                        // remember the used topics
                        $this->used_topics[$a_id] = $a_id;
                        $this->used_modules[$a_mod] = $a_mod;
                        
                        return $rec["value"];
                }
                
                return "-".$a_id."-";
        }

        public static function lookupId($a_lang_key)
        {
                global $ilDB;

                $query = 'SELECT obj_id FROM object_data '.' '.
                'WHERE title = '.$ilDB->quote($a_lang_key, 'text').' '.
                        'AND type = '.$ilDB->quote('lng','text');

                $res = $ilDB->query($query);
                while($row = $res->fetchRow(DB_FETCHMODE_OBJECT))
                {
                        return $row->obj_id;
                }
                return 0;
        }


        function getUsedTopics()
        {
                if (is_array($this->used_topics))
                {
                        asort($this->used_topics);
                        return $this->used_topics;
                }
                else
                {
                        return array();
                }
        }
        
        function getUsedModules()
        {
                if (is_array($this->used_modules))
                {
                        asort($this->used_modules);
                        return $this->used_modules;
                }
                else
                {
                        return array();
                }
        }

        function getUserLanguage()
        {
                return $this->lang_user;
        }

        
} // END class.Language
?>