class.ilRepUtil.php

Go to the documentation of this file.

<?php
/* Copyright (c) 1998-2009 ILIAS open source, Extended GPL, see docs/LICENSE */

include_once("./Services/Object/classes/class.ilObjectFactory.php");

class ilRepUtil
{

        static public function deleteObjects($a_cur_ref_id, $a_ids)
        {
                global $ilAppEventHandler, $rbacsystem, $rbacadmin, $log, $ilUser, $tree, $lng,
                        $ilSetting;
                
                include_once './Services/Payment/classes/class.ilPaymentObject.php';
                include_once("./Services/Repository/exceptions/class.ilRepositoryException.php");
                
                // Remove duplicate ids from array
                $a_ids = array_unique((array) $a_ids);

                // FOR ALL SELECTED OBJECTS
                foreach ($a_ids as $id)
                {
                        if ($tree->isDeleted($id))
                        {
                                $log->write(__METHOD__.': Object with ref_id: '.$id.' already deleted.');
                                throw new ilRepositoryException($lng->txt("msg_obj_already_deleted"));
                        }
                        
                        // GET COMPLETE NODE_DATA OF ALL SUBTREE NODES
                        $node_data = $tree->getNodeData($id);
                        $subtree_nodes = $tree->getSubTree($node_data);

                        $all_node_data[] = $node_data;
                        $all_subtree_nodes[] = $subtree_nodes;

                        // CHECK DELETE PERMISSION OF ALL OBJECTS
                        foreach ($subtree_nodes as $node)
                        {
                                if($node['type'] == 'rolf')
                                {
                                        continue;
                                }
                                if (!$rbacsystem->checkAccess('delete',$node["child"]))
                                {
                                        $not_deletable[] = $node["child"];
                                        $perform_delete = false;
                                }
                                else if(ilPaymentObject::_isBuyable($node['child']))
                                {
                                        $buyable[] = $node['child'];
                                        $perform_delete = false;
                                }
                        }
                }

                // IF THERE IS ANY OBJECT WITH NO PERMISSION TO DELETE
                if (count($not_deletable))
                {
                        $not_deletable = implode(',',$not_deletable);
                        ilSession::clear("saved_post");
                        throw new ilRepositoryException(
                                $lng->txt("msg_no_perm_delete")." ".$not_deletable."<br/>".$lng->txt("msg_cancel"));
                }

                if(count($buyable))
                {
                        foreach($buyable as $id)
                        {
                                $tmp_object = ilObjectFactory::getInstanceByRefId($id);

                                $titles[] = $tmp_object->getTitle();
                        }
                        $title_str = implode(',',$titles);

                        throw new ilRepositoryException(
                                $lng->txt('msg_obj_not_deletable_sold').' '.$title_str);
                }

                // DELETE THEM
                if (!$all_node_data[0]["type"])
                {
// alex: this branch looks suspicious to me... I deactivate it for
// now. Objects that aren't in the tree should overwrite this method.
throw new ilRepositoryException($lng->txt("ilRepUtil::deleteObjects: Type information missing."));
                        // OBJECTS ARE NO 'TREE OBJECTS'
                        if ($rbacsystem->checkAccess('delete', $a_cur_ref_id))
                        {
                                foreach($a_ids as $id)
                                {
                                        $obj =& ilObjectFactory::getInstanceByObjId($id);
                                        $obj->delete();
                                        
                                        // write log entry
                                        $log->write("ilObjectGUI::confirmedDeleteObject(), deleted obj_id ".$obj->getId().
                                                ", type: ".$obj->getType().", title: ".$obj->getTitle());
                                }
                        }
                        else
                        {
                                throw new ilRepositoryException(
                                        $lng->txt("no_perm_delete")."<br/>".$lng->txt("msg_cancel"));
                        }
                }
                else
                {
                        // SAVE SUBTREE AND DELETE SUBTREE FROM TREE
                        $affected_ids = array();
                        foreach ($a_ids as $id)
                        {
                                if($tree->isDeleted($id))
                                {
                                        $log->write(__METHOD__.': Object with ref_id: '.$id.' already deleted.');
                                        throw new ilRepositoryException($lng->txt("msg_obj_already_deleted"));
                                }
                                
                                // DELETE OLD PERMISSION ENTRIES
                                $subnodes = $tree->getSubtree($tree->getNodeData($id));

                                foreach ($subnodes as $subnode)
                                {
                                        $rbacadmin->revokePermission($subnode["child"]);
                                        // remove item from all user desktops
                                        $affected_users = ilUtil::removeItemFromDesktops($subnode["child"]);
                                        
                                        $affected_ids[$subnode["child"]] = $subnode["child"];
                                        
                                        // TODO: inform users by mail that object $id was deleted
                                        //$mail->sendMail($id,$msg,$affected_users);
                                        // should go to appevents at the end
                                }
                                
                                // TODO: needs other handling
                                // This class shouldn't have to know anything about ECS
                                include_once('./Services/WebServices/ECS/classes/class.ilECSObjectSettings.php');
                                ilECSObjectSettings::_handleDelete($subnodes);                          

                                if(!$tree->saveSubTree($id, true))
                                {
                                        $log->write(__METHOD__.': Object with ref_id: '.$id.' already deleted.');
                                        throw new ilRepositoryException($lng->txt("msg_obj_already_deleted"));
                                }

                                // write log entry
                                $log->write("ilObjectGUI::confirmedDeleteObject(), moved ref_id ".$id.
                                        " to trash");
                                
                                // remove item from all user desktops
                                $affected_users = ilUtil::removeItemFromDesktops($id);
                                
                                $affected_ids[$id] = $id;

                                // TODO: inform users by mail that object $id was deleted
                                //$mail->sendMail($id,$msg,$affected_users);
                        }
                        
                        // send global events
                        foreach ($affected_ids as $aid)
                        {
                                $ilAppEventHandler->raise("Services/Object", "toTrash",
                                        array("obj_id" => ilObject::_lookupObjId($aid),
                                        "ref_id" => $aid));
                        }
                        // inform other objects in hierarchy about paste operation
                        //$this->object->notify("confirmedDelete", $_GET["ref_id"],$_GET["parent_non_rbac_id"],$_GET["ref_id"],$_SESSION["saved_post"]);
                }
                
                if (!$ilSetting->get('enable_trash'))
                {
                        ilRepUtil::removeObjectsFromSystem($a_ids);
                }
        }
        
