Virtual skill tree. More...

Inheritance diagram for ilVirtualSkillTree:

Collaboration diagram for ilVirtualSkillTree:

Public Member Functions
	__construct (int $tree_id)

	getRootNode ()

	setIncludeDrafts (bool $a_val)

	getIncludeDrafts ()

	setIncludeOutdated (bool $a_val)

	getIncludeOutdated ()

	getNode (string $a_vtree_id)

	getChildsOfNode (string $a_parent_id)

	getChildsOfNodeForCSkillId (string $a_cskill_id)

	getCSkillIdForVTreeId (string $a_vtree_id)

	getVTreeIdForCSkillId (string $a_cskill_id)

	getNodeTitle (array $a_node)

	getSubTreeForCSkillId (string $a_cskill_id, bool $a_only_basic=false)

	isDraft (string $a_node_id)

	isOutdated (string $a_node_id)

	getOrderedNodeset (array $c_skill_ids, string $a_skill_id_key="", string $a_tref_id_key="")
	Get ordererd nodeset for common skill ids. More...

Protected Member Functions
	__getSubTreeRec (string $id, bool $a_only_basic)

	getPath (string $a, array $node_data)
	get path in node data More...

	getFirstUncommonAncestors (string $a, string $b, array $node_data)
	get first uncommon ancestors of $a and $b in $node_data More...

Protected Attributes
ilLanguage	$lng

ilSkillTree	$tree

bool	$include_drafts = false

array	$drafts = []

bool	$include_outdated = false

array	$outdated = []

Static Protected Attributes
static array	$order_node_data = null

Detailed Description

Virtual skill tree.

Author: Alex Killing alex..nosp@m.kill.nosp@m.ing@g.nosp@m.mx.d.nosp@m.e

Version: $Id$

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

Constructor & Destructor Documentation

◆ __construct()

ilVirtualSkillTree::__construct ( int $tree_id )

Definition at line 51 of file class.ilVirtualSkillTree.php.

    {
        global $DIC;
 
        $this->lng = $DIC->language();
        $this->tree = $DIC->skills()->internal()->factory()->tree()->getTreeById($tree_id);
    }

References $DIC, and ILIAS\Repository\lng().

Here is the call graph for this function:

Member Function Documentation

◆ __getSubTreeRec()

ilVirtualSkillTree::__getSubTreeRec	(	string	$id,
		bool	$a_only_basic
	)

protected

Returns: array{cskill_id: string, id: string, skill_id: string, tref_id: string, parent: string, type: string}[]

Definition at line 276 of file class.ilVirtualSkillTree.php.

                                                                      : array
    {
        $result = [];
        $childs = $this->getChildsOfNode($id);
        foreach ($childs as $c) {
            if (!$a_only_basic || in_array($c["type"], array("skll", "sktp")) ||
                ($c["type"] == "sktr" && ilSkillTreeNode::_lookupType((int) $c["skill_id"]) == "sktp")) {
                $result[] = $c;
            }
            $result = array_merge($result, $this->__getSubTreeRec($c["id"], $a_only_basic));
        }
 
        return $result;
    }

References $c, __getSubTreeRec(), ilSkillTreeNode\_lookupType(), and getChildsOfNode().

Referenced by __getSubTreeRec(), getSubTreeForCSkillId(), and ilGlobalVirtualSkillTree\getSubTreeForTreeId().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getChildsOfNode()

ilVirtualSkillTree::getChildsOfNode ( string $a_parent_id )

Returns: array{cskill_id: string, id: string, skill_id: string, tref_id: string, parent: string, type: string}[]

Reimplemented in ilGlobalVirtualSkillTree.

