Collaboration diagram for ilTaggingGUI:

Public Member Functions
	__construct ()
	Constructor. More...

	executeCommand ()
	Execute command. More...

	setObject (int $a_obj_id, string $a_obj_type, int $a_sub_obj_id=0, string $a_sub_obj_type="")
	Set Object. More...

	setUserId (int $a_userid)

	getUserId ()

	setSaveCmd (string $a_savecmd)

	getSaveCmd ()

	setInputFieldName (string $a_inputfieldname)

	getInputFieldName ()

	getTaggingInputHTML ()

	saveInput ()

	isForbidden (string $a_tag)

	getAllUserTagsForObjectHTML ()

	getHTML ()
	Get HTML. More...

	saveJS ()
	Save JS. More...

Static Public Member Functions
static	initJavascript (string $a_ajax_url, ilGlobalTemplateInterface $a_main_tpl=null)

static	getListTagsJSCall (string $a_hash, string $a_update_code=null)

Protected Member Functions
	getTagsFromInput (string $input)

Protected Attributes
ilCtrl	$ctrl

ilObjUser	$user

ilLanguage	$lng

ILIAS DI UIServices	$ui

int	$obj_id = 0

string	$obj_type = ""

int	$sub_obj_id = 0

string	$sub_obj_type

array	$forbidden = []

int	$userid = 0

string	$savecmd = ""

string	$inputfieldname = ""

RequestInterface	$request

string	$mess = ""

string	$requested_mess = ""

Private Attributes
ilGlobalTemplateInterface	$main_tpl

Detailed Description

Class ilTaggingGUI.

User interface class for tagging engine.

Author: Alexander Killing killi.nosp@m.ng@l.nosp@m.eifos.nosp@m..de

Definition at line 28 of file class.ilTaggingGUI.php.

Constructor & Destructor Documentation

◆ __construct()

ilTaggingGUI::__construct ( )

Constructor.

Definition at line 50 of file class.ilTaggingGUI.php.

    {
        global $DIC;
        $this->main_tpl = $DIC->ui()->mainTemplate();
 
        $this->ctrl = $DIC->ctrl();
        $this->user = $DIC->user();
        $this->lng = $DIC->language();
        $this->ui = $DIC->ui();
        $this->request = $DIC->http()->request();
 
        $params = $this->request->getQueryParams();
        $this->requested_mess = ($params["mess"] ?? "");
    }

References $DIC, $params, ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), ILIAS\Repository\ui(), and ILIAS\Repository\user().

Here is the call graph for this function:

Member Function Documentation

◆ executeCommand()

ilTaggingGUI::executeCommand ( )

Execute command.

Definition at line 69 of file class.ilTaggingGUI.php.

                                    : void
    {
        $ilCtrl = $this->ctrl;
 
        $next_class = $ilCtrl->getNextClass();
        // PHP8 Review: 'switch' with single 'case'
        switch ($next_class) {
            default:
                $cmd = $ilCtrl->getCmd();
                $this->$cmd();
                break;
        }
    }

References $ctrl, and ilCtrl\getNextClass().

Here is the call graph for this function:

◆ getAllUserTagsForObjectHTML()

ilTaggingGUI::getAllUserTagsForObjectHTML ( )

Definition at line 225 of file class.ilTaggingGUI.php.

                                                 : string
    {
        $ttpl = new ilTemplate("tpl.tag_cloud.html", true, true, "Services/Tagging");
        $tags = ilTagging::getTagsForObject(
            $this->obj_id,
            $this->obj_type,
            $this->sub_obj_id,
            $this->sub_obj_type
        );
 
        $max = 1;
        foreach ($tags as $tag) {
            $max = max($max, $tag["cnt"]);
        }
        reset($tags);
        foreach ($tags as $tag) {
            if (!$this->isForbidden($tag["tag"])) {
                $ttpl->setCurrentBlock("unlinked_tag");
                $ttpl->setVariable(
                    "REL_CLASS",
                    ilTagging::getRelevanceClass((int) $tag["cnt"], (int) $max)
                );
                $ttpl->setVariable("TAG_TITLE", $tag["tag"]);
                $ttpl->parseCurrentBlock();
            }
        }
 
        return $ttpl->get();
    }