        public function removeObjectsFromSystem($a_ref_ids, $a_from_recovery_folder = false)
        {
                global $rbacsystem, $log, $ilAppEventHandler, $tree;
                
                $affected_ids = array();
                
                // DELETE THEM
                foreach ($a_ref_ids as $id)
                {
                        // GET COMPLETE NODE_DATA OF ALL SUBTREE NODES
                        if (!$a_from_recovery_folder)
                        {
                                $saved_tree = new ilTree(-(int)$id);
                                $node_data = $saved_tree->getNodeData($id);
                                $subtree_nodes = $saved_tree->getSubTree($node_data);
                        }
                        else
                        {
                                $node_data = $tree->getNodeData($id);
                                $subtree_nodes = $tree->getSubTree($node_data);
                        }

                        // BEGIN ChangeEvent: Record remove from system.
                        require_once('Services/Tracking/classes/class.ilChangeEvent.php');
                        // Record write event
                        global $ilUser, $tree;
                        $parent_data = $tree->getParentNodeData($node_data['ref_id']);
                        ilChangeEvent::_recordWriteEvent($node_data['obj_id'], $ilUser->getId(), 'purge', 
                                $parent_data['obj_id']);                        
                        // END ChangeEvent: Record remove from system.

                        // remember already checked deleted node_ids
                        if (!$a_from_recovery_folder)
                        {
                                $checked[] = -(int) $id;
                        }
                        else
                        {
                                $checked[] = $id;
                        }

                        // dive in recursive manner in each already deleted subtrees and remove these objects too
                        ilRepUtil::removeDeletedNodes($id, $checked, true, $affected_ids);

                        foreach ($subtree_nodes as $node)
                        {
                                if(!$node_obj =& ilObjectFactory::getInstanceByRefId($node["ref_id"],false))
                                {
                                        continue;
                                }

                                // write log entry
                                $log->write("ilObjectGUI::removeFromSystemObject(), delete obj_id: ".$node_obj->getId().
                                        ", ref_id: ".$node_obj->getRefId().", type: ".$node_obj->getType().", ".
                                        "title: ".$node_obj->getTitle());
                                $affected_ids[$node["ref_id"]] = array("ref_id" => $node["ref_id"],
                                        "obj_id" => $node_obj->getId(), "type" => $node_obj->getType());
                                        
                                // this is due to bug #1860 (even if this will not completely fix it)
                                // and the fact, that media pool folders may find their way into
                                // the recovery folder (what results in broken pools, if the are deleted)
                                // Alex, 2006-07-21
                                if (!$a_from_recovery_folder || $node_obj->getType() != "fold")
                                {
                                        $node_obj->delete();
                                }
                        }

                        // Use the saved tree object here (negative tree_id)
                        if (!$a_from_recovery_folder)
                        {
                                $saved_tree->deleteTree($node_data);
                        }
                        else
                        {
                                $tree->deleteTree($node_data);
                        }

                        // write log entry
                        $log->write("ilObjectGUI::removeFromSystemObject(), deleted tree, tree_id: ".$node_data["tree"].
                                ", child: ".$node_data["child"]);

                }
                
                // send global events
                foreach ($affected_ids as $aid)
                {
                        $ilAppEventHandler->raise("Services/Object", "delete",
                                array("obj_id" => $aid["obj_id"],
                                "ref_id" => $aid["ref_id"],
                                "type" => $aid["type"]));
                }
        }
        
