class.ilObjLanguageExt.php

Go to the documentation of this file.

<?php
/*
        +-----------------------------------------------------------------------------+
        | ILIAS open source                                                           |
        +-----------------------------------------------------------------------------+
        | Copyright (c) 1998-2001 ILIAS open source, University of Cologne            |
        |                                                                             |
        | 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. |
        +-----------------------------------------------------------------------------+
*/

require_once "./Services/Language/classes/class.ilObjLanguage.php";

class ilObjLanguageExt extends ilObjLanguage
{
        
        function ilObjLanguageExt($a_id = 0, $a_call_by_reference = false)
        {
                $this->ilObjLanguage($a_id, $a_call_by_reference);
        }
        
        public function getGlobalLanguageFile()
        {
                require_once "./Services/Language/classes/class.ilLanguageFile.php";
                return ilLanguageFile::_getGlobalLanguageFile($this->key);
        }

        public function setLocal($a_local = true)
        {
                if ($this->isInstalled())
                {
                        if ($a_local == true)
                        {
                                $this->setDescription("installed_local");
                        }
                        else
                        {
                $this->setDescription("installed");
                        }
                        $this->update();
                }
        }

        
        public function getLongDescription()
        {
                return $this->lng->txt($this->desc);
        }
        
        public function getLangPath()
        {
                return $this->lang_path;
        }

        public function getCustLangPath()
        {
                return $this->cust_lang_path;
        }

        public function getAllValues($a_modules = array(), $a_pattern = '')
        {
                return self::_getValues($this->key, $a_modules, NULL, $a_pattern);
        }
        
        
        public function getChangedValues($a_modules = array(), $a_pattern = '')
        {
                return self::_getValues($this->key, $a_modules, NULL, $a_pattern, 'changed');
        }


        public function getUnchangedValues($a_modules = array(), $a_pattern = '')
        {
                return self::_getValues($this->key, $a_modules, NULL, $a_pattern, 'unchanged');
        }


        public function getCommentedValues($a_modules = array(), $a_pattern = '')
        {
                $global_file_obj = $this->getGlobalLanguageFile();
                $global_values = $global_file_obj->getAllValues();
                $local_values = self::_getValues($this->key, $a_modules, NULL, $a_pattern);

                $commented = array();
                foreach ($local_values as $key => $value)
                {
                        if ($global_comments[$key] != "")
                        {
                                $commented[$key] = $value;
                        }
                }
                return $commented;
        }
        

        public function importLanguageFile($a_file, $a_mode_existing = 'keepnew')
        {
                global $ilDB, $ilErr;

                // read the new language file
                require_once "./Services/Language/classes/class.ilLanguageFile.php";
                $import_file_obj = new ilLanguageFile($a_file);
                if (!$import_file_obj->read())
                {
                        $ilErr->raiseError($import_file_obj->getErrorMessage(),$ilErr->MESSAGE);
                }

                switch($a_mode_existing)
                {
                        // keep all existing entries
                        case 'keepall':
                                $to_keep = $this->getAllValues();
                                break;

                        // keep existing online changes
                        case 'keepnew':
                                $to_keep = $this->getChangedValues();
                                break;

                        // replace all existing definitions
                        case 'replace':
                            $to_keep = array();
                            break;

           // delete all existing entries
                        case 'delete':
                                $query = "DELETE FROM lng_data WHERE lang_key='".$this->key."'";
                                $ilDB->query($query);
                                $query = "DELETE FROM lng_modules WHERE lang_key='".$this->key."'";
                                $ilDB->query($query);
                                $to_keep = array();
                                break;
                                
                        default:
                            return;
                }
                
                // process the values of the import file
                $to_save = array();
                foreach ($import_file_obj->getAllValues() as $key => $value)
                {
                        if (!isset($to_keep[$key]))
                        {
                                $to_save[$key] = $value;
                        }
                }
                self::_saveValues($this->key, $to_save);
        }

        public static function _getModules($a_lang_key)
        {
                global $ilDB;
                
                $q = "SELECT DISTINCT module FROM lng_data WHERE ".
                        " lang_key = ".$ilDB->quote($a_lang_key).
                        " order by module";
                $set = $ilDB->query($q);

                while ($rec = $set->fetchRow(DB_FETCHMODE_ASSOC))
                {
                        $modules[] = $rec["module"];
                }
                return $modules;
        }

