Tag classification provider. More...

Inheritance diagram for ilTaggingClassificationProvider:

Collaboration diagram for ilTaggingClassificationProvider:

Public Member Functions
	__construct ($a_parent_ref_id, $a_parent_obj_id, $a_parent_obj_type)
	Constructor. More...

	render (array &$a_html, $a_parent_gui)
	Render HTML chunks. More...

	importPostData ($a_saved=null)
	Import post data. More...

	setSelection ($a_value)
	Set selection. More...

	getFilteredObjects ()
	Get filtered object ref ids. More...

	initListGUI (ilObjectListGUI $a_list_gui)
	Init list gui properties. More...

	__construct ($a_parent_ref_id, $a_parent_obj_id, $a_parent_obj_type)
	Constructor. More...

	render (array &$a_html, $a_parent_gui)
	Render HTML chunks. More...

	importPostData ($a_saved=null)
	Import post data. More...

	setSelection ($a_value)
	Set selection. More...

	getFilteredObjects ()
	Get filtered object ref ids. More...

	initListGUI (ilObjectListGUI $a_list_gui)
	Init list gui properties. More...

Static Public Member Functions
static	isActive ($a_parent_ref_id, $a_parent_obj_id, $a_parent_obj_type)
	Is provider currently active? More...

Static Public Member Functions inherited from ilClassificationProvider
static	getValidProviders ($a_parent_ref_id, $a_parent_obj_id, $a_parent_obj_type)
	Get all valid providers (for parent container) More...

static	isActive ($a_parent_ref_id, $a_parent_obj_id, $a_parent_obj_type)
	Is provider currently active? More...

Protected Member Functions
	init ()
	Instance initialisation. More...

	getSubTreeTags ()

	init ()
	Instance initialisation. More...

Protected Attributes
	$lng

	$user

	$tree

	$obj_definition

	$ctrl

	$enable_all_users

	$selection

Protected Attributes inherited from ilClassificationProvider
	$parent_ref_id

	$parent_obj_id

	$parent_type

Detailed Description

Tag classification provider.

Author: Jörg Lützenkirchen luetz.nosp@m.enki.nosp@m.rchen.nosp@m.@lei.nosp@m.fos.c.nosp@m.om

Version: $Id$

Definition at line 14 of file class.ilTaggingClassificationProvider.php.

Constructor & Destructor Documentation

◆ __construct()

ilTaggingClassificationProvider::__construct	(	$a_parent_ref_id,
		$a_parent_obj_id,
		$a_parent_obj_type
	)

Constructor.

Reimplemented from ilClassificationProvider.

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

    {
        global $DIC;
        parent::__construct($a_parent_ref_id, $a_parent_obj_id, $a_parent_obj_type);
 
        $this->lng = $DIC->language();
        $this->user = $DIC->user();
        $this->tree = $DIC->repositoryTree();
        $this->obj_definition = $DIC["objDefinition"];
        $this->ctrl = $DIC->ctrl();
    }

References $DIC, ILIAS\GlobalScreen\Provider\__construct(), and user().

Here is the call graph for this function:

Member Function Documentation

◆ getFilteredObjects()

ilTaggingClassificationProvider::getFilteredObjects ( )

Get filtered object ref ids.

Returns: array

Reimplemented from ilClassificationProvider.

Definition at line 203 of file class.ilTaggingClassificationProvider.php.

    {
        $ilUser = $this->user;
        
        if (!$this->selection) {
            return;
        }
        
        include_once "Services/Tagging/classes/class.ilTagging.php";
        
        $types = array("personal");
        if ($this->enable_all_users) {
            $types[] = "other";
        }
                
        $found = array();
        foreach ($types as $type) {
            if (is_array($this->selection[$type])) {
                $invert = ($type == "personal")
                    ? false
                    : true;
                
                foreach ($this->selection[$type] as $tag) {
                    $found[$tag] = array_keys(ilTagging::_findObjectsByTag($tag, $ilUser->getId(), $invert));
                }
            }
        }
                        
        /* OR
        $res = array();
        foreach($found as $tag => $ids)
        {
            $res = array_merge($res, $ids);
        }
        */
        
        // AND
        $res = null;
        foreach ($found as $tag => $ids) {
            if ($res === null) {
                $res = $ids;
            } else {
                $res = array_intersect($res, $ids);
            }
        }
                
        if (sizeof($res)) {
            return array_unique($res);
        }
    }

References $ilUser, $res, $type, $user, and ilTagging\_findObjectsByTag().

Here is the call graph for this function:

◆ getSubTreeTags()

ilTaggingClassificationProvider::getSubTreeTags ( )

protected