Definition at line 129 of file class.ilVirtualSkillTree.php.

                                                        : array
    {
        $a_parent_id_parts = explode(":", $a_parent_id);
        $a_parent_skl_tree_id = (int) $a_parent_id_parts[0];
        $a_parent_skl_template_tree_id = isset($a_parent_id_parts[1]) ? (int) $a_parent_id_parts[1] : 0;
 
        if ($a_parent_skl_template_tree_id == 0) {
            $childs = $this->tree->getChildsByTypeFilter($a_parent_skl_tree_id, array("scat", "skll", "sktr"), "order_nr");
        } else {
            $childs = $this->tree->getChildsByTypeFilter($a_parent_skl_template_tree_id, array("sktp", "sctp"), "order_nr");
        }
 
        $drafts = [];
        $outdated = [];
        foreach ($childs as $k => $c) {
            if ($a_parent_skl_template_tree_id > 0) {
                // we are in template tree only
                $child_id = $a_parent_skl_tree_id . ":" . $c["child"];
            } elseif (!in_array($c["type"], array("sktr", "sctr"))) {
                // we are in main tree only
                $child_id = $c["child"] . ":0";
            } else {
                // get template id for references
                $child_id = $c["child"] . ":" . ilSkillTemplateReference::_lookupTemplateId((int) $c["child"]);
            }
            unset($childs[$k]["child"]);
            unset($childs[$k]["skl_tree_id"]);
            unset($childs[$k]["lft"]);
            unset($childs[$k]["rgt"]);
            unset($childs[$k]["depth"]);
            $childs[$k]["id"] = $child_id;
            $cid = $this->getCSkillIdForVTreeId($child_id);
            $cid_parts = explode(":", $cid);
            $childs[$k]["skill_id"] = $cid_parts[0];
            $childs[$k]["tref_id"] = $cid_parts[1];
            $childs[$k]["cskill_id"] = $cid;
            $childs[$k]["parent"] = $a_parent_id;
 
            // @todo: prepare this for tref id?
            if (ilSkillTreeNode::_lookupStatus((int) $c["child"]) == ilSkillTreeNode::STATUS_DRAFT ||
                in_array($a_parent_id, $this->drafts)) {
                $this->drafts[] = $child_id;
                $drafts[] = $k;
            }
            if (ilSkillTreeNode::_lookupStatus((int) $c["child"]) == ilSkillTreeNode::STATUS_OUTDATED ||
                in_array($a_parent_id, $this->outdated)) {
                $this->outdated[] = $child_id;
                $outdated[] = $k;
            }
        }
        if (!$this->getIncludeDrafts()) {
            foreach ($drafts as $d) {
                unset($childs[$d]);
            }
        }
        if (!$this->getIncludeOutdated()) {
            foreach ($outdated as $d) {
                unset($childs[$d]);
            }
        }
 
        return $childs;
    }

References $c, Vendor\Package\$d, $drafts, $outdated, ilSkillTreeNode\_lookupStatus(), ilSkillTemplateReference\_lookupTemplateId(), getCSkillIdForVTreeId(), getIncludeDrafts(), getIncludeOutdated(), ILIAS\Repository\int(), ilSkillTreeNode\STATUS_DRAFT, and ilSkillTreeNode\STATUS_OUTDATED.

Referenced by __getSubTreeRec(), and getChildsOfNodeForCSkillId().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getChildsOfNodeForCSkillId()

ilVirtualSkillTree::getChildsOfNodeForCSkillId ( string $a_cskill_id )

Definition at line 193 of file class.ilVirtualSkillTree.php.

                                                                   : array
    {
        $id_parts = explode(":", $a_cskill_id);
        if (!isset($id_parts[1]) || $id_parts[1] == 0) {
            $id = $id_parts[0] . ":0";
        } else {
            $id = $id_parts[1] . ":" . $id_parts[0];
        }
        return $this->getChildsOfNode($id);
    }

References $id, and getChildsOfNode().

Here is the call graph for this function:

◆ getCSkillIdForVTreeId()

ilVirtualSkillTree::getCSkillIdForVTreeId ( string $a_vtree_id )

Definition at line 204 of file class.ilVirtualSkillTree.php.

                                                             : string
    {
        $id_parts = explode(":", $a_vtree_id);
        if (!isset($id_parts[1]) || $id_parts[1] == 0) {
            // skill in main tree
            $skill_id = $id_parts[0];
            $tref_id = 0;
        } else {
            // skill in template
            $tref_id = $id_parts[0];
            $skill_id = $id_parts[1];
        }
        return $skill_id . ":" . $tref_id;
    }

Referenced by getChildsOfNode(), and getNode().

Here is the caller graph for this function:

◆ getFirstUncommonAncestors()

ilVirtualSkillTree::getFirstUncommonAncestors	(	string	$a,
		string	$b,
		array	$node_data
	)

protected

get first uncommon ancestors of $a and $b in $node_data

Returns: array{0: mixed, 1: mixed}|false

