class.ilPlugin.php

Go to the documentation of this file.

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


include_once("./Services/Component/classes/class.ilComponent.php");
include_once("./Services/Component/exceptions/class.ilPluginException.php");

abstract class ilPlugin
{
        protected $lang_initialised = false;
        
        final function __construct()
        {
                $this->__init();
        }

        abstract function getComponentType();

        abstract function getComponentName();

        abstract function getSlot();

        abstract function getSlotId();
        
        abstract function getPluginName();

        private final function setId($a_id)
        {
                $this->id = $a_id;
        }

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

        private final function setLastUpdateVersion($a_lastupdateversion)
        {
                $this->lastupdateversion = $a_lastupdateversion;
        }

        final function getLastUpdateVersion()
        {
                return $this->lastupdateversion;
        }

        private final function setVersion($a_version)
        {
                $this->version = $a_version;
        }

        final function getVersion()
        {
                return $this->version;
        }

        private final function setIliasMinVersion($a_iliasminversion)
        {
                $this->iliasminversion = $a_iliasminversion;
        }

        final function getIliasMinVersion()
        {
                return $this->iliasminversion;
        }

        private final function setIliasMaxVersion($a_iliasmaxversion)
        {
                $this->iliasmaxversion = $a_iliasmaxversion;
        }

        final function getIliasMaxVersion()
        {
                return $this->iliasmaxversion;
        }

        private final function setActive($a_active)
        {
                $this->active = $a_active;
        }

        final function getActive()
        {
                return $this->active;
        }
        
        protected final function setSlotObject($a_slot)
        {
                $this->slot = $a_slot;
        }

        protected final function getSlotObject()
        {
                return $this->slot;
        }
        
        final function setDBVersion($a_dbversion)
        {
                $this->dbversion = $a_dbversion;
        }

        final function getDBVersion()
        {
                return $this->dbversion;
        }

        final function writeDBVersion($a_dbversion)
        {
                global $ilDB;
                
                $this->setDBVersion($a_dbversion);
                
                $q = "UPDATE il_plugin SET db_version = ".$ilDB->quote((int) $this->getDBVersion(), "integer").
                        " WHERE component_type = ".$ilDB->quote($this->getComponentType(), "text").
                        " AND component_name = ".$ilDB->quote($this->getComponentName(), "text").
                        " AND slot_id = ".$ilDB->quote($this->getSlotId(), "text").
                        " AND name = ".$ilDB->quote($this->getPluginName(), "text");

                $ilDB->manipulate($q);
        }

        
        public final function getDirectory()
        {
                return $this->getSlotObject()->getPluginsDirectory()."/".$this->getPluginName();
        }
        
        static public final function _getDirectory($a_ctype, $a_cname, $a_slot_id, $a_pname)
        {
                include_once "Services/Component/classes/class.ilPluginSlot.php";
                return ilPluginSlot::_getPluginsDirectory($a_ctype, $a_cname, $a_slot_id)."/".$a_pname;         
        }
        

        protected final function getClassesDirectory()
        {
                return $this->getDirectory()."/classes";
        }
        
        public final function includeClass($a_class_file_name)
        {
                include_once($this->getClassesDirectory()."/".$a_class_file_name);
        }

        protected final function getLanguageDirectory()
        {
                return $this->getDirectory()."/lang";
        }
        
        static final function getAvailableLangFiles($a_lang_directory)
        {
                $langs = array();

                if (!@is_dir($a_lang_directory))
                {
                        return array();
                }

                $dir = opendir($a_lang_directory);
                while($file = readdir($dir))
                {
                        if ($file != "." and
                                $file != "..")
                        {
                                // directories
                                if (@is_file($a_lang_directory."/".$file))
                                {
                                        if (substr($file, 0, 6) == "ilias_" &&
                                                substr($file, strlen($file) - 5) == ".lang")
                                        {
                                                $langs[] = array("key" => substr($file, 6, 2), "file" => $file,
                                                        "path" => $a_lang_directory."/".$file);
                                        }
                                }
                        }
                }

                return $langs;
        }

        static final function hasConfigureClass($a_slot_dir, $a_name)
        {
                if (is_file($a_slot_dir."/".
                        $a_name."/classes/class.il".$a_name."ConfigGUI.php"))
                {
                        return true;
                }
                return false;
        }

