class.ilTemplate.php

Go to the documentation of this file.

<?php

declare(strict_types=1);

require_once __DIR__ . '/../lib/html-it/IT.php';
require_once __DIR__ . '/../lib/html-it/ITX.php';

class ilTemplate extends HTML_Template_ITX
{
    public array $vars = [];

    public string $activeBlock = '';

    protected static array $il_cache = [];

    protected bool $il_use_cache;

    protected string $il_cur_key;

    protected string $tplName;

    protected string $tplPath;

    protected string $tplIdentifier;

    public function __construct(
        string $file,
        bool $flag1,
        bool $flag2,
        string $in_module = "",
        string $vars = ilGlobalTemplateInterface::DEFAULT_BLOCK,
        bool $plugin = false,
        bool $a_use_cache = true
    ) {
        $this->activeBlock = HTML_Template_IT::IT_DEFAULT_BLOCK;
        $this->il_use_cache = $a_use_cache;
        $this->il_cur_key = $file . "/" . $in_module;

        $fname = $this->getTemplatePath($file, $in_module);
        if (!file_exists($fname)) {
            throw new ilTemplateException("Template '$fname' was not found.\nfile: " . $file . "\nmodule: " . $in_module);
        }

        $this->tplName = basename($fname);
        $this->tplPath = dirname($fname);
        $this->vars["TPLPATH"] = $this->tplPath;
        $this->tplIdentifier = $this->getTemplateIdentifier($file, $in_module);

        parent::__construct();

        $this->loadTemplatefile($fname, $flag1, $flag2);
        $this->setOption('use_preg', false);
    }

    protected function init(): void
    {
        $this->free();
        $this->buildFunctionlist();

        $cache_hit = false;
        if ($this->il_use_cache &&
            isset(self::$il_cache[$this->il_cur_key]) &&
            is_array(self::$il_cache[$this->il_cur_key])
        ) {
            $cache_hit = true;
            $this->err = self::$il_cache[$this->il_cur_key]["err"];
            $this->flagBlocktrouble = self::$il_cache[$this->il_cur_key]["flagBlocktrouble"];
            $this->blocklist = self::$il_cache[$this->il_cur_key]["blocklist"];
            $this->blockdata = self::$il_cache[$this->il_cur_key]["blockdata"];
            $this->blockinner = self::$il_cache[$this->il_cur_key]["blockinner"];
            $this->blockparents = self::$il_cache[$this->il_cur_key]["blockparents"];
            $this->blockvariables = self::$il_cache[$this->il_cur_key]["blockvariables"];
        }

        if (!$cache_hit) {
            $this->findBlocks($this->template);
            $this->buildBlockvariablelist();
            if ($this->il_use_cache) {
                self::$il_cache[$this->il_cur_key]["err"] = $this->err;
                self::$il_cache[$this->il_cur_key]["flagBlocktrouble"] = $this->flagBlocktrouble;
                self::$il_cache[$this->il_cur_key]["blocklist"] = $this->blocklist;
                self::$il_cache[$this->il_cur_key]["blockdata"] = $this->blockdata;
                self::$il_cache[$this->il_cur_key]["blockinner"] = $this->blockinner;
                self::$il_cache[$this->il_cur_key]["blockparents"] = $this->blockparents;
                self::$il_cache[$this->il_cur_key]["blockvariables"] = $this->blockvariables;
            }
        }

        // we don't need it anymore
        $this->template = '';
    }

    public function blockExists(string $a_blockname): bool
    {
        // added second evaluation to the return statement because the first one
        // only works for the content block (Helmut Schottmüller, 2007-09-14).
        return
            isset($this->blockvariables["content"][$a_blockname]) ||
            isset($this->blockvariables[$a_blockname]);
    }

    public function get(string $part = ilGlobalTemplateInterface::DEFAULT_BLOCK): string
    {
        global $DIC;

        $html = $this->getUnmodified($part);
        $component_factory = $DIC["component.factory"];
        foreach ($component_factory->getActivePluginsInSlot("uihk") as $ui_plugin) {
            $gui_class = $ui_plugin->getUIClassInstance();
            $resp = $gui_class->getHTML(
                "",
                "template_get",
                [
                    "tpl_id" => $this->tplIdentifier,
                    "tpl_obj" => $this,
                    "html" => $html
                ]
            );

            if (ilUIHookPluginGUI::KEEP !== $resp["mode"]) {
                $html = $gui_class->modifyHTML($html, $resp);
            }
        }

        return $html;
    }

    public function getUnmodified(string $part = ilGlobalTemplateInterface::DEFAULT_BLOCK): string
    {
        // I can't believe how garbage this is.
        if (ilGlobalTemplateInterface::DEFAULT_BLOCK === $part) {
            $part = self::IT_DEFAULT_BLOCK;
        }

        return parent::get($part);
    }

    public function setCurrentBlock(string $part = ilGlobalTemplateInterface::DEFAULT_BLOCK): bool
    {
        // I can't believe how garbage this is.
        if (ilGlobalTemplateInterface::DEFAULT_BLOCK === $part) {
            $part = self::IT_DEFAULT_BLOCK;
        }

        $this->activeBlock = $part;
        return parent::setCurrentBlock($part);
    }

    public function touchBlock(string $block): bool
    {
        $this->setCurrentBlock($block);
        $count = $this->fillVars();
        $this->parseCurrentBlock();

        if (0 === $count) {
            return parent::touchBlock($block);
        }

        return false;
    }

