class.ilMultilingualism.php

Go to the documentation of this file.

<?php

/* Copyright (c) 1998-2014 ILIAS open source, Extended GPL, see docs/LICENSE */

class ilMultilingualism
{
        protected $db;
        protected $obj_id;
        protected $languages = array();
        protected $type = "";
        static protected $instances = array();

        private function __construct($a_obj_id, $a_type)
        {
                global $ilDB;

                $this->db = $ilDB;

                $this->setObjId($a_obj_id);
                $this->setType($a_type);

                if ($this->getObjId() <= 0)
                {
                        include_once("./Services/Object/exceptions/class.ilObjectException.php");
                        throw new ilObjectException("ilObjectTranslation: No object ID passed.");
                }

                $this->read();
        }

        static function getInstance($a_obj_id, $a_type)
        {
                if (!isset(self::$instances[$a_type][$a_obj_id]))
                {
                        self::$instances[$a_type][$a_obj_id] = new self($a_obj_id, $a_type);
                }

                return self::$instances[$a_type][$a_obj_id];
        }


        function setObjId($a_val)
        {
                $this->obj_id = $a_val;
        }

        function getObjId()
        {
                return $this->obj_id;
        }

        function setLanguages(array $a_val)
        {
                $this->languages = $a_val;
        }

        function getLanguages()
        {
                return $this->languages;
        }

        public function getType()
        {
                return $this->type;
        }

        public function setType($type)
        {
                $this->type = $type;
        }
        
        public function getDefaultLanguage()
        {
                global $lng;
                
                foreach($this->languages as $k => $v)
                {
                        if($v["lang_default"])
                        {
                                return $k;
                        }
                }
                
                return $lng->getDefaultLanguage();
        }


        function addLanguage($a_lang, $a_title, $a_description, $a_default, $a_force = false)
        {
                if ($a_lang != "" && (!isset($this->languages[$a_lang]) || $a_force))
                {
                        if ($a_default)
                        {
                                foreach ($this->languages as $k => $l)
                                {
                                        $this->languages[$k]["lang_default"] = false;
                                }
                        }
                        $this->languages[$a_lang] = array("lang_code" => $a_lang, "lang_default" => $a_default,
                                "title" => $a_title, "description" => $a_description);
                }
        }

        function getDefaultTitle()
        {
                foreach ($this->languages as $l)
                {
                        if ($l["lang_default"])
                        {
                                return $l["title"];
                        }
                }
                return "";
        }

        function setDefaultTitle($a_title)
        {
                foreach ($this->languages as $k => $l)
                {
                        if ($l["lang_default"])
                        {
                                $this->languages[$k]["title"] = $a_title;
                        }
                }
        }

        function getDefaultDescription()
        {
                foreach ($this->languages as $l)
                {
                        if ($l["lang_default"])
                        {
                                return $l["description"];
                        }
                }
                return "";
        }

        function setDefaultDescription($a_description)
        {
                foreach ($this->languages as $k => $l)
                {
                        if ($l["lang_default"])
                        {
                                $this->languages[$k]["description"] = $a_description;
                        }
                }
        }


        function removeLanguage($a_lang)
        {
                if($a_lang != $this->getDefaultLanguage())
                {
                        unset($this->languages[$a_lang]);
                }
        }

        function read()
        {
                $this->setLanguages(array());
                $set = $this->db->query("SELECT * FROM il_translations ".
                        " WHERE id = ".$this->db->quote($this->getObjId(), "integer") .
                        " AND id_type = " . $this->db->quote($this->getType(), "text")
                );
                while ($rec = $this->db->fetchAssoc($set))
                {
                        $this->addLanguage($rec["lang_code"], $rec["title"], $rec["description"], $rec["lang_default"]);
                }
        }

        function delete()
        {
                $this->db->manipulate("DELETE FROM il_translations ".
                        " WHERE id = ".$this->db->quote($this->getObjId(), "integer").
                        " AND id_type = " . $this->db->quote($this->getType(), "text")
                );
        }

        function save()
        {
                $this->delete();

                foreach ($this->getLanguages() as $l => $trans)
                {
                        $this->db->manipulate($t = "INSERT INTO il_translations ".
                                "(id, id_type, title, description, lang_code, lang_default) VALUES (".
                                $this->db->quote($this->getObjId(), "integer").",".
                                $this->db->quote($this->getType(), "text").",".
                                $this->db->quote($trans["title"], "text").",".
                                $this->db->quote($trans["description"], "text").",".
                                $this->db->quote($l, "text").",".
                                $this->db->quote($trans["lang_default"], "integer").
                                ")");
                }
        }

        function copy($a_obj_id)
        {
                $target_ml = new self($a_obj_id, $this->getType());
                $target_ml->setLanguages($this->getLanguages());
                $target_ml->save();
                return $target_ml;
        }


        
        public function toXml(ilXmlWriter $writer)
        {
                $writer->xmlStartTag('translations');
                
                foreach ($this->getLanguages() as $k => $v)
                {
                        $writer->xmlStartTag('translation',array('language' => $k, 'default' => $v['lang_default'] ? 1 : 0));
                        $writer->xmlElement('title',array(),$v['title']);
                        $writer->xmlElement('description', array(), $v['description']);
                        $writer->xmlEndTag('translation');
                }
                $writer->xmlEndTag('translations');

                return $writer;
        }

        public function fromXML(SimpleXMLElement $root)
        {
                if($root->translations)
                {
                        $root = $root->translations;
                }
                
                foreach($root->translation as $trans)
                {
                        $this->addLanguage(
                                (string)trim($trans["language"]),
                                (string)trim($trans->title),
                                (string)trim($trans->description),
                                (int)$trans["default"] != 0?true:false
                                );
                }
        }

}

?>