References ilTagging\getRelevanceClass(), and ilTagging\getTagsForObject().

Here is the call graph for this function:

◆ getHTML()

ilTaggingGUI::getHTML ( )

Get HTML.

Definition at line 299 of file class.ilTaggingGUI.php.

                             : string
    {
        $lng = $this->lng;
        $ilCtrl = $this->ctrl;
        $ui = $this->ui;
 
        $lng->loadLanguageModule("tagging");
        $tpl = new ilTemplate("tpl.edit_tags.html", true, true, "Services/Tagging");
        $tpl->setVariable("TXT_TAGS", $lng->txt("tagging_tags"));
 
        $mtxt = "";
        $mtype = "";
        $mess = $this->requested_mess != ""
            ? $this->requested_mess
            : $this->mess;
        // PHP8 Review: 'switch' with single 'case'
        switch ($mess) {
            case "mod":
                $mtype = "success";
                $mtxt = $lng->txt("msg_obj_modified");
                break;
        }
        if ($mtxt != "") {
            $tpl->setVariable("MESS", ilUtil::getSystemMessageHTML($mtxt, $mtype));
        } else {
            $tpl->setVariable("MESS", "");
        }
 
        $title = ilObject::_lookupTitle($this->obj_id);
        $icon = $ui->factory()->symbol()->icon()->custom(
            ilObject::_getIcon($this->obj_id),
            $title,
            "medium"
        );
        $tpl->setVariable("ICON", $ui->renderer()->render($icon));
        $tpl->setVariable("TXT_OBJ_TITLE", ilObject::_lookupTitle($this->obj_id));
        $tags = ilTagging::getTagsForUserAndObject(
            $this->obj_id,
            $this->obj_type,
            $this->sub_obj_id,
            $this->sub_obj_type,
            $this->getUserId()
        );
        $tpl->setVariable(
            "VAL_TAGS",
            ilLegacyFormElementsUtil::prepareFormOutput(implode(", ", $tags))
        );
        $tpl->setVariable("TXT_SAVE", $lng->txt("save"));
        $tpl->setVariable("TXT_COMMA_SEPARATED", $lng->txt("comma_separated"));
        $tpl->setVariable("CMD_SAVE", "saveJS");
 
        $os = "ilTagging.cmdAjaxForm(event, '" .
            $ilCtrl->getFormActionByClass("iltagginggui", "", "", true) .
            "');";
        $tpl->setVariable("ON_SUBMIT", $os);
 
        $tags_set = new ilSetting("tags");
        if ($tags_set->get("enable_all_users")) {
            $tpl->setVariable("TAGS_TITLE", $lng->txt("tagging_my_tags"));
 
            $all_obj_tags = ilTagging::_getListTagsForObjects(array($this->obj_id));
            $all_obj_tags = $all_obj_tags[$this->obj_id] ?? null;
            if (is_array($all_obj_tags) &&
                sizeof($all_obj_tags) != sizeof($tags)) {
                $tpl->setVariable("TITLE_OTHER", $lng->txt("tagging_other_users"));
                $tpl->setCurrentBlock("tag_other_bl");
                foreach ($all_obj_tags as $tag => $is_owner) {
                    if (!$is_owner) {
                        $tpl->setVariable("OTHER_TAG", $tag);
                        $tpl->parseCurrentBlock();
                    }
                }
            }
        }
 
        echo $tpl->get();
        exit;
    }

References $lng, $tpl, ilObject\_getIcon(), ilTagging\_getListTagsForObjects(), ilObject\_lookupTitle(), exit, ilUtil\getSystemMessageHTML(), ilTagging\getTagsForUserAndObject(), and ilLegacyFormElementsUtil\prepareFormOutput().