Definition at line 254 of file class.ilTaggingClassificationProvider.php.

    {
        $tree = $this->tree;
        $ilUser = $this->user;
 
        //$objdefinition = $this->obj_definition;
 
        $sub_ids = array();
 
        // categories show only direct children and their tags
        if (ilObject::_lookupType($this->parent_ref_id, true) == "cat") {
            foreach ($tree->getChilds($this->parent_ref_id) as $sub_item) {
                if ($sub_item["ref_id"] != $this->parent_ref_id &&
                    $sub_item["type"] != "rolf" &&
                    !$tree->isDeleted($sub_item["ref_id"])) {
                    $sub_ids[$sub_item["obj_id"]] = $sub_item["type"];
                }
            }
        } else {
            foreach ($tree->getSubTree($tree->getNodeData($this->parent_ref_id)) as $sub_item) {
                if ($sub_item["ref_id"] != $this->parent_ref_id &&
                    $sub_item["type"] != "rolf" &&
                    !$tree->isDeleted($sub_item["ref_id"])) {
                    $sub_ids[$sub_item["obj_id"]] = $sub_item["type"];
                }
            }
        }
        
        if ($sub_ids) {
            $only_user = $this->enable_all_users
                ? null
                : $ilUser->getId();
            
            include_once "Services/Tagging/classes/class.ilTagging.php";
            return ilTagging::_getTagCloudForObjects($sub_ids, $only_user, $ilUser->getId());
        }
    }

References $ilUser, $tree, $user, ilTagging\_getTagCloudForObjects(), and ilObject\_lookupType().

Referenced by importPostData(), and render().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ importPostData()

ilTaggingClassificationProvider::importPostData ( $a_saved = null )

Import post data.

Parameters

mixed $a_saved

Returns: mixed

Reimplemented from ilClassificationProvider.

Definition at line 158 of file class.ilTaggingClassificationProvider.php.

    {
        $type = trim($_REQUEST["tag_type"]);
        $tag_code = trim($_REQUEST["tag"]);     // using codes to avoid encoding issues
        if ($type && $tag_code) {
            // code to tag
            $found = null;
            foreach ($this->getSubTreeTags() as $tags) {
                foreach (array_keys($tags) as $tag) {
                    if (md5($tag) == $tag_code) {
                        $found = $tag;
                        break(2);
                    }
                }
            }
            if ($found) {
                /* single select
                if(is_array($a_saved[$type]) &&
                    in_array($found, $a_saved[$type]))
                {
                    return;
                }
                return array($type=>array($found));
                */
                // multi select
                if (is_array($a_saved[$type]) &&
                    in_array($found, $a_saved[$type])) {
                    $key = array_search($found, $a_saved[$type]);
                    unset($a_saved[$type][$key]);
                    if (!sizeof($a_saved[$type])) {
                        unset($a_saved[$type]);
                    }
                } else {
                    $a_saved[$type][] = $found;
                }
            }
            return $a_saved;
        }
    }

References $type, and getSubTreeTags().

Here is the call graph for this function:

◆ init()

ilTaggingClassificationProvider::init ( )

protected

Instance initialisation.

Reimplemented from ilClassificationProvider.

Definition at line 59 of file class.ilTaggingClassificationProvider.php.

    {
        $tags_set = new ilSetting("tags");
        $this->enable_all_users = (bool) $tags_set->get("enable_all_users", false);
    }

◆ initListGUI()

ilTaggingClassificationProvider::initListGUI ( ilObjectListGUI $a_list_gui )

Init list gui properties.

Parameters

ilObjectListGUI $a_list_gui

Reimplemented from ilClassificationProvider.

Definition at line 292 of file class.ilTaggingClassificationProvider.php.

    {
        $a_list_gui->enableTags(true);
    }

References ilObjectListGUI\enableTags().

Here is the call graph for this function:

◆ isActive()

static ilTaggingClassificationProvider::isActive	(	$a_parent_ref_id,
		$a_parent_obj_id,
		$a_parent_obj_type
	)

static

Is provider currently active?

Parameters

int	$a_parent_ref_id
int	$a_parent_obj_id
string	$a_parent_obj_type

Returns: bool

Reimplemented from ilClassificationProvider.

Definition at line 65 of file class.ilTaggingClassificationProvider.php.

    {
        global $DIC;
 
        $ilUser = $DIC->user();
        
        // we currently only check for the parent object setting
        // might change later on (parent containers)
        include_once "Services/Object/classes/class.ilObjectServiceSettingsGUI.php";
        $valid = ilContainer::_lookupContainerSetting(
            $a_parent_obj_id,
            ilObjectServiceSettingsGUI::TAG_CLOUD,
            false
        );
        
        if ($valid) {
            $tags_set = new ilSetting("tags");
            if (!$tags_set->get("enable_all_users", false) &&
                $ilUser->getId() == ANONYMOUS_USER_ID) {
                $valid = false;
            }
        }
        
        return $valid;
    }

