class.ilComponent.php

Go to the documentation of this file.

<?php
/*
        +-----------------------------------------------------------------------------+
        | ILIAS open source                                                           |
        +-----------------------------------------------------------------------------+
        | Copyright (c) 1998-2008 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. |
        +-----------------------------------------------------------------------------+
*/


define ("IL_COMP_MODULE", "Modules");
define ("IL_COMP_SERVICE", "Services");
define ("IL_COMP_PLUGIN", "Plugins");

abstract class ilComponent
{
        abstract function getVersion();
        
        abstract function isCore();
        
        abstract static function getComponentType();
        
        abstract function getName();

        function __construct()
        {
                global $ilDB;
                
                $set = $ilDB->query("SELECT * FROM il_component WHERE type = ".
                        $ilDB->quote($this->getComponentType())." AND name = ".
                        $ilDB->quote($this->getName()));
                        
                $rec = $set->fetchRow(DB_FETCHMODE_ASSOC);

                $this->setId($rec["id"]);
                $this->setPluginSlots(ilComponent::lookupPluginSlots(
                        $this->getComponentType(), $this->getName()));
        }
        
        final function setId($a_id)
        {
                $this->id = $a_id;
        }

        final function getId()
        {
                return $this->id;
        }

        final function setPluginSlots($a_pluginslots)
        {
                $this->pluginslots = $a_pluginslots;
        }

        final function getPluginSlots()
        {
                return $this->pluginslots;
        }

        final static function getComponentObject($a_ctype, $a_cname)
        {
                global $ilDB;
                
                // this check is done due to security reasons
                $set = $ilDB->query("SELECT * FROM il_component WHERE type = ".
                        $ilDB->quote($a_ctype)." AND name = ".$ilDB->quote($a_cname));
                if ($set->numRows() == 0)
                {
                        return null;
                }
                
                switch ($a_ctype)
                {
                        case IL_COMP_MODULE:
                                if (is_file("./Modules/".$a_cname."/classes/class.il".$a_cname."Module.php"))
                                {
                                        include_once("./Modules/".$a_cname."/classes/class.il".$a_cname."Module.php");
                                        $class = "il".$a_cname."Module";
                                        $comp = new $class();
                                        return $comp;
                                }
                                break;
                                
                        case IL_COMP_SERVICE:
                                if (is_file("./Services/".$a_cname."/classes/class.il".$a_cname."Service.php"))
                                {
                                        include_once("./Services/".$a_cname."/classes/class.il".$a_cname."Service.php");
                                        $class = "il".$a_cname."Service";
                                        $comp = new $class();
                                        return $comp;
                                }
                                break;
                }
                
                return null;
        }

        function setSubDirectory($a_subdirectory)
        {
                $this->subdirectory = $a_subdirectory;
        }

        function getSubDirectory()
        {
                return $this->subdirectory;
        }
        
        static function lookupPluginSlots($a_type, $a_name)
        {
                global $ilDB;
                
                $set = $ilDB->query("SELECT * FROM il_pluginslot WHERE component = ".
                        $ilDB->quote($a_type."/".$a_name));
                $ps = array();
//echo "<br>".$a_type."/".$a_name;
                while($rec = $set->fetchRow(DB_FETCHMODE_ASSOC))
                {
                        $rec["dir"] = "Customizing/global/plugins/".$a_type."/".$a_name."/".$rec["name"];
                        $rec["dir_pres"] = "Customizing/global/plugins/<br />".$a_type."/".$a_name."/".$rec["name"];
                        $rec["lang_prefix"] = ilComponent::lookupId($a_type,$a_name)."_".$rec["id"]."_";
                        $ps[$rec["id"]] = $rec;
                }
                return $ps;
        }
        
        function getPluginSlotName($a_id)
        {
                $slots = $this->getPluginSlots();
                
                return $slots[$a_id]["name"];
        }

        function getPluginSlotDirectory($a_id)
        {
                $slots = $this->getPluginSlots();
                
                return "Customizing/global/plugins/".$this->getComponentType()."/".
                        $this->getName()."/".$slots[$a_id]["name"];
        }
        
        function getPluginSlotLanguagePrefix($a_id)
        {
                $slots = $this->getPluginSlots();
                return $this->getId()."_".$slots[$a_id]["id"]."_";
        }
        
        static function lookupId($a_type, $a_name)
        {
                global $ilDB;
                
                $set = $ilDB->query("SELECT * FROM il_component WHERE type = ".
                        $ilDB->quote($a_type)." AND name = ".$ilDB->quote($a_name));
                $rec = $set->fetchRow(DB_FETCHMODE_ASSOC);
                
                return $rec["id"];
        }
        
        static final function checkVersionNumber($a_ver)
        {
                global $lng;
                
                $lng->loadLanguageModule("cmps");
                
                $parts = explode(".", $a_ver);
                
                if (count($parts) != 3)
                {
                        return $lng->txt("cmps_version_nr_format_error");
                }
                
                if (!is_numeric($parts[0]) || !is_numeric($parts[1]) || !is_numeric($parts[2]))
                {
                        return $lng->txt("cmps_version_nr_parts_not_numeric");
                }
                
                return $parts;
        }

        static final function isVersionGreaterString($a_ver1, $a_ver2)
        {
                $a_arr1 = ilComponent::checkVersionNumber($a_ver1);
                $a_arr2 = ilComponent::checkVersionNumber($a_ver2);
                if (is_array($a_arr1) && is_array($a_arr2))
                {
                        return ilComponent::isVersionGreater($a_arr1, $a_arr2);
                }
                else
                {
                        return false;
                }
        }

        static final function isVersionGreater($a_ver1, $a_ver2)
        {
                if ($a_ver1[0] > $a_ver2[0])
                {
                        return true;
                }
                else if ($a_ver1[0] < $a_ver2[0])
                {
                        return false;
                }
                else if ($a_ver1[1] > $a_ver2[1])
                {
                        return true;
                }
                else if ($a_ver1[1] < $a_ver2[1])
                {
                        return false;
                }
                else if ($a_ver1[2] > $a_ver2[2])
                {
                        return true;
                }

                return false;
        }

}
?>