Here is the call graph for this function:

◆ getInputFieldName()

ilTaggingGUI::getInputFieldName ( )

Definition at line 142 of file class.ilTaggingGUI.php.

                                       : string
    {
        return $this->inputfieldname;
    }

◆ getListTagsJSCall()

static ilTaggingGUI::getListTagsJSCall	(	string	$a_hash,
		string	$a_update_code = `null`
	)

static

Definition at line 284 of file class.ilTaggingGUI.php.

     : string {
        if ($a_update_code === null) {
            $a_update_code = "null";
        } else {
            $a_update_code = "'" . $a_update_code . "'";
        }
        return "ilTagging.listTags(event, '" . $a_hash . "', " . $a_update_code . ");";
    }

Referenced by ilObjectListGUI\determineProperties(), ilObjectListGUI\getHeaderAction(), and ilObjectListGUI\insertCommonSocialCommands().

Here is the caller graph for this function:

◆ getSaveCmd()

ilTaggingGUI::getSaveCmd ( )

Definition at line 132 of file class.ilTaggingGUI.php.

                                : string
    {
        return $this->savecmd;
    }

◆ getTaggingInputHTML()

ilTaggingGUI::getTaggingInputHTML ( )

Definition at line 147 of file class.ilTaggingGUI.php.

                                         : string
    {
        $lng = $this->lng;
 
        $ttpl = new ilTemplate("tpl.tags_input.html", true, true, "Services/Tagging");
        $tags = ilTagging::getTagsForUserAndObject(
            $this->obj_id,
            $this->obj_type,
            $this->sub_obj_id,
            $this->sub_obj_type,
            $this->getUserId()
        );
        $ttpl->setVariable(
            "VAL_TAGS",
            ilLegacyFormElementsUtil::prepareFormOutput(implode(", ", $tags))
        );
        $ttpl->setVariable("TAG_LABEL", $lng->txt("tagging_my_tags"));
        $ttpl->setVariable("TXT_SAVE", $lng->txt("save"));
        $ttpl->setVariable("TXT_COMMA_SEPARATED", $lng->txt("comma_separated"));
        $ttpl->setVariable("CMD_SAVE", $this->savecmd);
        $ttpl->setVariable("NAME_TAGS", $this->getInputFieldName());
 
        return $ttpl->get();
    }

References $lng, ilTagging\getTagsForUserAndObject(), and ilLegacyFormElementsUtil\prepareFormOutput().

Here is the call graph for this function:

◆ getTagsFromInput()

ilTaggingGUI::getTagsFromInput ( string $input )

protected

Definition at line 172 of file class.ilTaggingGUI.php.

                                                      : array
    {
        $input = ilUtil::stripSlashes($input);
        $input = str_replace("\r", "\n", $input);
        $input = str_replace("\n\n", "\n", $input);
        $input = str_replace("\n", ",", $input);
        $itags = explode(",", $input);
        return $itags;
    }

References ilUtil\stripSlashes().

Here is the call graph for this function:

◆ getUserId()

ilTaggingGUI::getUserId ( )

Definition at line 122 of file class.ilTaggingGUI.php.

                               : int
    {
        return $this->userid;
    }

◆ initJavascript()

static ilTaggingGUI::initJavascript	(	string	$a_ajax_url,
		ilGlobalTemplateInterface	$a_main_tpl = `null`
	)

static

Definition at line 260 of file class.ilTaggingGUI.php.

     : void {
        global $DIC;
 
        if ($a_main_tpl != null) {
            $tpl = $a_main_tpl;
        } else {
            $tpl = $DIC["tpl"];
        }
 
        $lng = $DIC->language();
 
        $lng->loadLanguageModule("tagging");
        $lng->toJS("tagging_tags", $tpl);
 
        iljQueryUtil::initjQuery($tpl);
        $tpl->addJavaScript("./Services/Tagging/js/ilTagging.js");
 
        $tpl->addOnLoadCode("ilTagging.setAjaxUrl('" . $a_ajax_url . "');");
    }

