class.ilPlugin.php

Go to the documentation of this file.

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

use ILIAS\GlobalScreen\Scope\MainMenu\Provider\AbstractStaticPluginMainMenuProvider;

abstract class ilPlugin
{

    protected $slot;
    protected $active = false;
    protected $iliasmaxversion = "";
    protected $iliasminversion = "";
    protected $version = "";
    protected $lastupdateversion = "";
    protected $dbversion = 0;
    protected $lang_initialised = false;
    protected $id = '';


    public function __construct()
    {
        $this->__init();
    }


    abstract public function getComponentType();


    abstract public function getComponentName();


    abstract public function getSlot();


    abstract public function getSlotId();


    abstract public function getPluginName();


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


    public function getId() : string
    {
        return $this->id;
    }


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


    public function getLastUpdateVersion() : string
    {
        return $this->lastupdateversion;
    }


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


    public function getVersion() : string
    {
        return $this->version;
    }


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


    public function getIliasMinVersion() : string
    {
        return $this->iliasminversion;
    }


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


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


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


    public function getActive() : bool
    {
        return $this->active;
    }


    protected function setSlotObject(ilPluginSlot $a_slot)
    {
        $this->slot = $a_slot;
    }


    protected function getSlotObject() : ilPluginSlot
    {
        return $this->slot;
    }


    public function setDBVersion(int $a_dbversion)
    {
        $this->dbversion = $a_dbversion;
    }


    public function getDBVersion() : int
    {
        return $this->dbversion;
    }