    public function parseCurrentBlock(string $part = ilGlobalTemplateInterface::DEFAULT_BLOCK): bool
    {
        $this->fillVars();
        $this->activeBlock = self::IT_DEFAULT_BLOCK;

        return parent::parseCurrentBlock();
    }

    public function addBlockFile(string $var, string $block, string $tplname, ?string $in_module = null): bool
    {
        global $DIC;

        $tplfile = $this->getTemplatePath($tplname, $in_module ?? '');
        if (file_exists($tplfile) === false) {
            echo "<br/>Template '" . $tplfile . "' doesn't exist! aborting...";
            return false;
        }

        $id = $this->getTemplateIdentifier($tplname, $in_module);
        $template = $this->getFile($tplfile);
        $component_factory = $DIC["component.factory"];
        foreach ($component_factory->getActivePluginsInSlot("uihk") as $ui_plugin) {
            $gui_class = $ui_plugin->getUIClassInstance();
            $resp = $gui_class->getHTML(
                "",
                "template_add",
                [
                    "tpl_id" => $id,
                    "tpl_obj" => $this,
                    "html" => $template,
                ]
            );

            if ($resp["mode"] !== ilUIHookPluginGUI::KEEP) {
                $template = $gui_class->modifyHTML($template, $resp);
            }
        }

        return $this->addBlock($var, $block, $template);
    }

    private function fillVars(): int
    {
        $count = 0;
        foreach ($this->vars as $key => $val) {
            if (is_array($this->blockvariables[$this->activeBlock]) &&
                array_key_exists($key, $this->blockvariables[$this->activeBlock])
            ) {
                $this->setVariable($key, $val);
                $count++;
            }
        }

        return $count;
    }

    public function loadTemplatefile(
        string $filename,
        bool $removeUnknownVariables = true,
        bool $removeEmptyBlocks = true
    ): bool {
        global $DIC;

        $template = '';
        if (!$this->flagCacheTemplatefile ||
            $this->lastTemplatefile !== $filename
        ) {
            $template = $this->getFile($filename);
        }
        $this->lastTemplatefile = $filename;

        $component_factory = $DIC["component.factory"];
        foreach ($component_factory->getActivePluginsInSlot("uihk") as $ui_plugin) {
            $gui_class = $ui_plugin->getUIClassInstance();
            $resp = $gui_class->getHTML(
                "",
                "template_load",
                [
                    "tpl_id" => $this->tplIdentifier,
                    "tpl_obj" => $this,
                    "html" => $template,
                ]
            );

            if ($resp["mode"] !== ilUIHookPluginGUI::KEEP) {
                $template = $gui_class->modifyHTML($template, $resp);
            }
        }

        return
            $template !== '' &&
            $this->setTemplate(
                $template,
                $removeUnknownVariables,
                $removeEmptyBlocks
            );
    }


    protected function getCurrentSkin(): ?string
    {
        // use ilStyleDefinition instead of account to get the current skin
        return ilStyleDefinition::getCurrentSkin();
    }

    protected function getCurrentStyle(): ?string
    {
        return ilStyleDefinition::getCurrentStyle();
    }

    protected function fileExistsInSkin(string $path): bool
    {
        return file_exists($path);
    }

    protected function getTemplatePath(string $a_tplname, string $a_in_module = ''): string
    {
        $ilias_root = realpath(__DIR__ . '/../../../../') . '/';

        if (str_starts_with($a_in_module, $ilias_root)) {
            $a_in_module = str_replace($ilias_root, '', $a_in_module);
        }

        if (str_ends_with($a_in_module, '/')) {
            $a_in_module = rtrim($a_in_module, '/');
        }

        $tpl_sub_path = '/templates/default/';
        if (str_starts_with($a_tplname, 'components/ILIAS/UI/')) {
            $a_in_module = 'components/ILIAS/UI/src';
            $a_tplname = str_replace('components/ILIAS/UI/src/templates/default/', '', $a_tplname);
        }

        if (str_starts_with($a_tplname, $ilias_root)) {
            $a_tplname = str_replace($ilias_root, '', $a_tplname);
        }
        if (strpos($a_tplname, 'public/Customizing/global/plugins')) {
            $tpl_sub_path = '';
        }

        $base_path = $ilias_root;
        $default = $base_path . $a_in_module . $tpl_sub_path . $a_tplname;

        $skin = $this->getCurrentSkin();
        if ($skin === 'default') {
            return $default;
        }

        $style = $this->getCurrentStyle();
        $base_path .= 'public/Customizing/skin/' . $skin . '/' . $style;

        if ($a_in_module === 'components/ILIAS/UI/src') {
            $a_in_module = 'UI';
        }

        $from_skin = $base_path . '/' . $a_in_module . '/' . $a_tplname;

        return $this->fileExistsInSkin($from_skin) ? $from_skin : $default;
    }

    public function getTemplateIdentifier(string $a_tplname, ?string $a_in_module = null): string
    {
        if (strpos($a_tplname, "/") === false) {
            if (null !== $a_in_module) {
                $module_path = $a_in_module . "/";
            } else {
                $module_path = "";
            }

            return $module_path . basename($a_tplname);
        }

        return $a_tplname;
    }

    public function variableExists(string $a_variablename): bool
    {
        return isset($this->blockvariables["content"][$a_variablename]);
    }
}