        private function removeDeletedNodes($a_node_id, $a_checked, $a_delete_objects,
                &$a_affected_ids)
        {
                global $log, $ilDB, $tree;
                
                $q = "SELECT tree FROM tree WHERE parent= ".
                        $ilDB->quote($a_node_id, "integer")." AND tree < 0";
                
                $r = $ilDB->query($q);

                while($row = $ilDB->fetchObject($r))
                {
                        // only continue recursion if fetched node wasn't touched already!
                        if (!in_array($row->tree,$a_checked))
                        {
                                $deleted_tree = new ilTree($row->tree);
                                $a_checked[] = $row->tree;

                                $row->tree = $row->tree * (-1);
                                $del_node_data = $deleted_tree->getNodeData($row->tree);
                                $del_subtree_nodes = $deleted_tree->getSubTree($del_node_data);

                                ilRepUtil::removeDeletedNodes($row->tree,$a_checked, $a_delete_objects, $a_affected_ids);
                        
                                if ($a_delete_objects)
                                {
                                        foreach ($del_subtree_nodes as $node)
                                        {
                                                $node_obj =& ilObjectFactory::getInstanceByRefId($node["ref_id"]);
                                                
                                                // write log entry
                                                $log->write("ilObjectGUI::removeDeletedNodes(), delete obj_id: ".$node_obj->getId().
                                                        ", ref_id: ".$node_obj->getRefId().", type: ".$node_obj->getType().", ".
                                                        "title: ".$node_obj->getTitle());
                                                $a_affected_ids[$node["ref_id"]] = array("ref_id" => $node["ref_id"],
                                                        "obj_id" => $node_obj->getId(), "type" => $node_obj->getType());
                                                                                                                
                                                $node_obj->delete();
                                                
                                        }
                                }
                        
                                $tree->deleteTree($del_node_data);
                                
                                // write log entry
                                $log->write("ilObjectGUI::removeDeletedNodes(), deleted tree, tree_id: ".$del_node_data["tree"].
                                        ", child: ".$del_node_data["child"]);
                        }
                }
                
                return true;
        }
        