References $DIC, $ilUser, $valid, ilContainer\_lookupContainerSetting(), ANONYMOUS_USER_ID, and ilObjectServiceSettingsGUI\TAG_CLOUD.

Referenced by ilClassificationProvider\getValidProviders().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ render()

ilTaggingClassificationProvider::render	(	array &	$a_html,
			$a_parent_gui
	)

Render HTML chunks.

Parameters

array	$a_html
object	$a_parent_gui

Reimplemented from ilClassificationProvider.

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

    {
        $lng = $this->lng;
        $ctrl = $this->ctrl;
        
        $lng->loadLanguageModule("tagging");
        
        $all_tags = $this->getSubTreeTags();
        if ($all_tags) {
            $map = array(
                "personal" => $lng->txt("tagging_my_tags"),
                "other" => $lng->txt("tagging_other_users")
            );
            foreach ($map as $type => $title) {
                $tags = $all_tags[$type];
                if ($tags) {
                    $max = 1;
                    foreach ($tags as $tag => $counter) {
                        $max = max($counter, $max);
                    }
                    reset($tags);
 
                    $tpl = new ilTemplate("tpl.tag_cloud_block.html", true, true, "Services/Tagging");
 
                    $tpl->setCurrentBlock("tag_bl");
                    foreach ($tags as $tag => $counter) {
                        $ctrl->setParameter($a_parent_gui, "tag_type", $type);
                        $ctrl->setParameter($a_parent_gui, "tag", md5($tag));
                        $tpl->setVariable("HREF", $ctrl->getLinkTarget($a_parent_gui, "toggle"));
 
                        $tpl->setVariable("TAG_TYPE", $type);
                        $tpl->setVariable("TAG_TITLE", $tag);
                        $tpl->setVariable("TAG_CODE", md5($tag));
                        $tpl->setVariable(
                            "REL_CLASS",
                            ilTagging::getRelevanceClass($counter, $max)
                        );
                        if (is_array($this->selection[$type]) &&
                            in_array($tag, $this->selection[$type])) {
                            $tpl->setVariable("HIGHL_CLASS", ' ilHighlighted');
                        }
 
                        $tpl->parseCurrentBlock();
                        $ctrl->setParameter($a_parent_gui, "tag_type", "");
                        $ctrl->setParameter($a_parent_gui, "tag", "");
                    }
 
                    $a_html[] = array(
                        "title" => $title,
                        "html" => $tpl->get()
                    );
                }
            }
            
            /*
            if($this->selection)
            {
                $a_html[] = array(
                        "title" => "Related Tags",
                        "html" => ":TODO:"
                    );
            }
            */
        }
    }

References $ctrl, $lng, $tpl, $type, ilTagging\getRelevanceClass(), and getSubTreeTags().

Here is the call graph for this function:

◆ setSelection()

ilTaggingClassificationProvider::setSelection ( $a_value )

Set selection.

Parameters

mixed $a_value

Reimplemented from ilClassificationProvider.

Definition at line 198 of file class.ilTaggingClassificationProvider.php.

    {
        $this->selection = $a_value;
    }

Field Documentation

◆ $ctrl

ilTaggingClassificationProvider::$ctrl

protected

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

Referenced by render().

◆ $enable_all_users

ilTaggingClassificationProvider::$enable_all_users

protected

Definition at line 56 of file class.ilTaggingClassificationProvider.php.

◆ $lng

ilTaggingClassificationProvider::$lng

protected

Definition at line 19 of file class.ilTaggingClassificationProvider.php.

Referenced by render().

◆ $obj_definition

ilTaggingClassificationProvider::$obj_definition

protected

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

◆ $selection

ilTaggingClassificationProvider::$selection

protected

Definition at line 57 of file class.ilTaggingClassificationProvider.php.

◆ $tree

ilTaggingClassificationProvider::$tree

protected

Definition at line 29 of file class.ilTaggingClassificationProvider.php.

Referenced by getSubTreeTags().

◆ $user

ilTaggingClassificationProvider::$user

protected

Definition at line 24 of file class.ilTaggingClassificationProvider.php.

Referenced by getFilteredObjects(), and getSubTreeTags().

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

Services/Tagging/classes/class.ilTaggingClassificationProvider.php

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ getFilteredObjects()

◆ getSubTreeTags()

◆ importPostData()

◆ init()

◆ initListGUI()

◆ isActive()

◆ render()

◆ setSelection()

Field Documentation

◆ $ctrl

◆ $enable_all_users

◆ $lng

◆ $obj_definition

◆ $selection

◆ $tree

◆ $user