        static final function getConfigureClassName($a_name)
        {
                return "il".$a_name."ConfigGUI";
        }

        final function getPrefix()
        {
                return $this->getSlotObject()->getPrefix()."_".$this->getId();
        }

        static public final function getDBUpdateScriptName($a_ctype, $a_cname, $a_slot_name, $a_pname)
        {
                return "Customizing/global/plugins/".$a_ctype."/".$a_cname."/".
                        $a_slot_name."/".$a_pname."/sql/dbupdate.php";
        }

        final function getTablePrefix()
        {
                return $this->getPrefix();
        }
        
        final public function updateLanguages()
        {
                global $ilCtrl;
                
                include_once("./Services/Language/classes/class.ilObjLanguage.php");
                
                $langs = $this->getAvailableLangFiles($this->getLanguageDirectory());
                
                $prefix = $this->getPrefix();
                
                foreach($langs as $lang)
                {
                        $txt = file($this->getLanguageDirectory()."/".$lang["file"]);
                        $lang_array = array();

                        // get language data
                        if (is_array($txt))
                        {
                                foreach ($txt as $row)
                                {
                                        if ($row[0] != "#" && strpos($row, "#:#") > 0)
                                        {
                                                $a = explode("#:#",trim($row));
                                                $lang_array[$prefix."_".trim($a[0])] = trim($a[1]);
                                                ilObjLanguage::replaceLangEntry($prefix, $prefix."_".trim($a[0]),
                                                        $lang["key"], trim($a[1]));
//echo "<br>-$prefix-".$prefix."_".trim($a[0])."-".$lang["key"]."-";
                                        }
                                }
                        }

                        ilObjLanguage::replaceLangModule($lang["key"], $prefix,
                                $lang_array);
                }
        }
        
        function updateDatabase()
        {
                global $ilDB, $lng;
                
                include_once("./Services/Component/classes/class.ilPluginDBUpdate.php");
                $dbupdate = new ilPluginDBUpdate($this->getComponentType(),
                        $this->getComponentName(), $this->getSlotId(),
                        $this->getPluginName(), $ilDB, true, $this->getTablePrefix());
                
                //$dbupdate->getDBVersionStatus();
                //$dbupdate->getCurrentVersion();
                
                $result = $dbupdate->applyUpdate();

                if ($dbupdate->updateMsg == "no_changes")
                {
                        $message = $lng->txt("no_changes").". ".$lng->txt("database_is_uptodate");
                }
                else
                {
                        foreach ($dbupdate->updateMsg as $row)
                        {
                                $message .= $lng->txt($row["msg"]).": ".$row["nr"]."<br/>";
                        }
                }
                
                $this->message.= $message;

                return $result;
        }
        
        public final function loadLanguageModule()
        {
                global $lng;
                
                if (!$this->lang_initialised && is_object($lng))
                {
                        $lng->loadLanguageModule($this->getPrefix());
                        $this->lang_initialised = true;
                }
        }
        
        public final function txt($a_var)
        {
                global $lng;
                $this->loadLanguageModule();
                return $lng->txt($this->getPrefix()."_".$a_var, $this->getPrefix());
        }
        
        static function lookupTxt($a_mod_prefix, $a_pl_id, $a_lang_var)
        {
                global $lng;
                
                // this enables default language fallback
                $prefix = $a_mod_prefix."_".$a_pl_id;
                return $lng->txt($prefix."_".$a_lang_var, $prefix);             
                
                /*
                return $lng->_lookupEntry($lng->lang_key, $a_mod_prefix."_".$a_pl_id,
                        $a_mod_prefix."_".$a_pl_id."_".$a_lang_var);             
                */
        }
        
        public final function getTemplate($a_template, $a_par1 = true, $a_par2 = true)
        {
                $tpl = new ilTemplate($this->getDirectory()."/templates/".$a_template, $a_par1, $a_par2);
                
                return $tpl;
        }

        public static final function _getImagePath($a_ctype, $a_cname, $a_slot_id,
                $a_pname, $a_img)
        {
                $d = ilPlugin::_getDirectory($a_ctype, $a_cname, $a_slot_id, $a_pname);
                return $d."/templates/images/".$a_img;
        }