    public function writeDBVersion(int $a_dbversion)
    {
        global $DIC;
        $ilDB = $DIC->database();

        $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 function getDirectory() : string
    {
        return $this->getSlotObject()->getPluginsDirectory() . "/" . $this->getPluginName();
    }


    public static function _getDirectory(string $a_ctype, string $a_cname, string $a_slot_id, string $a_pname) : string
    {
        return ilPluginSlot::_getPluginsDirectory($a_ctype, $a_cname, $a_slot_id) . "/" . $a_pname;
    }


    protected function getClassesDirectory() : string
    {
        return $this->getDirectory() . "/classes";
    }


    public function includeClass($a_class_file_name)
    {
        include_once($this->getClassesDirectory() . "/" . $a_class_file_name);
    }


    protected function getLanguageDirectory() : string
    {
        return $this->getDirectory() . "/lang";
    }


    public static function getAvailableLangFiles(string $a_lang_directory) : array
    {
        $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;
    }


    public static function hasConfigureClass(string $a_slot_dir, array $plugin_data, array $plugin_db_data) : bool
    {
        // Mantis: 23282: Disable plugin config page for incompatible plugins
        if (!(ilComponent::isVersionGreaterString($plugin_data["ilias_min_version"], ILIAS_VERSION_NUMERIC)
            || ilComponent::isVersionGreaterString(ILIAS_VERSION_NUMERIC, $plugin_data["ilias_max_version"])
            || ilComponent::isVersionGreaterString($plugin_db_data["last_update_version"], $plugin_data["version"]))
        ) {
            if (is_file($a_slot_dir . "/" . $plugin_data["name"] . "/classes/class.il" . $plugin_data["name"] . "ConfigGUI.php")) {
                return true;
            }
        }

        return false;
    }


    public static function getConfigureClassName(array $plugin_data) : string
    {
        return "il" . $plugin_data["name"] . "ConfigGUI";
    }


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


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


    public function getTablePrefix()
    {
        return $this->getPrefix();
    }


    public function updateLanguages($a_lang_keys = null)
    {
        ilGlobalCache::flushAll();

        // get the keys of all installed languages if keys are not provided
        if (!isset($a_lang_keys)) {
            $a_lang_keys = array();
            foreach (ilObjLanguage::getInstalledLanguages() as $langObj) {
                if ($langObj->isInstalled()) {
                    $a_lang_keys[] = $langObj->getKey();
                }
            }
        }

        $langs = $this->getAvailableLangFiles($this->getLanguageDirectory());

        $prefix = $this->getPrefix();

        foreach ($langs as $lang) {
            // check if the language should be updated, otherwise skip it
            if (!in_array($lang['key'], $a_lang_keys)) {
                continue;
            }

            $txt = file($this->getLanguageDirectory() . "/" . $lang["file"]);
            $lang_array = array();

            // get locally changed variables of the module (these should be kept)
            $local_changes = ilObjLanguage::_getLocalChangesByModule($lang['key'], $prefix);

            // get language data
            if (is_array($txt)) {
                foreach ($txt as $row) {
                    if ($row[0] != "#" && strpos($row, "#:#") > 0) {
                        $a = explode("#:#", trim($row));
                        $identifier = $prefix . "_" . trim($a[0]);
                        $value = trim($a[1]);

                        if (isset($local_changes[$identifier])) {
                            $lang_array[$identifier] = $local_changes[$identifier];
                        } else {
                            $lang_array[$identifier] = $value;
                            ilObjLanguage::replaceLangEntry($prefix, $identifier, $lang["key"], $value);
                        }
                        //echo "<br>-$prefix-".$prefix."_".trim($a[0])."-".$lang["key"]."-";
                    }
                }
            }

            ilObjLanguage::replaceLangModule($lang["key"], $prefix, $lang_array);
        }
    }


    public function updateDatabase()
    {
        global $DIC;
        $ilDB = $DIC->database();
        $lng = $DIC->language();

        ilGlobalCache::flushAll();

        $dbupdate = new ilPluginDBUpdate(
            $this->getComponentType(),
            $this->getComponentName(),
            $this->getSlotId(),
            $this->getPluginName(),
            $ilDB,
            true,
            $this->getTablePrefix()
        );

        $result = $dbupdate->applyUpdate();
        $message = '';
        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;
        ilGlobalCache::flushAll();

        return $result;
    }


    public function loadLanguageModule()
    {
        global $DIC;
        $lng = $DIC->language();

        if (!$this->lang_initialised && is_object($lng)) {
            $lng->loadLanguageModule($this->getPrefix());
            $this->lang_initialised = true;
        }
    }


    public function txt(string $a_var) : string
    {
        global $DIC;
        $lng = $DIC->language();
        $this->loadLanguageModule();

        return $lng->txt($this->getPrefix() . "_" . $a_var, $this->getPrefix());
    }


    public static function lookupTxt(string $a_mod_prefix, string $a_pl_id, string $a_lang_var) : string
    {
        global $DIC;
        $lng = $DIC->language();

        // this enables default language fallback
        $prefix = $a_mod_prefix . "_" . $a_pl_id;

        return $lng->txt($prefix . "_" . $a_lang_var, $prefix);
    }


    public static function langExitsById(string $pluginId, string $langVar) : bool
    {
        global $DIC;
        $lng = $DIC->language();

        $pl = ilObjectPlugin::getPluginObjectByType($pluginId);
        $pl->loadLanguageModule();

        return $lng->exists($pl->getPrefix() . "_" . $langVar);
    }


    public function getTemplate(string $a_template, bool $a_par1 = true, bool $a_par2 = true) : ilTemplate
    {
        return new ilTemplate($this->getDirectory() . "/templates/" . $a_template, $a_par1, $a_par2);
    }


    public static function _getImagePath(string $a_ctype, string $a_cname, string $a_slot_id, string $a_pname, string $a_img) : string
    {
        $d2 = ilComponent::lookupId($a_ctype, $a_cname) . "_" . $a_slot_id . "_" .
            ilPlugin::lookupIdForName($a_ctype, $a_cname, $a_slot_id, $a_pname);

        $img = ilUtil::getImagePath($d2 . "/" . $a_img);
        if (is_int(strpos($img, "Customizing"))) {
            return $img;
        }

        $d = ilPlugin::_getDirectory($a_ctype, $a_cname, $a_slot_id, $a_pname);

        return $d . "/templates/images/" . $a_img;
    }


    public function getImagePath(string $a_img) : string
    {
        return self::_getImagePath(
            $this->getComponentType(),
            $this->getComponentName(),
            $this->getSlotId(),
            $this->getPluginName(),
            $a_img
        );
    }


    public function getStyleSheetLocation(string $a_css_file) : string
    {
        $d2 = ilComponent::lookupId($this->getComponentType(), $this->getComponentName()) . "_" . $this->getSlotId() . "_" .
            ilPlugin::lookupIdForName($this->getComponentType(), $this->getComponentName(), $this->getSlotId(), $this->getPluginName());

        $css = ilUtil::getStyleSheetLocation("output", $a_css_file, $d2);
        if (is_int(strpos($css, "Customizing"))) {
            return $css;
        }

        return $this->getDirectory() . "/templates/" . $a_css_file;
    }


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


    public static function createPluginRecord(string $a_ctype, string $a_cname, string $a_slot_id, string $a_pname)
    {
        global $DIC;
        $ilDB = $DIC->database();

        ilCachedComponentData::flush();

        $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);
    }


