ilTaggingClassificationProvider Class Reference

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)
	importPostData ($a_saved=null)
	setSelection ($a_value)
	getFilteredObjects ()
	initListGUI (ilObjectListGUI $a_list_gui)
Public Member Functions inherited from ilClassificationProvider
	__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)
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 ()
	getSubTreeTags ()
Protected Member Functions inherited from ilClassificationProvider
	init ()
	Instance initialisation. More...

Protected Attributes
	$lng
	$user
	$tree
	$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.

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

References $DIC, and user().

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

Here is the call graph for this function:

Member Function Documentation

getFilteredObjects()

ilTaggingClassificationProvider::getFilteredObjects

(

)

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

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

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

Here is the call graph for this function:

getSubTreeTags()

ilTaggingClassificationProvider::getSubTreeTags ( )

protected

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

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

Referenced by importPostData(), and render().

    {
        $tree = $this->tree;
        $ilUser = $this->user;
        
        $sub_ids = array();
        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());
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

importPostData()

ilTaggingClassificationProvider::importPostData

(

$a_saved = null

)

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

References $key, $tag, $tags, $type, and getSubTreeTags().

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

Here is the call graph for this function:

init()

ilTaggingClassificationProvider::init ( )

protected

Definition at line 48 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

)

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

References ilObjectListGUI\enableTags().

    {
        $a_list_gui->enableTags(true);
    }

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

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

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

Referenced by ilClassificationProvider\getValidProviders().

    {
        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;
    }

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
	)

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

References $lng, $map, $tag, $tags, $title, $tpl, $type, ilTagging\getRelevanceClass(), and getSubTreeTags().

    {
        $lng = $this->lng;

        $lng->loadLanguageModule("tagging");
        
        $all_tags = $this->getSubTreeTags();
        if ($all_tags) {
            // see ilPDTaggingBlockGUI::getTagCloud();
            
            $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) {
                        $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();
                    }

                    $a_html[] = array(
                        "title" => $title,
                        "html" => $tpl->get()
                    );
                }
            }
            
            /*
            if($this->selection)
            {
                $a_html[] = array(
                        "title" => "Related Tags",
                        "html" => ":TODO:"
                    );
            }
            */
        }
    }

Here is the call graph for this function:

setSelection()

ilTaggingClassificationProvider::setSelection

(

$a_value

)

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

    {
        $this->selection = $a_value;
    }

Field Documentation

$enable_all_users

ilTaggingClassificationProvider::$enable_all_users

protected

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

$lng

ilTaggingClassificationProvider::$lng

protected

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

Referenced by render().

$selection

ilTaggingClassificationProvider::$selection

protected

Definition at line 46 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