        public final function getImagePath($a_img)
        {
                return $this->getDirectory()."/templates/images/".$a_img;
        }
        
        public final function getStyleSheetLocation($a_css_file)
        {
                return $this->getDirectory()."/templates/".$a_css_file;
        }

        public final function addBlockFile($a_tpl, $a_var, $a_block, $a_tplname)
        {
                $a_tpl->addBlockFile($a_var, $a_block,
                        $this->getDirectory()."/templates/".$a_tplname);
        }

        static final public function createPluginRecord($a_ctype, $a_cname, $a_slot_id, $a_pname)
        {
                global $ilDB;

                // check record existence record
                $q = "SELECT * FROM il_plugin".
                        " WHERE component_type = ".$ilDB->quote($a_ctype, "text").
                        " AND component_name = ".$ilDB->quote($a_cname, "text").
                        " AND slot_id = ".$ilDB->quote($a_slot_id, "text").
                        " AND name = ".$ilDB->quote($a_pname, "text");
                $set = $ilDB->query($q);
                if (!$rec = $ilDB->fetchAssoc($set))
                {
                        $q = "INSERT INTO il_plugin (component_type, component_name, slot_id, name)".
                                " VALUES (".$ilDB->quote($a_ctype, "text").",".
                                $ilDB->quote($a_cname, "text").",".
                                $ilDB->quote($a_slot_id, "text").",".
                                $ilDB->quote($a_pname, "text").")";
                        $ilDB->manipulate($q);
                }
        }

        
        static final public function getPluginRecord($a_ctype, $a_cname, $a_slot_id, $a_pname)
        {
                global $ilDB;

                // read/set basic data
                $q = "SELECT * FROM il_plugin".
                        " WHERE component_type = ".$ilDB->quote($a_ctype, "text").
                        " AND component_name = ".$ilDB->quote($a_cname, "text").
                        " AND slot_id = ".$ilDB->quote($a_slot_id, "text").
                        " AND name = ".$ilDB->quote($a_pname, "text");
                $set = $ilDB->query($q);
                if ($rec = $ilDB->fetchAssoc($set))
                {
                        return $rec;
                }
                else            // no record? create one
                {
                        // silently create these records is not a good idea, since
                        // the function can be called with "wrong parameters"
                        // raise exceptions instead
                        include_once("./Services/Component/exceptions/class.ilPluginException.php");
                        throw (new ilPluginException("No plugin record found for '".$a_ctype."', '".$a_cname."', '".$a_slot_id."', '".$a_pname."'."));
                        
                        $q = "INSERT INTO il_plugin (component_type, component_name, slot_id, name)".
                                " VALUES (".$ilDB->quote($a_ctype, "text").",".
                                $ilDB->quote($a_cname, "text").",".
                                $ilDB->quote($a_slot_id, "text").",".
                                $ilDB->quote($a_pname, "text").")";
                        $ilDB->manipulate($q);
                        $q = "SELECT * FROM il_plugin".
                                " WHERE component_type = ".$ilDB->quote($a_ctype, "text").
                                " AND component_name = ".$ilDB->quote($a_cname, "text").
                                " AND slot_id = ".$ilDB->quote($a_slot_id, "text").
                                " AND name = ".$ilDB->quote($a_pname, "text");
                        $set = $ilDB->query($q);
                        return $ilDB->fetchAssoc($set);
                }
        }
        
        final private function __init()
        {
                global $ilDB, $lng, $ilPluginAdmin;
                
                // read/set basic data
                $rec = ilPlugin::getPluginRecord($this->getComponentType(),
                        $this->getComponentName(), $this->getSlotId(), $this->getPluginName());
                $this->setLastUpdateVersion($rec["last_update_version"]);
                $this->setDBVersion($rec["db_version"]);
                $this->setActive($rec["active"]);
                
                // get id
                $this->setId($ilPluginAdmin->getId($this->getComponentType(),
                        $this->getComponentName(),
                        $this->getSlotId(),
                        $this->getPluginName()));
                
                // get version
                $this->setVersion($ilPluginAdmin->getVersion($this->getComponentType(),
                        $this->getComponentName(),
                        $this->getSlotId(),
                        $this->getPluginName()));
                        
                // get ilias min version
                $this->setIliasMinVersion($ilPluginAdmin->getIliasMinVersion($this->getComponentType(),
                        $this->getComponentName(),
                        $this->getSlotId(),
                        $this->getPluginName()));

                // get ilias max version
                $this->setIliasMaxVersion($ilPluginAdmin->getIliasMaxVersion($this->getComponentType(),
                        $this->getComponentName(),
                        $this->getSlotId(),
                        $this->getPluginName()));

                // get slot object
                $this->setSlotObject(new ilPluginSlot($this->getComponentType(),
                        $this->getComponentName(), $this->getSlotId()));
                
                // load language module
                
                // Fix for authentication plugins
                $this->loadLanguageModule();
                        
                // call slot and plugin init methods
                $this->slotInit();
                $this->init();
        }