Definition at line 383 of file class.ilVirtualSkillTree.php.

    {
        $path_a = $this->getPath($a, $node_data);
        $path_b = $this->getPath($b, $node_data);
        foreach ($path_a as $k => $v) {
            if ($v != $path_b[$k]) {
                return array($v, $path_b[$k]);
            }
        }
        return false;
    }

References getPath().

Referenced by getOrderedNodeset().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getIncludeDrafts()

ilVirtualSkillTree::getIncludeDrafts ( )

Definition at line 78 of file class.ilVirtualSkillTree.php.

                                      : bool
    {
        return $this->include_drafts;
    }

References $include_drafts.

Referenced by getChildsOfNode().

Here is the caller graph for this function:

◆ getIncludeOutdated()

ilVirtualSkillTree::getIncludeOutdated ( )

Definition at line 88 of file class.ilVirtualSkillTree.php.

                                        : bool
    {
        return $this->include_outdated;
    }

References $include_outdated.

Referenced by getChildsOfNode().

Here is the caller graph for this function:

◆ getNode()

ilVirtualSkillTree::getNode ( string $a_vtree_id )

Definition at line 93 of file class.ilVirtualSkillTree.php.

                                               : array
    {
        $id_parts = explode(":", $a_vtree_id);
        $skl_tree_id = (int) $id_parts[0];
        $skl_template_tree_id = isset($id_parts[1]) ? (int) $id_parts[1] : 0;
 
        if ($skl_template_tree_id == 0
            || (ilSkillTemplateReference::_lookupTemplateId($skl_tree_id) == $skl_template_tree_id)) {
            $node_data = $this->tree->getNodeData($skl_tree_id);
            if (isset($node_data["parent"])) {
                $node_data["parent"] = $node_data["parent"] . ":0";
            }
        } else {
            $node_data = $this->tree->getNodeData($skl_template_tree_id);
            $node_data["parent"] = $skl_tree_id . ":" . $node_data["parent"];
        }
 
        unset($node_data["child"]);
        unset($node_data["skl_tree_id"]);
        unset($node_data["lft"]);
        unset($node_data["rgt"]);
        unset($node_data["depth"]);
 
        $node_data["id"] = $a_vtree_id;
        $cid = $this->getCSkillIdForVTreeId($a_vtree_id);
        $cid_parts = explode(":", $cid);
        $node_data["skill_id"] = $cid_parts[0];
        $node_data["tref_id"] = $cid_parts[1];
        $node_data["cskill_id"] = $cid;
 
        return $node_data;
    }

References ilSkillTemplateReference\_lookupTemplateId(), getCSkillIdForVTreeId(), and ILIAS\Repository\int().

Referenced by getSubTreeForCSkillId(), and ilGlobalVirtualSkillTree\getSubTreeForTreeId().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getNodeTitle()

ilVirtualSkillTree::getNodeTitle ( array $a_node )

Definition at line 230 of file class.ilVirtualSkillTree.php.

                                               : string
    {
        $lng = $this->lng;
 
        $a_parent_id_parts = explode(":", $a_node["id"]);
        $a_parent_skl_tree_id = (int) $a_parent_id_parts[0];
        $a_parent_skl_template_tree_id = isset($a_parent_id_parts[1]) ? (int) $a_parent_id_parts[1] : 0;
 
        // title
        $title = $a_node["title"];
 
        // root?
        if ($a_node["type"] == "skrt") {
            $lng->txt("skmg_skills");
        } elseif ($a_node["type"] == "sktr") {
            //                          $title.= " (".ilSkillTreeNode::_lookupTitle($a_parent_skl_template_tree_id).")";
        }
 
        return $title;
    }

References $lng, ILIAS\Repository\int(), and ilLanguage\txt().

Here is the call graph for this function:

◆ getOrderedNodeset()

ilVirtualSkillTree::getOrderedNodeset	(	array	$c_skill_ids,
		string	$a_skill_id_key = `""`,
		string	$a_tref_id_key = `""`
	)

Get ordererd nodeset for common skill ids.

Parameters

string[] \| array[]	$c_skill_ids	string of "skill_id:tref_id" skill ids or an array
string	$a_skill_id_key	if first parameter is array[], this string identifies the key of the basic skill id
string	$a_tref_id_key	if first parameter is array[], this string identifies the key of the tref id

