Skill tree manager. More...

Collaboration diagram for ILIAS\Skill\Tree\SkillTreeNodeManager:

Public Member Functions
	__construct (int $skill_tree_id, SkillTreeFactory $tree_factory)

	putIntoTree (\ilSkillTreeNode $node, int $parent_node_id, int $a_target_node_id=0)

	getWrittenPath (int $node_id, int $tref_id=0)

	getRootId ()

	clipboardCut (array $a_ids)
	Cut and copy a set of skills/skill categories into the clipboard. More...

	clipboardCopy (array $a_ids)
	Copy a set of skills/skill categories into the clipboard. More...

	insertItemsFromClip (string $a_type, int $a_obj_id)
	Insert basic skills from clipboard. More...

	saveChildsOrder (int $a_par_id, array $a_childs_order, bool $a_templates=false)

	getTopTemplates ()
	Get top skill templates and template categories. More...

Static Public Member Functions
static	clearClipboard ()
	Remove all skill items from clipboard. More...

Protected Member Functions
	pasteTree (int $a_item_id, int $a_parent_id, int $a_target, string $a_insert_time, array &$a_copied_nodes, bool $a_as_copy=false, bool $a_add_suffix=false)
	Paste item (tree) from clipboard to skill tree. More...

Protected Attributes
int	$skill_tree_id = 0

ilSkillTree	$tree

ilObjUser	$user

Detailed Description

Skill tree manager.

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

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

Constructor & Destructor Documentation

◆ __construct()

ILIAS\Skill\Tree\SkillTreeNodeManager::__construct	(	int	$skill_tree_id,
		SkillTreeFactory	$tree_factory
	)

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

    {
        global $DIC;
 
        $this->user = $DIC->user();
 
        $this->skill_tree_id = $skill_tree_id;
        $this->tree = $tree_factory->getTreeById($skill_tree_id);
    }

References $DIC, ILIAS\Skill\Tree\SkillTreeNodeManager\$skill_tree_id, ILIAS\Skill\Tree\SkillTreeFactory\getTreeById(), and ILIAS\Repository\user().

Here is the call graph for this function:

Member Function Documentation

◆ clearClipboard()

static ILIAS\Skill\Tree\SkillTreeNodeManager::clearClipboard ( )

static

Remove all skill items from clipboard.

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

                                           : void
    {
        global $DIC;
 
        $ilUser = $DIC->user();
 
        $ilUser->clipboardDeleteObjectsOfType("skll");
        $ilUser->clipboardDeleteObjectsOfType("scat");
        $ilUser->clipboardDeleteObjectsOfType("sktr");
        $ilUser->clipboardDeleteObjectsOfType("sktp");
        $ilUser->clipboardDeleteObjectsOfType("sctp");
        \ilEditClipboard::clear();
    }

References $DIC, $ilUser, and ilEditClipboard\clear().

Referenced by ILIAS\Skill\Tree\SkillTreeNodeManager\clipboardCopy(), ILIAS\Skill\Tree\SkillTreeNodeManager\clipboardCut(), and ILIAS\Skill\Tree\SkillTreeNodeManager\insertItemsFromClip().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ clipboardCopy()

ILIAS\Skill\Tree\SkillTreeNodeManager::clipboardCopy ( array $a_ids )

Copy a set of skills/skill categories into the clipboard.