        abstract protected function slotInit();

        protected function init()
        {
        }

        public final function isActive()
        {
                global $ilPluginAdmin;
                
                return $ilPluginAdmin->isActive($this->getComponentType(),
                        $this->getComponentName(), $this->getSlotId(), $this->getPluginName());
        }
        
        public final function needsUpdate()
        {
                global $ilPluginAdmin;
                
                return $ilPluginAdmin->isActive($this->getComponentType(),
                        $this->getComponentName(), $this->getSlotId(), $this->getPluginName());
        }
        
        final function activate()
        {
                global $lng, $ilDB;
                
                $result = true;

                // check whether update is necessary
                if ($this->needsUpdate())
                {
                        //$result = $this->isUpdatePossible();
                        
                        // do update
                        if ($result === true)
                        {
                                $result = $this->update();
                        }
                }
                if ($result === true)
                {
                        $result = $this->beforeActivation();
                        // activate plugin
                        if ($result === true)
                        {
                                $q = "UPDATE il_plugin SET active = ".$ilDB->quote(1, "integer").",".
                                        " plugin_id = ".$ilDB->quote($this->getId(), "text").
                                        " WHERE component_type = ".$ilDB->quote($this->getComponentType(), "text").
                                        " AND component_name = ".$ilDB->quote($this->getComponentName(), "text").
                                        " AND slot_id = ".$ilDB->quote($this->getSlotId(), "text").
                                        " AND name = ".$ilDB->quote($this->getPluginName(), "text");
                                        
                                $ilDB->manipulate($q);
                                $this->afterActivation();
                        }
                }
                return $result;
        }
        
        protected function beforeActivation()
        {
                return true;    // false would indicate that anything went wrong
                                                // activation would not proceed
                                                // throw an exception in this case
                //throw new ilPluginException($lng->txt(""));
        }

        protected function afterActivation()
        {
        }

        final function deactivate()
        {
                global $ilDB;
                
                $result = true;
                
                $q = "UPDATE il_plugin SET active = ".$ilDB->quote(0, "integer").
                        " WHERE component_type = ".$ilDB->quote($this->getComponentType(), "text").
                        " AND component_name = ".$ilDB->quote($this->getComponentName(), "text").
                        " AND slot_id = ".$ilDB->quote($this->getSlotId(), "text").
                        " AND name = ".$ilDB->quote($this->getPluginName(), "text");
                        
                $ilDB->manipulate($q);

                return $result;
        }

        final function update()
        {
                global $ilDB, $ilCtrl;
                
                $result = true;
                
                // DB update
                if ($result === true)
                {
                        $result = $this->updateDatabase();
                }
                
                // Load language files
                $this->updateLanguages();
                
                // load control structure
                include_once("./setup/classes/class.ilCtrlStructureReader.php");
                $structure_reader = new ilCtrlStructureReader();
                $structure_reader->readStructure(true, "./".$this->getDirectory(), $this->getPrefix(),
                        $this->getDirectory());
//              $ilCtrl->storeCommonStructures();

                // add config gui to the ctrl calls
                $ilCtrl->insertCtrlCalls("ilobjcomponentsettingsgui", ilPlugin::getConfigureClassName($this->getPluginName()),
                        $this->getPrefix());
                
                // set last update version to current version
                if ($result === true)
                {
                        $q = "UPDATE il_plugin SET last_update_version = ".$ilDB->quote($this->getVersion(), "text").
                                " WHERE component_type = ".$ilDB->quote($this->getComponentType(), "text").
                                " AND component_name = ".$ilDB->quote($this->getComponentName(), "text").
                                " AND slot_id = ".$ilDB->quote($this->getSlotId(), "text").
                                " AND name = ".$ilDB->quote($this->getPluginName(), "text");
                                
                        $ilDB->manipulate($q);
                }

                return $result;
        }
        