Returns: string[]|array[]

Definition at line 309 of file class.ilVirtualSkillTree.php.

                                                                                                                  : array
    {
        global $DIC;
 
        $db = $DIC->database();
 
        if (self::$order_node_data == null) {
            $node_data = [];
            $set = $db->query("SELECT t.child, t.parent, t.lft, n.order_nr FROM skl_tree t JOIN skl_tree_node n ON (t.child = n.obj_id)");
            while ($rec = $db->fetchAssoc($set)) {
                $node_data[(int) $rec["child"]] = array(
                    "parent" => null === $rec["parent"] ? null : (int) $rec["parent"],
                    "lft" => (int) $rec["lft"],
                    "order_nr" => (int) $rec["order_nr"],
                );
            }
            self::$order_node_data = $node_data;
        } else {
            $node_data = self::$order_node_data;
        }
 
        uasort($c_skill_ids, function ($a, $b) use ($node_data, $a_skill_id_key, $a_tref_id_key): int {
            // normalize to cskill strings
            if (is_array($a)) {
                $cskilla = $a[$a_skill_id_key] . ":" . $a[$a_tref_id_key];
                $cskillb = $b[$a_skill_id_key] . ":" . $b[$a_tref_id_key];
            } else {
                $cskilla = $a;
                $cskillb = $b;
            }
 
            // get vtree ids
            $vida = explode(":", $this->getVTreeIdForCSkillId($cskilla));
            $vidb = explode(":", $this->getVTreeIdForCSkillId($cskillb));
 
            $ua = $this->getFirstUncommonAncestors($vida[0], $vidb[0], $node_data);
            if (is_array($ua) && isset($node_data[$ua[0]]) && isset($node_data[$ua[1]])) {
                return ($node_data[$ua[0]]["order_nr"] - $node_data[$ua[1]]["order_nr"]);
            }
            // if we did not find a first uncommon ancestor, we are in the same node in the
            // main tree, here, if we have tref ids, we let the template tree decide
            if ($vida[1] > 0 && $vidb[1] > 0) {
                $ua = $this->getFirstUncommonAncestors($vida[1], $vidb[1], $node_data);
                if (is_array($ua) && isset($node_data[$ua[0]]) && isset($node_data[$ua[1]])) {
                    return ($node_data[$ua[0]]["order_nr"] - $node_data[$ua[1]]["order_nr"]);
                }
            }
 
            return 0;
        });
 
        return $c_skill_ids;
    }

References Vendor\Package\$a, Vendor\Package\$b, $DIC, $order_node_data, getFirstUncommonAncestors(), getVTreeIdForCSkillId(), and ILIAS\Repository\int().

Here is the call graph for this function:

◆ getPath()

ilVirtualSkillTree::getPath	(	string	$a,
		array	$node_data
	)

protected

get path in node data

Definition at line 366 of file class.ilVirtualSkillTree.php.

                                                           : array
    {
        $path[] = $a;
        if (isset($node_data[$a]) && isset($node_data[$a]["parent"])) {
            while ($node_data[$a]["parent"] != 0) {
                $a = $node_data[$a]["parent"];
                $path[] = $a;
            }
        }
        return array_reverse($path);
    }

References Vendor\Package\$a, and $path.

Referenced by getFirstUncommonAncestors().

Here is the caller graph for this function:

◆ getRootNode()

ilVirtualSkillTree::getRootNode ( )

Returns: array{id: string, cskill_id: string}

Reimplemented in ilGlobalVirtualSkillTree.

Definition at line 62 of file class.ilVirtualSkillTree.php.

                                 : array
    {
        $root_id = $this->tree->readRootId();
        $root_node = $this->tree->getNodeData($root_id);
        unset($root_node["child"]);
        $root_node["id"] = $root_id . ":0";
        $root_node["cskill_id"] = $root_id . ":0";
 
        return $root_node;
    }

◆ getSubTreeForCSkillId()

ilVirtualSkillTree::getSubTreeForCSkillId	(	string	$a_cskill_id,
		bool	$a_only_basic = `false`
	)