Definition at line 151 of file class.SkillTreeNodeManager.php.

                                               : void
    {
        $ilUser = $this->user;
 
        $this->clearClipboard();
        $tree = $this->tree;
 
        // put them into the clipboard
        $time = date("Y-m-d H:i:s", time());
        $order = 0;
        foreach ($a_ids as $id) {
            $curnode = "";
            if ($tree->isInTree($id)) {
                $curnode = $tree->getNodeData($id);
                $subnodes = $tree->getSubTree($curnode);
                foreach ($subnodes as $subnode) {
                    if ($subnode["child"] != $id) {
                        $ilUser->addObjectToClipboard(
                            $subnode["child"],
                            $subnode["type"],
                            $subnode["title"],
                            $subnode["parent"],
                            $time,
                            $subnode["lft"]
                        );
                    }
                }
            }
            $order = ($curnode["lft"] > 0)
                ? $curnode["lft"]
                : (int) ($order + 1);
            $ilUser->addObjectToClipboard(
                $id,
                \ilSkillTreeNode::_lookupType($id),
                \ilSkillTreeNode::_lookupTitle($id),
                0,
                $time,
                $order
            );
        }
        \ilEditClipboard::setAction("copy");
    }

References $id, $ilUser, ILIAS\Skill\Tree\SkillTreeNodeManager\$tree, ILIAS\Skill\Tree\SkillTreeNodeManager\$user, ilSkillTreeNode\_lookupTitle(), ilSkillTreeNode\_lookupType(), ILIAS\Skill\Tree\SkillTreeNodeManager\clearClipboard(), ilTree\getNodeData(), ilTree\getSubTree(), ilTree\isInTree(), and ilEditClipboard\setAction().

Referenced by ILIAS\Skill\Tree\SkillTreeNodeManager\clipboardCut().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ clipboardCut()

ILIAS\Skill\Tree\SkillTreeNodeManager::clipboardCut ( array $a_ids )

Cut and copy a set of skills/skill categories into the clipboard.

Definition at line 109 of file class.SkillTreeNodeManager.php.

                                              : void
    {
        $this->clearClipboard();
        $tree = $this->tree;
 
        $cut_ids = [];
        if (!is_array($a_ids)) {
            return;
        } else {
            // get all "top" ids, i.e. remove ids, that have a selected parent
            foreach ($a_ids as $id) {
                $path = $tree->getPathId($id);
                $take = true;
                foreach ($path as $path_id) {
                    if ($path_id != $id && in_array($path_id, $a_ids)) {
                        $take = false;
                    }
                }
                if ($take) {
                    $cut_ids[] = $id;
                }
            }
        }
 
        $this->clipboardCopy($cut_ids);
 
        // remove the objects from the tree
        // note: we are getting skills/categories which are *not* in the tree
        // we do not delete any pages/chapters here
        foreach ($cut_ids as $id) {
            $curnode = $tree->getNodeData($id);
            if ($tree->isInTree($id)) {
                $tree->deleteTree($curnode);
            }
        }
        // @todo check if needed
        \ilEditClipboard::setAction("cut");
    }

References $id, $path, ILIAS\Skill\Tree\SkillTreeNodeManager\$tree, ILIAS\Skill\Tree\SkillTreeNodeManager\clearClipboard(), ILIAS\Skill\Tree\SkillTreeNodeManager\clipboardCopy(), ilTree\deleteTree(), ilTree\getNodeData(), ilTree\getPathId(), ilTree\isInTree(), and ilEditClipboard\setAction().

Here is the call graph for this function:

◆ getRootId()

ILIAS\Skill\Tree\SkillTreeNodeManager::getRootId ( )

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

                               : int
    {
        return $this->tree->readRootId();
    }

◆ getTopTemplates()

ILIAS\Skill\Tree\SkillTreeNodeManager::getTopTemplates ( )

Get top skill templates and template categories.

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

                                     : array
    {
        return $this->tree->getChildsByTypeFilter(
            $this->tree->readRootId(),
            array("sktp", "sctp")
        );
    }

◆ getWrittenPath()

ILIAS\Skill\Tree\SkillTreeNodeManager::getWrittenPath	(	int	$node_id,
		int	$tref_id = `0`
	)

Definition at line 87 of file class.SkillTreeNodeManager.php.

                                                                  : string
    {
        $path = $this->tree->getSkillTreePath($node_id, $tref_id);
 
        $path_items = [];
        foreach ($path as $p) {
            if ($p["type"] != "skrt") {
                $path_items[] = $p["title"];
            }
        }
        return implode(" > ", $path_items);
    }

