ilVirtualSkillTree Class Reference

Virtual skill tree. More...

Collaboration diagram for ilVirtualSkillTree:

Public Member Functions
	__construct ()
	Constructor. More...
	getRootNode ()
	Get root node. More...
	setIncludeDrafts ($a_val)
	Set include drafts. More...
	getIncludeDrafts ()
	Get include drafts. More...
	setIncludeOutdated ($a_val)
	Set include outdated. More...
	getIncludeOutdated ()
	Get include outdated. More...
	getNode ($a_id)
	Get node. More...
	getChildsOfNode ($a_parent_id)
	Get childs of node. More...
	getChildsOfNodeForCSkillId ($a_cskill_id)
	Get childs of node for cskill id. More...
	getCSkillIdForVTreeId ($a_vtree_id)
	Get common skill id for tree id. More...
	getVTreeIdForCSkillId ($a_cskill_id)
	Get tree id for common skill id. More...
	getNodeTitle ($a_node)
	Get node content. More...
	getSubTreeForCSkillId ($a_cskill_id, $a_only_basic=false)
	Get sub tree. More...
	isDraft ($a_node_id)
	Is draft. More...
	isOutdated ($a_node_id)
	Is outdated. More...
	getOrderedNodeset ($c_skill_ids, $a_skill_id_key="", $a_tref_id_key="")
	Get ordererd nodeset for common skill ids. More...

Protected Member Functions
	getPath ($a, $node_data)
	getFirstUncommonAncestors ($a, $b, $node_data)

Protected Attributes
	$lng
	$include_drafts = false
	$drafts = array()
	$include_outdated = false
	$outdated = array()

Static Protected Attributes
static	$order_node_data = null

Private Member Functions
	__getSubTreeRec ($id, &$result, $a_only_basic)
	Get subtree, internal. More...

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 13 of file class.ilVirtualSkillTree.php.

Constructor & Destructor Documentation

__construct()

ilVirtualSkillTree::__construct

(

)

Constructor.

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

References $DIC.

    {
        global $DIC;

        $this->lng = $DIC->language();
        include_once("./Services/Skill/classes/class.ilSkillTree.php");
        $this->tree = new ilSkillTree();
    }

Member Function Documentation

__getSubTreeRec()

ilVirtualSkillTree::__getSubTreeRec (   $id, &  $result,   $a_only_basic  )

private

Get subtree, internal.

Parameters

string	$id	vtree id
array	$result	node array (called by reference)
bool	$a_only_basic	return only basic skills (and basic skill templates)

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

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

Referenced by getSubTreeForCSkillId().

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

Here is the call graph for this function:

Here is the caller graph for this function:

getChildsOfNode()

ilVirtualSkillTree::getChildsOfNode

(

$a_parent_id

)

Get childs of node.

Parameters

string

$a_parent_id

parent id

Returns

array childs

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

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