References $tpl.

◆ isForbidden()

ilTaggingGUI::isForbidden ( string $a_tag )

Definition at line 211 of file class.ilTaggingGUI.php.

                                              : bool
    {
        foreach ($this->forbidden as $f) {
            if (is_int(strpos(strtolower(
                str_replace(array("+", "§", '"', "'", "*", "%", "&", "/", "\\", "(", ")", "=", ":", ";", ":", "-", "_", "\$",
                    "£" . "!" . "¨", "^", "`", "@", "<", ">"), "", $a_tag)
            ), $f))) {
                return true;
            }
        }
        return false;
    }

References Vendor\Package\$f.

◆ saveInput()

ilTaggingGUI::saveInput ( )

Definition at line 182 of file class.ilTaggingGUI.php.

                               : void
    {
        $lng = $this->lng;
        $request = $this->request;
        $body = $request->getParsedBody();
 
        $itags = $this->getTagsFromInput($body[$this->getInputFieldName()]);
        $tags = array();
        foreach ($itags as $itag) {
            $itag = trim($itag);
            if (!in_array($itag, $tags) && $itag != "") {
                if (!$this->isForbidden($itag)) {
                    $tags[] = $itag;
                }
            }
        }
 
        ilTagging::writeTagsForUserAndObject(
            $this->obj_id,
            $this->obj_type,
            $this->sub_obj_id,
            $this->sub_obj_type,
            $this->getUserId(),
            $tags
        );
        $this->main_tpl->setOnScreenMessage('success', $lng->txt('msg_obj_modified'));
    }

References $lng, and ilTagging\writeTagsForUserAndObject().

Here is the call graph for this function:

◆ saveJS()

ilTaggingGUI::saveJS ( )

Save JS.

Definition at line 381 of file class.ilTaggingGUI.php.

                            : void
    {
        $request = $this->request;
        $body = $request->getParsedBody();
        $itags = $this->getTagsFromInput($body["tags"]);
        $tags = array();
        foreach ($itags as $itag) {
            $itag = trim($itag);
            if (!in_array($itag, $tags) && $itag != "") {
                if (!$this->isForbidden($itag)) {
                    $tags[] = $itag;
                }
            }
        }
 
        ilTagging::writeTagsForUserAndObject(
            $this->obj_id,
            $this->obj_type,
            $this->sub_obj_id,
            $this->sub_obj_type,
            $this->getUserId(),
            $tags
        );
 
        $this->mess = "mod";
 
        $this->getHTML();
    }

References ilTagging\writeTagsForUserAndObject().

Here is the call graph for this function:

◆ setInputFieldName()

ilTaggingGUI::setInputFieldName ( string $a_inputfieldname )

Definition at line 137 of file class.ilTaggingGUI.php.

                                                               : void
    {
        $this->inputfieldname = $a_inputfieldname;
    }

◆ setObject()

ilTaggingGUI::setObject	(	int	$a_obj_id,
		string	$a_obj_type,
		int	$a_sub_obj_id = `0`,
		string	$a_sub_obj_type = `""`
	)

Set Object.

Parameters

int	$a_obj_id	Object ID
string	$a_obj_type	Object Type
int	$a_sub_obj_id	Sub-object ID
string	$a_sub_obj_type	Sub-object Type

Definition at line 91 of file class.ilTaggingGUI.php.

     : void {
        $ilUser = $this->user;
 
        $this->obj_id = $a_obj_id;
        $this->obj_type = $a_obj_type;
        $this->sub_obj_id = $a_sub_obj_id;
        $this->sub_obj_type = $a_sub_obj_type;
 
        $this->setSaveCmd("saveTags");
        $this->setUserId($ilUser->getId());
        $this->setInputFieldName("il_tags");
 
        $tags_set = new ilSetting("tags");
        $forbidden = $tags_set->get("forbidden_tags");
        if ($forbidden != "") {
            $this->forbidden = unserialize((string) $forbidden, ['allowed_classes' => false]);
        } else {
            $this->forbidden = array();
        }
    }