        public static function _getValues($a_lang_key,
                        $a_modules = array(), $a_topics = array(),
                        $a_pattern = '', $a_state = '')
        {
                global $ilDB, $lng;

                if (is_array($a_modules))
                {
                        for ($i = 0; $i < count($a_modules); $i++)
                        {
                                $a_modules[$i] = $ilDB->quote($a_modules[$i]);
                        }
            $modules_list = implode(',', $a_modules);
                }
                if (is_array($a_topics))
                {
                        for ($i = 0; $i < count($a_topics); $i++)
                        {
                                $a_topics[$i] = $ilDB->quote($a_topics[$i]);
                        }
                        $topics_list = implode(',', $a_topics);
                }

                $q = "SELECT * FROM lng_data WHERE".
                        " lang_key =".$ilDB->quote($a_lang_key);
                if ($modules_list)
                {
                        $q .= " AND module in (". $modules_list. ")";
                }
                if ($topics_list)
                {
                        $q .= " AND identifier in (". $topics_list. ")";
                }
                if ($a_pattern)
                {
                        $q .= " AND value like ". $ilDB->quote("%".$a_pattern."%");
                }
                if ($a_state == "changed")
                {
                        $q .= " AND local_change <> '0000-00-00 00:00:00'";
                }
                if ($a_state == "unchanged")
                {
                        $q .= " AND local_change = '0000-00-00 00:00:00'";
                }
                $q .= " ORDER BY module, identifier";
                $set = $ilDB->query($q);

                $values = array();
                while ($rec = $set->fetchRow(DB_FETCHMODE_ASSOC))
                {
                        $values[$rec["module"].$lng->separator.$rec["identifier"]] = $rec["value"];
                }
                return $values;
        }

        public static function _saveValues($a_lang_key, $a_values = array())
        {
                global $ilDB, $lng;
                
                if (!is_array($a_values))
                {
                        return;
                }
                $save_array = array();
                $save_date = date("Y-m-d H:i:s", time());
                
                // read and get the global values
                require_once "./Services/Language/classes/class.ilLanguageFile.php";
                $global_file_obj = ilLanguageFile::_getGlobalLanguageFile($a_lang_key);
                $global_values = $global_file_obj->getAllValues();
                
                // save the single translations in lng_data
                foreach ($a_values as $key => $value)
                {
                        $keys = explode($lng->separator, $key);
                        if (count($keys) == 2)
                        {
                                $module = $keys[0];
                                $topic = $keys[1];
                                $save_array[$module][$topic] = $value;
                                $local_change = $global_values[$key] == $value ?
                                                                "0000-00-00 00:00:00" : $save_date;
                        
                                $q = "REPLACE INTO lng_data(lang_key, module, identifier, value, local_change)"
                                . " VALUES("
                                . $ilDB->quote($a_lang_key). ","
                                . $ilDB->quote($module). ","
                                . $ilDB->quote($topic). ","
                                . $ilDB->quote($value). ","
                                . $ilDB->quote($local_change). ")";
                                $ilDB->query($q);
                        }
                }

                // save the serialized module entries in lng_modules
                foreach ($save_array as $module => $entries)
                {
                        $q = "SELECT * FROM lng_modules WHERE ".
                                " lang_key = ".$ilDB->quote($a_lang_key).
                                " AND module = ".$ilDB->quote($module);
                        $set = $ilDB->query($q);
                        $row = $set->fetchRow(DB_FETCHMODE_ASSOC);
                        $arr = unserialize($row["lang_array"]);
                        if (is_array($arr))
                        {
                                $entries = array_merge($arr, $entries);
                        }
                        $q = "REPLACE INTO lng_modules (lang_key, module, lang_array) VALUES ".
                                 "(".$ilDB->quote($a_lang_key).", " .
                                 " ".$ilDB->quote($module).", " .
                                 " ".$ilDB->quote(serialize($entries)).") ";
                        $ilDB->query($q);
                }
        }
} // END class.ilObjLanguageExt
?>