        final static function getPluginObject($a_ctype, $a_cname, $a_slot_id, $a_pname)
        {
                global $ilDB;
                
                include_once("./Services/Component/classes/class.ilPluginSlot.php");
                $slot_name = ilPluginSlot::lookupSlotName($a_ctype, $a_cname, $a_slot_id);
                
                // this check is done due to security reasons
                $set = $ilDB->queryF("SELECT * FROM il_component WHERE type = %s ".
                        " AND name = %s", array("text", "text"),
                        array($a_ctype, $a_cname));
                if (!$ilDB->fetchAssoc($set))
                {
                        return null;
                }
                
                $file = "./Customizing/global/plugins/".$a_ctype."/".
                        $a_cname."/".$slot_name."/".
                        $a_pname."/classes/class.il".$a_pname."Plugin.php";

                if (is_file($file))
                {
                        include_once($file);
                        $class = "il".$a_pname."Plugin";
                        $plugin = new $class();
                        return $plugin;
                }
                
                return null;
        }
        
        
        final static function lookupStoredData($a_ctype, $a_cname, $a_slot_id, $a_pname)
        {
                global $ilDB;
                
                $q = "SELECT * FROM il_plugin WHERE ".
                                " component_type = ".$ilDB->quote($a_ctype, "text")." AND ".
                                " component_name = ".$ilDB->quote($a_cname, "text")." AND ".
                                " slot_id = ".$ilDB->quote($a_slot_id, "text")." AND ".
                                " name = ".$ilDB->quote($a_pname, "text");

                $set = $ilDB->query($q);
                
                $rec = $ilDB->fetchAssoc($set);
                
                return $rec;
        }
        
        static final function getActivePluginsForSlot($a_ctype, $a_cname, $a_slot_id)
        {
                global $ilDB, $ilPluginAdmin;
                
                $q = "SELECT * FROM il_plugin WHERE component_type = ".$ilDB->quote($a_ctype, "text").
                        " AND component_name = ".$ilDB->quote($a_cname, "text").
                        " AND slot_id = ".$ilDB->quote($a_slot_id, "text").
                        " AND active = ".$ilDB->quote(1, "integer");

                $set = $ilDB->query($q);
                $plugins = array();
                while($rec = $ilDB->fetchAssoc($set))
                {
                        if ($ilPluginAdmin->isActive($a_ctype, $a_cname, $a_slot_id, $rec["name"]))
                        {
                                $plugins[] = $rec["name"];
                        }
                }

                return $plugins;
        }
        
        function lookupNameForId($a_ctype, $a_cname, $a_slot_id, $a_plugin_id)
        {
                global $ilDB;
                
                $q = "SELECT name FROM il_plugin ".
                        " WHERE component_type = ".$ilDB->quote($a_ctype, "text").
                        " AND component_name = ".$ilDB->quote($a_cname, "text").
                        " AND slot_id = ".$ilDB->quote($a_slot_id, "text").
                        " AND plugin_id = ".$ilDB->quote($a_plugin_id, "text");

                $set = $ilDB->query($q);
                if ($rec = $ilDB->fetchAssoc($set))
                {
                        return $rec["name"];
                }
        }

        function lookupIdForName($a_ctype, $a_cname, $a_slot_id, $a_plugin_name)
        {
                global $ilDB;
                
                $q = "SELECT plugin_id FROM il_plugin ".
                        " WHERE component_type = ".$ilDB->quote($a_ctype, "text").
                        " AND component_name = ".$ilDB->quote($a_cname, "text").
                        " AND slot_id = ".$ilDB->quote($a_slot_id, "text").
                        " AND name = ".$ilDB->quote($a_plugin_name, "text");

                $set = $ilDB->query($q);
                if ($rec = $ilDB->fetchAssoc($set))
                {
                        return $rec["plugin_id"];
                }
        }
}
?>