        function restoreObjects($a_cur_ref_id, $a_ref_ids)
        {
                global $rbacsystem, $log, $ilAppEventHandler, $lng, $tree;

                $cur_obj_id = ilObject::_lookupObjId($a_cur_ref_id);
                
                foreach ($a_ref_ids as $id)
                {
                        $obj_data = ilObjectFactory::getInstanceByRefId($id);

                        if (!$rbacsystem->checkAccess('create', $a_cur_ref_id, $obj_data->getType()))
                        {
                                $no_create[] = ilObject::_lookupTitle(ilObject::_lookupObjId($id));
                        }
                }

                if (count($no_create))
                {
                        include_once("./Services/Repository/exceptions/class.ilRepositoryException.php");
                        throw new ilRepositoryException($lng->txt("msg_no_perm_paste")." ".implode(',',$no_create));
                }
                
                $affected_ids = array();
                
                foreach ($a_ref_ids as $id)
                {
                        $affected_ids[$id] = $id;
                        
                        // INSERT AND SET PERMISSIONS
                        ilRepUtil::insertSavedNodes($id, $a_cur_ref_id, -(int) $id, $affected_ids);
                        
                        // DELETE SAVED TREE
                        $saved_tree = new ilTree(-(int)$id);
                        $saved_tree->deleteTree($saved_tree->getNodeData($id));
                        
                        // BEGIN ChangeEvent: Record undelete. 
                        require_once('Services/Tracking/classes/class.ilChangeEvent.php');
                        global $ilUser;

                        // already done
                        //$node_data = $saved_tree->getNodeData($id);
                        //$saved_tree->deleteTree($node_data);

                        // Record undelete event
                        // fetch node data from current node
                        //
                        // do not read from tree
                        #$node_data = $tree->getNodeData($id);
                        #$parent_data = $tree->getParentNodeData($node_data['ref_id']);
                        
                        ilChangeEvent::_recordWriteEvent(
                                        ilObject::_lookupObjId($id),
                                        $ilUser->getId(), 
                                        'undelete', 
                                        ilObject::_lookupObjId($tree->getParentId($id))
                        );
                        ilChangeEvent::_catchupWriteEvents(
                                        $cur_obj_id, 
                                        $ilUser->getId());                      
                        // END PATCH ChangeEvent: Record undelete.
                        
                }

                // send events
                foreach ($affected_ids as $id)
                {
                        // send global event
                        $ilAppEventHandler->raise("Services/Object", "undelete",
                                array("obj_id" => ilObject::_lookupObjId($id), "ref_id" => $id));
                }
        }
        
        private function insertSavedNodes($a_source_id, $a_dest_id, $a_tree_id, &$a_affected_ids)
        {
                global $rbacadmin, $rbacreview, $log, $tree;

                $tree->insertNode($a_source_id,$a_dest_id, IL_LAST_NODE, true);
                $a_affected_ids[$a_source_id] = $a_source_id;
                
                // write log entry
                $log->write("ilRepUtil::insertSavedNodes(), restored ref_id $a_source_id from trash");

                // SET PERMISSIONS
                $parentRoles = $rbacreview->getParentRoleIds($a_dest_id);
                $obj =& ilObjectFactory::getInstanceByRefId($a_source_id);

                foreach ($parentRoles as $parRol)
                {
                        $ops = $rbacreview->getOperationsOfRole($parRol["obj_id"], $obj->getType(), $parRol["parent"]);
                        $rbacadmin->grantPermission($parRol["obj_id"],$ops,$a_source_id);
                }

                $saved_tree = new ilTree($a_tree_id);
                $childs = $saved_tree->getChilds($a_source_id);

                foreach ($childs as $child)
                {
                        ilRepUtil::insertSavedNodes($child["child"],$a_source_id,$a_tree_id,$a_affected_ids);
                }
        }


}