Returns: array{cskill_id: string, id: string, skill_id: string, tref_id: string, parent: string, type: string}[]

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

                                                                                          : array
    {
        $id_parts = explode(":", $a_cskill_id);
        if (!isset($id_parts[1]) || $id_parts[1] == 0) {
            $id = $id_parts[0] . ":0";
        } else {
            $id = $id_parts[1] . ":" . $id_parts[0];
        }
 
        $result = [];
 
        $node = $this->getNode($id);
        if (!$a_only_basic || isset($node["type"]) && in_array($node["type"], array("skll", "sktp")) ||
            (isset($node["type"]) && $node["type"] == "sktr" && ilSkillTreeNode::_lookupType((int) $node["skill_id"]) == "sktp")) {
            $result[] = $node;
        }
        return array_merge($result, $this->__getSubTreeRec($id, $a_only_basic));
    }

References $id, __getSubTreeRec(), ilSkillTreeNode\_lookupType(), and getNode().

Here is the call graph for this function:

◆ getVTreeIdForCSkillId()

ilVirtualSkillTree::getVTreeIdForCSkillId ( string $a_cskill_id )

Definition at line 219 of file class.ilVirtualSkillTree.php.

                                                              : string
    {
        $id_parts = explode(":", $a_cskill_id);
        if (!isset($id_parts[1]) || $id_parts[1] == 0) {
            $id = $id_parts[0] . ":0";
        } else {
            $id = $id_parts[1] . ":" . $id_parts[0];
        }
        return $id;
    }

References $id.

Referenced by getOrderedNodeset().

Here is the caller graph for this function:

◆ isDraft()

ilVirtualSkillTree::isDraft ( string $a_node_id )

Definition at line 291 of file class.ilVirtualSkillTree.php.

                                              : bool
    {
        return in_array($a_node_id, $this->drafts);
    }

◆ isOutdated()

ilVirtualSkillTree::isOutdated ( string $a_node_id )

Definition at line 296 of file class.ilVirtualSkillTree.php.

                                                 : bool
    {
        return in_array($a_node_id, $this->outdated);
    }

◆ setIncludeDrafts()

ilVirtualSkillTree::setIncludeDrafts ( bool $a_val )

Definition at line 73 of file class.ilVirtualSkillTree.php.

                                                 : void
    {
        $this->include_drafts = $a_val;
    }

◆ setIncludeOutdated()

ilVirtualSkillTree::setIncludeOutdated ( bool $a_val )

Definition at line 83 of file class.ilVirtualSkillTree.php.

                                                   : void
    {
        $this->include_outdated = $a_val;
    }

Field Documentation

◆ $drafts

array ilVirtualSkillTree::$drafts = []

protected

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

Referenced by getChildsOfNode().

◆ $include_drafts

bool ilVirtualSkillTree::$include_drafts = false

protected

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

Referenced by getIncludeDrafts().

◆ $include_outdated

bool ilVirtualSkillTree::$include_outdated = false

protected

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

Referenced by getIncludeOutdated().

◆ $lng

ilLanguage ilVirtualSkillTree::$lng

protected

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

Referenced by getNodeTitle().

◆ $order_node_data

array ilVirtualSkillTree::$order_node_data = null

staticprotected

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

Referenced by getOrderedNodeset().

◆ $outdated

array ilVirtualSkillTree::$outdated = []

protected

Definition at line 49 of file class.ilVirtualSkillTree.php.

Referenced by getChildsOfNode().

◆ $tree

ilSkillTree ilVirtualSkillTree::$tree

protected

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

Referenced by ilGlobalVirtualSkillTree\getChildsOfNode().

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

components/ILIAS/Skill/Tree/class.ilVirtualSkillTree.php

Public Member Functions

Protected Member Functions

Protected Attributes

Static Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ __getSubTreeRec()

◆ getChildsOfNode()

◆ getChildsOfNodeForCSkillId()

◆ getCSkillIdForVTreeId()

◆ getFirstUncommonAncestors()

◆ getIncludeDrafts()

◆ getIncludeOutdated()

◆ getNode()

◆ getNodeTitle()

◆ getOrderedNodeset()

◆ getPath()

◆ getRootNode()

◆ getSubTreeForCSkillId()

◆ getVTreeIdForCSkillId()

◆ isDraft()

◆ isOutdated()

◆ setIncludeDrafts()

◆ setIncludeOutdated()

Field Documentation

◆ $drafts

◆ $include_drafts

◆ $include_outdated

◆ $lng

◆ $order_node_data

◆ $outdated

◆ $tree