class.ilLink.php

Go to the documentation of this file.

<?php

class ilLink
{
    protected const LINK_SCRIPT = "goto.php";

    public static function _getLink(
        ?int $a_ref_id,
        string $a_type = '',
        array $a_params = array(),
        string $append = ""
    ): string {
        global $DIC;

        $ilObjDataCache = $DIC["ilObjDataCache"];
        $objDefinition = $DIC['objDefinition'];

        if ($a_type === '' && !is_null($a_ref_id)) {
            $a_type = $ilObjDataCache->lookupType($ilObjDataCache->lookupObjId($a_ref_id));
        }
        $param_string = '';
        if (is_array($a_params) && count($a_params)) {
            foreach ($a_params as $name => $value) {
                $param_string .= ('&' . $name . '=' . $value);
            }
        }

        // workaround for administration links: https://mantis.ilias.de/view.php?id=33088
        if (
            $objDefinition->isAdministrationObject($a_type) &&
            $param_string === '' &&
            $append === ''
        ) {
            $determined_object_type = $ilObjDataCache->lookupType($ilObjDataCache->lookupObjId($a_ref_id));
            // https://mantis.ilias.de/view.php?id=34853
            if ($determined_object_type === $a_type) {
                return ILIAS_HTTP_PATH . '/ilias.php?baseClass=ilAdministrationGUI&cmd=jump&ref_id=' . $a_ref_id;
            }
        }
        return ILIAS_HTTP_PATH . '/' . self::LINK_SCRIPT . '?target=' . $a_type . '_' . $a_ref_id . $append . '&client_id=' . CLIENT_ID . $param_string;
    }

    public static function _getStaticLink(
        ?int $a_ref_id,
        string $a_type = '',
        bool $a_fallback_goto = true,
        string $append = ""
    ): string {
        global $DIC;

        $ilObjDataCache = $DIC["ilObjDataCache"];

        if ($a_type === '' && $a_ref_id) {
            $a_type = $ilObjDataCache->lookupType($ilObjDataCache->lookupObjId($a_ref_id));
        }

        $robot_settings = ilRobotSettings::getInstance();
        if (!$robot_settings->robotSupportEnabled()) {
            if ($a_fallback_goto) {
                return self::_getLink($a_ref_id, $a_type, array(), $append);
            }

            return false;
        }

        // urlencode for append is needed e.g. to process "/" in wiki page names correctly
        return ILIAS_HTTP_PATH . '/goto_' . urlencode(CLIENT_ID) . '_' . $a_type . '_' . $a_ref_id . urlencode($append) . '.html';
    }
}