References $path.

◆ insertItemsFromClip()

ILIAS\Skill\Tree\SkillTreeNodeManager::insertItemsFromClip	(	string	$a_type,
		int	$a_obj_id
	)

Insert basic skills from clipboard.

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

                                                                      : array
    {
        $ilUser = $this->user;
 
        $parent_id = $a_obj_id;
        $target = \ilTree::POS_LAST_NODE;
 
        // cut and paste
        $skills = $ilUser->getClipboardObjects($a_type);  // this will get all skills _regardless_ of level
        $copied_nodes = [];
        foreach ($skills as $skill) {
            // if skill was already copied as part of tree - do not copy it again
            if (!in_array($skill["id"], array_keys($copied_nodes))) {
                $cid = $this->pasteTree(
                    (int) $skill["id"],
                    $parent_id,
                    $target,
                    $skill["insert_time"],
                    $copied_nodes,
                    (\ilEditClipboard::getAction() == "copy"),
                    true
                );
                //                              $target = $cid;
            }
        }
 
        $this->clearClipboard();
 
        $this->saveChildsOrder(
            $a_obj_id,
            [],
            in_array($a_type, array("sktp", "sctp"))
        );
 
        return $copied_nodes;
    }

References $ilUser, ILIAS\Skill\Tree\SkillTreeNodeManager\$user, ILIAS\Skill\Tree\SkillTreeNodeManager\clearClipboard(), ilEditClipboard\getAction(), ILIAS\Skill\Tree\SkillTreeNodeManager\pasteTree(), ilTree\POS_LAST_NODE, and ILIAS\Skill\Tree\SkillTreeNodeManager\saveChildsOrder().

Here is the call graph for this function:

◆ pasteTree()

ILIAS\Skill\Tree\SkillTreeNodeManager::pasteTree	(	int	$a_item_id,
		int	$a_parent_id,
		int	$a_target,
		string	$a_insert_time,
		array &	$a_copied_nodes,
		bool	$a_as_copy = `false`,
		bool	$a_add_suffix = `false`
	)

protected

Paste item (tree) from clipboard to skill tree.

Definition at line 256 of file class.SkillTreeNodeManager.php.

     : int {
        global $DIC;
 
        $ilUser = $this->user;
        $ilLog = $DIC["ilLog"];
        $lng = $DIC->language();
 
        $item_type = \ilSkillTreeNode::_lookupType($a_item_id);
 
        $item = null;
        if ($item_type == "scat") {
            $item = new \ilSkillCategory($a_item_id);
        } elseif ($item_type == "skll") {
            $item = new \ilBasicSkill($a_item_id);
        } elseif ($item_type == "sktr") {
            $item = new \ilSkillTemplateReference($a_item_id);
        } elseif ($item_type == "sktp") {
            $item = new \ilBasicSkillTemplate($a_item_id);
        } elseif ($item_type == "sctp") {
            $item = new \ilSkillTemplateCategory($a_item_id);
        }
 
        $ilLog->write("Getting from clipboard type " . $item_type . ", " .
            "Item ID: " . $a_item_id);
 
        if ($a_as_copy) {
            $target_item = $item->copy();
            if ($a_add_suffix) {
                $target_item->setTitle($target_item->getTitle() . " " . $lng->txt("copy_of_suffix"));
                $target_item->update();
            }
            $a_copied_nodes[$item->getId()] = $target_item->getId();
        } else {
            $target_item = $item;
        }
 
        $ilLog->write("Putting into skill tree type " . $target_item->getType() .
            "Item ID: " . $target_item->getId() . ", Parent: " . $a_parent_id . ", " .
            "Target: " . $a_target);
 
        $this->putIntoTree($target_item, $a_parent_id, $a_target);
 
        $childs = $ilUser->getClipboardChilds($item->getId(), $a_insert_time);
 
        foreach ($childs as $child) {
            $this->pasteTree(
                (int) $child["id"],
                $target_item->getId(),
                \ilTree::POS_LAST_NODE,
                $a_insert_time,
                $a_copied_nodes,
                $a_as_copy
            );
        }
 
        return $target_item->getId();
    }