    public static function getPluginRecord(string $a_ctype, string $a_cname, string $a_slot_id, string $a_pname) : array
    {
        $cached_component = ilCachedComponentData::getInstance();
        $rec = $cached_component->lookupPluginByName($a_pname);

        if ($rec['component_type'] == $a_ctype and $rec['component_name'] == $a_cname and $rec['slot_id'] == $a_slot_id) {
            return $rec;
        } else {
            throw new ilPluginException("No plugin record found for '{$a_ctype}', '{$a_cname}', '{$a_slot_id}', '{$a_pname}");
        }
    }


    private function __init()
    {
        global $DIC;
        $ilPluginAdmin = $DIC['ilPluginAdmin'];

        // read/set basic data
        $rec = ilPlugin::getPluginRecord(
            $this->getComponentType(),
            $this->getComponentName(),
            $this->getSlotId(),
            $this->getPluginName()
        );
        $this->setLastUpdateVersion((string) $rec["last_update_version"]);
        $this->setDBVersion((int) $rec["db_version"]);
        $this->setActive((bool) $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 function isActive()
    {
        global $DIC;
        $ilPluginAdmin = $DIC['ilPluginAdmin'];

        return $ilPluginAdmin->isActive(
            $this->getComponentType(),
            $this->getComponentName(),
            $this->getSlotId(),
            $this->getPluginName()
        );
    }


    public function needsUpdate()
    {
        global $DIC;
        $ilPluginAdmin = $DIC['ilPluginAdmin'];

        return $ilPluginAdmin->needsUpdate(
            $this->getComponentType(),
            $this->getComponentName(),
            $this->getSlotId(),
            $this->getPluginName()
        );
    }


    public function install()
    {
        global $DIC;
        $ilDB = $DIC->database();

        ilCachedComponentData::flush();
        $q = "UPDATE il_plugin SET 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->afterInstall();
    }


    public function activate()
    {
        global $DIC;
        $ilDB = $DIC->database();

        ilCachedComponentData::flush();

        $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") .
                    " 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();
            }
        }
        ilCachedComponentData::flush();

        return $result;
    }


    protected function afterInstall()
    {
    }


    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()
    {
    }


    public function deactivate()
    {
        global $DIC;
        $ilDB = $DIC->database();

        ilCachedComponentData::flush();

        $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);
        $this->afterDeactivation();