◆ setSaveCmd()

ilTaggingGUI::setSaveCmd ( string $a_savecmd )

Definition at line 127 of file class.ilTaggingGUI.php.

                                                 : void
    {
        $this->savecmd = $a_savecmd;
    }

◆ setUserId()

ilTaggingGUI::setUserId ( int $a_userid )

Definition at line 117 of file class.ilTaggingGUI.php.

                                            : void
    {
        $this->userid = $a_userid;
    }

Field Documentation

◆ $ctrl

ilCtrl ilTaggingGUI::$ctrl

protected

Definition at line 30 of file class.ilTaggingGUI.php.

Referenced by executeCommand().

◆ $forbidden

array ilTaggingGUI::$forbidden = []

protected

Definition at line 38 of file class.ilTaggingGUI.php.

◆ $inputfieldname

string ilTaggingGUI::$inputfieldname = ""

protected

Definition at line 41 of file class.ilTaggingGUI.php.

◆ $lng

ilLanguage ilTaggingGUI::$lng

protected

Definition at line 32 of file class.ilTaggingGUI.php.

◆ $main_tpl

ilGlobalTemplateInterface ilTaggingGUI::$main_tpl

private

Definition at line 45 of file class.ilTaggingGUI.php.

◆ $mess

string ilTaggingGUI::$mess = ""

protected

Definition at line 43 of file class.ilTaggingGUI.php.

◆ $obj_id

int ilTaggingGUI::$obj_id = 0

protected

Definition at line 34 of file class.ilTaggingGUI.php.

◆ $obj_type

string ilTaggingGUI::$obj_type = ""

protected

Definition at line 35 of file class.ilTaggingGUI.php.

◆ $request

RequestInterface ilTaggingGUI::$request

protected

Definition at line 42 of file class.ilTaggingGUI.php.

◆ $requested_mess

string ilTaggingGUI::$requested_mess = ""

protected

Definition at line 44 of file class.ilTaggingGUI.php.

◆ $savecmd

string ilTaggingGUI::$savecmd = ""

protected

Definition at line 40 of file class.ilTaggingGUI.php.

◆ $sub_obj_id

int ilTaggingGUI::$sub_obj_id = 0

protected

Definition at line 36 of file class.ilTaggingGUI.php.

◆ $sub_obj_type

string ilTaggingGUI::$sub_obj_type

protected

Definition at line 37 of file class.ilTaggingGUI.php.

◆ $ui

ILIAS DI UIServices ilTaggingGUI::$ui

protected

Definition at line 33 of file class.ilTaggingGUI.php.

◆ $user

ilObjUser ilTaggingGUI::$user

protected

Definition at line 31 of file class.ilTaggingGUI.php.

◆ $userid

int ilTaggingGUI::$userid = 0

protected

Definition at line 39 of file class.ilTaggingGUI.php.

The documentation for this class was generated from the following file:

Services/Tagging/classes/class.ilTaggingGUI.php

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ executeCommand()

◆ getAllUserTagsForObjectHTML()

◆ getHTML()

◆ getInputFieldName()

◆ getListTagsJSCall()

◆ getSaveCmd()

◆ getTaggingInputHTML()

◆ getTagsFromInput()

◆ getUserId()

◆ initJavascript()

◆ isForbidden()

◆ saveInput()

◆ saveJS()

◆ setInputFieldName()

◆ setObject()

◆ setSaveCmd()

◆ setUserId()

Field Documentation

◆ $ctrl

◆ $forbidden

◆ $inputfieldname

◆ $lng

◆ $main_tpl

◆ $mess

◆ $obj_id

◆ $obj_type

◆ $request

◆ $requested_mess

◆ $savecmd

◆ $sub_obj_id

◆ $sub_obj_type

◆ $ui

◆ $user

◆ $userid