Referenced by ILIAS\Skill\Tree\SkillTreeNodeManager\insertItemsFromClip().

Here is the caller graph for this function:

◆ putIntoTree()

ILIAS\Skill\Tree\SkillTreeNodeManager::putIntoTree	(	\ilSkillTreeNode	$node,
		int	$parent_node_id,
		int	$a_target_node_id = `0`
	)

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

                                                                                                       : void
    {
        $tree = $this->tree;
        $node->setOrderNr($tree->getMaxOrderNr($parent_node_id) + 10);
        $node->update();
 
        // determine parent
        $parent_id = ($parent_node_id <= 0)
            ? $tree->readRootId()
            : $parent_node_id;
 
        // make a check, whether the type of object is allowed under
        // the parent
        $allowed = array(
            "skrt" => array("skll", "scat", "sktr", "sktp", "sctp"),
            "scat" => array("skll", "scat", "sktr"),
            "sctp" => array("sktp", "sctp"));
        $par_type = \ilSkillTreeNode::_lookupType($parent_id);
        if (!is_array($allowed[$par_type]) ||
            !in_array($node->getType(), $allowed[$par_type])) {
            return;
        }
 
        // determine target
        if ($a_target_node_id != 0) {
            $target = $a_target_node_id;
        } else {
            // determine last child that serves as predecessor
            $childs = $tree->getChilds($parent_id);
 
            if (count($childs) == 0) {
                $target = \ilTree::POS_FIRST_NODE;
            } else {
                $target = $childs[count($childs) - 1]["obj_id"];
            }
        }
 
        if ($tree->isInTree($parent_id) && !$tree->isInTree($node->getId())) {
            $tree->insertNode($node->getId(), $parent_id, $target);
        }
    }

References ILIAS\Skill\Tree\SkillTreeNodeManager\$tree, ilSkillTreeNode\_lookupType(), ilTree\getChilds(), ilSkillTreeNode\getId(), ilSkillTree\getMaxOrderNr(), ilSkillTreeNode\getType(), ilTree\insertNode(), ilTree\isInTree(), ilTree\POS_FIRST_NODE, ilTree\readRootId(), ilSkillTreeNode\setOrderNr(), and ilSkillTreeNode\update().

Here is the call graph for this function:

◆ saveChildsOrder()

ILIAS\Skill\Tree\SkillTreeNodeManager::saveChildsOrder	(	int	$a_par_id,
		array	$a_childs_order,
		bool	$a_templates = `false`
	)

Definition at line 322 of file class.SkillTreeNodeManager.php.

                                                                                                    : void
    {
        $skill_tree = $this->tree;
 
        if ($a_par_id != $skill_tree->readRootId()) {
            $childs = $skill_tree->getChilds($a_par_id);
        } else {
            if ($a_templates) {
                $childs = $skill_tree->getChildsByTypeFilter(
                    $a_par_id,
                    array("skrt", "sktp", "sctp")
                );
            } else {
                $childs = $skill_tree->getChildsByTypeFilter(
                    $a_par_id,
                    array("skrt", "skll", "scat", "sktr")
                );
            }
        }
 
        foreach ($childs as $k => $c) {
            if (isset($a_childs_order[$c["child"]])) {
                $childs[$k]["order_nr"] = (int) $a_childs_order[$c["child"]];
            }
        }
 
        $childs = ilArrayUtil::sortArray($childs, "order_nr", "asc", true);
 
        $cnt = 10;
        foreach ($childs as $c) {
            \ilSkillTreeNode::_writeOrderNr($c["child"], $cnt);
            $cnt += 10;
        }
    }