        return $result;
    }


    protected function afterDeactivation()
    {
    }


    protected function beforeUninstall()
    {
        // plugin-specific
        // false would indicate that anything went wrong
        return true;
    }


    final public function uninstall()
    {
        global $DIC;
        $ilDB = $DIC->database();

        if ($this->beforeUninstall()) {
            // remove all language entries (see ilObjLanguage)
            // see updateLanguages
            $prefix = $this->getPrefix();
            if ($prefix) {
                $ilDB->manipulate(
                    "DELETE FROM lng_data" .
                    " WHERE module = " . $ilDB->quote($prefix, "text")
                );
                $ilDB->manipulate(
                    "DELETE FROM lng_modules" .
                    " WHERE module = " . $ilDB->quote($prefix, "text")
                );
            }

            $this->clearEventListening();

            // db version is kept in il_plugin - will be deleted, too

            $q = "DELETE FROM il_plugin" .
                " 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);
            
            $ilDB->manipulateF('DELETE FROM ctrl_classfile WHERE comp_prefix=%s', [ ilDBConstants::T_TEXT ], [ $this->getPrefix() ]);
            $ilDB->manipulateF('DELETE FROM ctrl_calls WHERE comp_prefix=%s', [ ilDBConstants::T_TEXT ], [ $this->getPrefix() ]);

            $this->afterUninstall();

            ilCachedComponentData::flush();

            return true;
        }

        return false;
    }


    protected function afterUninstall()
    {
    }


    public function update()
    {
        global $DIC;
        $ilDB = $DIC->database();
        $ilCtrl = $DIC->ctrl();

        ilGlobalCache::flushAll();

        $result = $this->beforeUpdate();
        if ($result === false) {
            return false;
        }

        // Load language files
        $this->updateLanguages();

        // DB update
        if ($result === true) {
            $result = $this->updateDatabase();
        }

        // load control structure
        include_once("./setup/classes/class.ilCtrlStructureReader.php");
        $structure_reader = new ilCtrlStructureReader();
        $structure_reader->readStructure(
            true,
            "./" . $this->getDirectory(),
            $this->getPrefix(),
            $this->getDirectory()
        );

        // add config gui to the ctrl calls
        $ilCtrl->insertCtrlCalls(
            "ilobjcomponentsettingsgui",
            ilPlugin::getConfigureClassName(["name" => $this->getPluginName()]),
            $this->getPrefix()
        );

        $this->readEventListening();

        // 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);
            $this->afterUpdate();
        }
        ilGlobalCache::flushAll();

        return $result;
    }


    protected function readEventListening()
    {
        $reader = new ilPluginReader(
            $this->getDirectory() . '/plugin.xml',
            $this->getComponentType(),
            $this->getComponentName(),
            $this->getSlotId(),
            $this->getPluginName()
        );
        $reader->clearEvents();
        $reader->startParsing();
    }


    protected function clearEventListening()
    {
        $reader = new ilPluginReader(
            $this->getDirectory() . '/plugin.xml',
            $this->getComponentType(),
            $this->getComponentName(),
            $this->getSlotId(),
            $this->getPluginName()
        );
        $reader->clearEvents();
    }


    protected function beforeUpdate()
    {
        return true;    // false would indicate that anything went wrong
        // update would not proceed
        // throw an exception in this case
        //throw new ilPluginException($lng->txt(""));
    }


    protected function afterUpdate()
    {
    }


    public static function getPluginObject(string $a_ctype, string $a_cname, string $a_slot_id, string $a_pname)
    {
        $slot_name = ilPluginSlot::lookupSlotName($a_ctype, $a_cname, $a_slot_id);

        $cached_component = ilCachedComponentData::getInstance();
        $rec = $cached_component->lookCompId($a_ctype, $a_cname);
        if (!$rec) {
            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;
    }


    public static function lookupStoredData(string $a_ctype, string $a_cname, string $a_slot_id, string $a_pname) : array
    {
        global $DIC;
        $ilDB = $DIC->database();

        $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 ($ilDB->numRows($set) == 0) {
            return array();
        }

        return $ilDB->fetchAssoc($set);
    }


    public static function getActivePluginsForSlot(string $a_ctype, string $a_cname, string $a_slot_id) : array
    {
        global $DIC;
        $ilPluginAdmin = $DIC['ilPluginAdmin'];

        $plugins = array();

        $cached_component = ilCachedComponentData::getInstance();

        $lookupActivePluginsBySlotId = $cached_component->lookupActivePluginsBySlotId($a_slot_id);
        foreach ($lookupActivePluginsBySlotId as $rec) {
            if ($ilPluginAdmin->isActive($a_ctype, $a_cname, $a_slot_id, $rec["name"])) {
                $plugins[] = $rec["name"];
            }
        }

        return $plugins;
    }


    public static function getActivePluginIdsForSlot(string $a_ctype, string $a_cname, string $a_slot_id) : array
    {
        global $DIC;
        $ilPluginAdmin = $DIC['ilPluginAdmin'];

        $plugins = array();
        $cached_component = ilCachedComponentData::getInstance();
        $lookupActivePluginsBySlotId = $cached_component->lookupActivePluginsBySlotId($a_slot_id);
        foreach ($lookupActivePluginsBySlotId as $rec) {
            if ($ilPluginAdmin->isActive($a_ctype, $a_cname, $a_slot_id, $rec["name"])) {
                $plugins[] = $rec["plugin_id"];
            }
        }

        return $plugins;
    }


    public static function lookupNameForId(string $a_ctype, string $a_cname, string $a_slot_id, string $a_plugin_id)
    {
        global $DIC;
        $ilDB = $DIC->database();

        $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"];
        }
    }


    public static function lookupIdForName(string $a_ctype, string $a_cname, string $a_slot_id, string $a_plugin_name) : string
    {
        global $DIC;
        $ilDB = $DIC->database();

        $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"];
        }
    }

    public static function lookupTypeInformationsForId(string $id)
    {
        global $DIC;
        $ilDB = $DIC->database();

        $q = "SELECT component_type, component_name, slot_id FROM il_plugin "
            . " WHERE plugin_id = " . $ilDB->quote($id, "text")
        ;

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


    public function promoteGlobalScreenProvider() : AbstractStaticPluginMainMenuProvider
    {
        return new ilPluginGlobalScreenNullProvider();
    }
}