Referenced by __getSubTreeRec(), and getChildsOfNodeForCSkillId().

    {
        $a_parent_id_parts = explode(":", $a_parent_id);
        $a_parent_skl_tree_id = $a_parent_id_parts[0];
        $a_parent_skl_template_tree_id = $a_parent_id_parts[1];

        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");
        }
        
        include_once("./Services/Skill/classes/class.ilSkillTreeNode.php");
        $drafts = array();
        $outdated = array();
        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
                include_once("./Services/Skill/classes/class.ilSkillTemplateReference.php");
                $child_id = $c["child"] . ":" . ilSkillTemplateReference::_lookupTemplateId($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;
            //echo "-".$child_id."-";
            $cid = $this->getCSkillIdForVTreeId($child_id);
            //echo "-".$cid."-";
            $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;
            
            $this->parent[$c["id"]] = $a_parent_id;
            
            // @todo: prepare this for tref id?
            if (ilSkillTreeNode::_lookupStatus($c["child"]) == ilSkillTreeNode::STATUS_DRAFT ||
                in_array($a_parent_id, $this->drafts)) {
                $this->drafts[] = $child_id;
                $drafts[] = $k;
            }
            if (ilSkillTreeNode::_lookupStatus($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;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getChildsOfNodeForCSkillId()

ilVirtualSkillTree::getChildsOfNodeForCSkillId

(

$a_cskill_id

)

Get childs of node for cskill id.

Parameters

string

$a_cskill_id

common skill id <skill_id>:<tref_id>

Returns

array array of childs

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

References $id, and getChildsOfNode().

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

Here is the call graph for this function:

getCSkillIdForVTreeId()

ilVirtualSkillTree::getCSkillIdForVTreeId

(

$a_vtree_id

)

Get common skill id for tree id.

Parameters

string

$a_vtree_id

vtree id

Returns

string cskill id

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

Referenced by getChildsOfNode(), and getNode().

    {
        $id_parts = explode(":", $a_vtree_id);
        if ($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;
    }

Here is the caller graph for this function:

getFirstUncommonAncestors()

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

protected

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

References getPath().

Referenced by getOrderedNodeset().

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

Here is the call graph for this function:

Here is the caller graph for this function:

getIncludeDrafts()

ilVirtualSkillTree::getIncludeDrafts

(

)

Get include drafts.

Returns

bool include drafts

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

References $include_drafts.

Referenced by getChildsOfNode().

    {
        return $this->include_drafts;
    }

Here is the caller graph for this function:

getIncludeOutdated()

ilVirtualSkillTree::getIncludeOutdated

(

)

Get include outdated.

Returns

bool include outdated

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

References $include_outdated.

Referenced by getChildsOfNode().

    {
        return $this->include_outdated;
    }

Here is the caller graph for this function:

getNode()

ilVirtualSkillTree::getNode

(

$a_id

)

Get node.

Parameters

string

$a_id

vtree id

Returns

array node array

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

References ilSkillTemplateReference\_lookupTemplateId(), and getCSkillIdForVTreeId().

Referenced by getSubTreeForCSkillId().

    {
        $id_parts = explode(":", $a_id);
        $skl_tree_id = $id_parts[0];
        $skl_template_tree_id = $id_parts[1];
    
        if ($skl_template_tree_id == 0 || (ilSkillTemplateReference::_lookupTemplateId($skl_tree_id)
                    == $skl_template_tree_id)) {
            $node_data = $this->tree->getNodeData($skl_tree_id);
            $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_id;
        $cid = $this->getCSkillIdForVTreeId($a_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;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getNodeTitle()

ilVirtualSkillTree::getNodeTitle

(

$a_node

)

Get node content.

Parameters

array

$a_node

node data

Returns

string title

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

References $lng, and $title.

    {
        $lng = $this->lng;

        $a_parent_id_parts = explode(":", $a_node["id"]);
        $a_parent_skl_tree_id = $a_parent_id_parts[0];
        $a_parent_skl_template_tree_id = $a_parent_id_parts[1];
        
        // title
        $title = $a_node["title"];
        
        // root?
        if ($a_node["type"] == "skrt") {
            $lng->txt("skmg_skills");
        } else {
            if ($a_node["type"] == "sktr") {
                //                              include_once("./Services/Skill/classes/class.ilSkillTemplateReference.php");
//                              $title.= " (".ilSkillTreeNode::_lookupTitle($a_parent_skl_template_tree_id).")";
            }
        }
        
        return $title;
    }

getOrderedNodeset()

ilVirtualSkillTree::getOrderedNodeset	(		$c_skill_ids,
			$a_skill_id_key = "",
			$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 373 of file class.ilVirtualSkillTree.php.

References $DIC, getFirstUncommonAncestors(), and getVTreeIdForCSkillId().

    {
        global $DIC;

        $db = $DIC->database();

        if (self::$order_node_data == null) {
            $node_data = array();
            $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[$rec["child"]] = array(
                    "parent" => $rec["parent"],
                    "lft" => $rec["lft"],
                    "order_nr" => $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) {

            // 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)) {
                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)) {
                    return ($node_data[$ua[0]]["order_nr"] - $node_data[$ua[1]]["order_nr"]);
                }
            }

            return 0;
        });
        
        return $c_skill_ids;
    }

Here is the call graph for this function:

getPath()

ilVirtualSkillTree::getPath (   $a,   $node_data  )

protected

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

References $path.

Referenced by getFirstUncommonAncestors().

    {
        $path[] = $a;
        while ($node_data[$a]["parent"] != 0) {
            $a = $node_data[$a]["parent"];
            $path[] = $a;
        }
        return array_reverse($path);
    }

Here is the caller graph for this function:

getRootNode()

ilVirtualSkillTree::getRootNode

(

)

Get root node.

Returns

array root node array

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

    {
        $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	(		$a_cskill_id,
			$a_only_basic = false
	)

Get sub tree.

Parameters

string	$a_cskill_id	cskill id
bool	$a_only_basic	return only basic skills (and basic skill templates)

Returns

array node array

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

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

    {
        $id_parts = explode(":", $a_cskill_id);
        if ($id_parts[1] == 0) {
            $id = $id_parts[0] . ":0";
        } else {
            $id = $id_parts[1] . ":" . $id_parts[0];
        }
        
        $result = array();

        $node = $this->getNode($id);
        if (!$a_only_basic || in_array($node["type"], array("skll", "sktp")) ||
            ($node["type"] == "sktr" && ilSkillTreeNode::_lookupType($node["skill_id"]) == "sktp")) {
            $result[] = $node;
        }
        $this->__getSubTreeRec($id, $result, $a_only_basic);
                
        return $result;
    }

Here is the call graph for this function:

getVTreeIdForCSkillId()

ilVirtualSkillTree::getVTreeIdForCSkillId

(

$a_cskill_id

)

Get tree id for common skill id.

Parameters

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

References $id.

Referenced by getOrderedNodeset().

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

Here is the caller graph for this function:

isDraft()

ilVirtualSkillTree::isDraft

(

$a_node_id

)

Is draft.

Parameters

int

$a_node_id

node id

Returns

bool is draft true/false

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

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

isOutdated()

ilVirtualSkillTree::isOutdated

(

$a_node_id

)

Is outdated.

Parameters

int

$a_node_id

node id

Returns

bool is outdated true/false

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

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

setIncludeDrafts()

ilVirtualSkillTree::setIncludeDrafts

(

$a_val

)

Set include drafts.

Parameters

bool

$a_val

include drafts

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

    {
        $this->include_drafts = $a_val;
    }

setIncludeOutdated()

ilVirtualSkillTree::setIncludeOutdated

(

$a_val

)

Set include outdated.

Parameters

bool

$a_val

include outdated

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

    {
        $this->include_outdated = $a_val;
    }

Field Documentation

$drafts

ilVirtualSkillTree::$drafts = array()

protected

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

Referenced by getChildsOfNode().

$include_drafts

ilVirtualSkillTree::$include_drafts = false

protected

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

Referenced by getIncludeDrafts().

$include_outdated

ilVirtualSkillTree::$include_outdated = false

protected

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

Referenced by getIncludeOutdated().

$lng

ilVirtualSkillTree::$lng

protected

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

Referenced by getNodeTitle().

$order_node_data

ilVirtualSkillTree::$order_node_data = null

staticprotected

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

$outdated

ilVirtualSkillTree::$outdated = array()

protected

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

Referenced by getChildsOfNode().

---

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

• Services/Skill/classes/class.ilVirtualSkillTree.php