ilRepositoryTrashGUI Class Reference

Repository GUI Utilities. More...

Collaboration diagram for ilRepositoryTrashGUI:

Public Member Functions
	executeCommand ()
	restoreToNewLocation (ilPropertyFormGUI $form=null)
	doRestoreToNewLocation ()
	showDeleteConfirmation (?array $a_ids, bool $a_supress_message=false)
	handleMultiReferences (int $a_obj_id, int $a_ref_id, string $a_form_name)
	showTrashTable (int $a_ref_id)
	restoreObjects (int $a_cur_ref_id, array $a_ref_ids)
	Restore objects from trash. More...
	deleteObjects (int $a_cur_ref_id, array $a_ref_ids)
	removeObjectsFromSystem (array $a_ref_ids, bool $a_from_recovery_folder=false)
	confirmRemoveFromSystemObject (array $a_ids)
	Confirmation for trash. More...

Protected Member Functions
	cancel ()
	initFormTrashTargetLocation ()
	buildPath (array $ref_ids)
	Build path with deep-link. More...

Protected Attributes
ilLanguage	$lng
ilSetting	$settings
ilCtrl	$ctrl
ilGlobalTemplateInterface	$tpl
ilObjectDefinition	$obj_definition
ilAccessHandler	$access
ilTree	$tree
ilLogger	$logger = null
TrashGUIRequest	$request
object	$parent_gui
string	$parent_cmd

Detailed Description

Repository GUI Utilities.

Author

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

Definition at line 27 of file class.ilRepositoryTrashGUI.php.

Member Function Documentation

buildPath()

ilRepositoryTrashGUI::buildPath ( array  $ref_ids )

protected

Build path with deep-link.

Definition at line 455 of file class.ilRepositoryTrashGUI.php.

References $data, $path, $ref_id, $tree, ilTree\getPathFull(), and ilUtil\stripSlashes().

Referenced by handleMultiReferences().

                                                : array
    {
        $tree = $this->tree;

        if (!count($ref_ids)) {
            return [];
        }

        $result = [];
        foreach ($ref_ids as $ref_id) {
            $path = "";
            $path_full = $tree->getPathFull($ref_id);
            foreach ($path_full as $idx => $data) {
                if ($idx) {
                    $path .= " » ";
                }
                if ((int) $ref_id !== (int) $data['ref_id']) {
                    $path .= ilUtil::stripSlashes($data['title']);
                } else {
                    $path .= ('<a target="_top" href="' .
                              ilLink::_getLink($data['ref_id'], $data['type']) . '">' .
                              ilUtil::stripSlashes($data['title']) . '</a>');
                }
            }

            $result[] = $path;
        }
        return $result;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

cancel()

ilRepositoryTrashGUI::cancel ( )

protected

Definition at line 85 of file class.ilRepositoryTrashGUI.php.

References ILIAS\Repository\ctrl().

                               : void
    {
        $this->ctrl->returnToParent($this);
    }

Here is the call graph for this function:

confirmRemoveFromSystemObject()

ilRepositoryTrashGUI::confirmRemoveFromSystemObject

(

array

$a_ids

)

Confirmation for trash.

Parameters

array

$a_ids

ref_ids

Definition at line 490 of file class.ilRepositoryTrashGUI.php.

References $ctrl, $id, $lng, $obj_definition, $tpl, ilObject\_getIcon(), ilObject\_lookupObjId(), ilObject\_lookupType(), ilObjectFactory\getClassByType(), ilObjectPlugin\lookupTxtById(), ilGlobalTemplateInterface\setContent(), and ilLanguage\txt().

     : void {
        $ilCtrl = $this->ctrl;
        $lng = $this->lng;
        $objDefinition = $this->obj_definition;
        $tpl = $this->tpl;

        if (!is_array($a_ids)) {
            $a_ids = [$a_ids];
        }

        $cgui = new ilConfirmationGUI();
        $cgui->setFormAction($ilCtrl->getFormAction($this->parent_gui));
        $cgui->setCancel($lng->txt("cancel"), "trash");
        $cgui->setConfirm($lng->txt("confirm"), "removeFromSystem");
        $cgui->setFormName("trash_confirmation");
        $cgui->setHeaderText($lng->txt("info_delete_sure"));

        foreach ($a_ids as $id) {
            $obj_id = ilObject::_lookupObjId($id);
            $type = ilObject::_lookupType($obj_id);
            $title = call_user_func([ilObjectFactory::getClassByType($type), '_lookupTitle'], $obj_id);
            $alt = ($objDefinition->isPlugin($type))
                ? $lng->txt("icon") . " " . ilObjectPlugin::lookupTxtById($type, "obj_" . $type)
                : $lng->txt("icon") . " " . $lng->txt("obj_" . $type);

            $cgui->addItem(
                "trash_id[]",
                $id,
                $title,
                ilObject::_getIcon($obj_id, "small", $type),
                $alt
            );
        }

        $tpl->setContent($cgui->getHTML());
    }

Here is the call graph for this function:

deleteObjects()

ilRepositoryTrashGUI::deleteObjects	(	int	$a_cur_ref_id,
		array	$a_ref_ids
	)

Definition at line 402 of file class.ilRepositoryTrashGUI.php.

References Vendor\Package\$e, $ilSetting, $lng, $settings, ilRepUtil\deleteObjects(), and ilLanguage\txt().

     : void {
        $ilSetting = $this->settings;
        $lng = $this->lng;

        if (!is_array($a_ref_ids) || count($a_ref_ids) === 0) {
            $this->tpl->setOnScreenMessage('failure', $lng->txt("no_checkbox"), true);
        } else {
            try {
                ilRepUtil::deleteObjects($a_cur_ref_id, $a_ref_ids);
                if ($ilSetting->get('enable_trash')) {
                    $this->tpl->setOnScreenMessage('success', $lng->txt("info_deleted"), true);
                } else {
                    $this->tpl->setOnScreenMessage('success', $lng->txt("msg_removed"), true);
                }
            } catch (ilRepositoryException $e) {
                // we catch ilRepositoryException, since this is usually permission related
                // other exceptions are thrown to get call stacks
                $this->tpl->setOnScreenMessage('failure', $e->getMessage(), true);
            }
        }
    }

Here is the call graph for this function:

doRestoreToNewLocation()

ilRepositoryTrashGUI::doRestoreToNewLocation

(

)

Exceptions

ilDatabaseException
ilObjectNotFoundException

Definition at line 115 of file class.ilRepositoryTrashGUI.php.

References Vendor\Package\$e, ILIAS\Repository\ctrl(), initFormTrashTargetLocation(), ILIAS\Repository\lng(), and ilRepUtil\restoreObjects().

                                            : void
    {
        $trash_ids = $this->request->getTrashIds();

        $form = $this->initFormTrashTargetLocation();
        if (!$form->checkInput() && count($trash_ids)) {
            $this->lng->loadLanguageModule('search');
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt('search_no_selection'), true);
            $this->ctrl->returnToParent($this);
        }

        try {
            ilRepUtil::restoreObjects($form->getInput('target_id'), $trash_ids);
            $this->tpl->setOnScreenMessage('success', $this->lng->txt('msg_undeleted'), true);
            $this->ctrl->returnToParent($this);
        } catch (ilRepositoryException $e) {
            $this->tpl->setOnScreenMessage('failure', $e->getMessage(), true);
            $this->ctrl->returnToParent($this);
        }
    }

Here is the call graph for this function:

executeCommand()

ilRepositoryTrashGUI::executeCommand

(

)

Exceptions

ilCtrlException

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

References ILIAS\Repository\ctrl(), and initFormTrashTargetLocation().

                                    : void
    {
        $next_class = $this->ctrl->getNextClass($this);
        switch ($next_class) {
            case "ilpropertyformgui":
                $form = $this->initFormTrashTargetLocation();
                $this->ctrl->forwardCommand($form);
                break;

            default:
                $cmd = $this->ctrl->getCmd('cancel');
                $this->$cmd();
                break;
        }
    }

Here is the call graph for this function:

handleMultiReferences()

ilRepositoryTrashGUI::handleMultiReferences	(	int	$a_obj_id,
		int	$a_ref_id,
		string	$a_form_name
	)

Definition at line 242 of file class.ilRepositoryTrashGUI.php.

References $access, $lng, $path, $tree, ilObject\_getAllReferences(), buildPath(), ilGlobalTemplateInterface\get(), ilTree\isDeleted(), ilLanguage\loadLanguageModule(), ilGlobalTemplateInterface\parseCurrentBlock(), ilGlobalTemplateInterface\setCurrentBlock(), ilGlobalTemplateInterface\setVariable(), and ilLanguage\txt().

Referenced by showDeleteConfirmation().

     : string {
        $lng = $this->lng;
        $ilAccess = $this->access;
        $tree = $this->tree;

        // process

        $all_refs = ilObject::_getAllReferences($a_obj_id);
        if (count($all_refs) > 1) {
            $lng->loadLanguageModule("rep");

            $may_delete_any = 0;
            $counter = 0;
            $items = [];
            foreach ($all_refs as $mref_id) {
                // not the already selected reference, no refs from trash
                if ($mref_id != $a_ref_id && !$tree->isDeleted($mref_id)) {
                    if ($ilAccess->checkAccess("read", "", $mref_id)) {
                        $may_delete = false;
                        if ($ilAccess->checkAccess("delete", "", $mref_id)) {
                            $may_delete = true;
                            $may_delete_any++;
                        }

                        $path = $this->buildPath([$mref_id]);
                        $items[] = [
                            "id" => $mref_id,
                            "path" => array_shift($path),
                            "delete" => $may_delete
                        ];
                    } else {
                        $counter++;
                    }
                }
            }


            // render

            $tpl = new ilTemplate("tpl.rep_multi_ref.html", true, true, "Services/Repository/Trash");

            $tpl->setVariable("TXT_INTRO", $lng->txt("rep_multiple_reference_deletion_intro"));

            if ($may_delete_any) {
                $tpl->setVariable("TXT_INSTRUCTION", $lng->txt("rep_multiple_reference_deletion_instruction"));
            }

            if ($items) {
                $var_name = "mref_id[]";

                foreach ($items as $item) {
                    if ($item["delete"]) {
                        $tpl->setCurrentBlock("cbox");
                        $tpl->setVariable("ITEM_NAME", $var_name);
                        $tpl->setVariable("ITEM_VALUE", $item["id"]);
                    } else {
                        $tpl->setCurrentBlock("item_info");
                        $tpl->setVariable("TXT_ITEM_INFO", $lng->txt("rep_no_permission_to_delete"));
                    }
                    $tpl->parseCurrentBlock();

                    $tpl->setCurrentBlock("item");
                    $tpl->setVariable("ITEM_TITLE", $item["path"]);
                    $tpl->parseCurrentBlock();
                }

                if ($may_delete_any > 1) {
                    $tpl->setCurrentBlock("cbox");
                    $tpl->setVariable("ITEM_NAME", "sall_" . $a_ref_id);
                    $tpl->setVariable("ITEM_VALUE", "");
                    $tpl->setVariable("ITEM_ADD", " onclick=\"il.Util.setChecked('" .
                        $a_form_name . "', '" . $var_name . "', document." . $a_form_name .
                        ".sall_" . $a_ref_id . ".checked)\"");
                    $tpl->parseCurrentBlock();

                    $tpl->setCurrentBlock("item");
                    $tpl->setVariable("ITEM_TITLE", $lng->txt("select_all"));
                    $tpl->parseCurrentBlock();
                }
            }

            if ($counter) {
                $tpl->setCurrentBlock("add_info");
                $tpl->setVariable(
                    "TXT_ADDITIONAL_INFO",
                    sprintf($lng->txt("rep_object_references_cannot_be_read"), $counter)
                );
                $tpl->parseCurrentBlock();
            }
            return $tpl->get();
        }
        return "";
    }

Here is the call graph for this function:

Here is the caller graph for this function:

initFormTrashTargetLocation()

ilRepositoryTrashGUI::initFormTrashTargetLocation ( )

protected

Definition at line 136 of file class.ilRepositoryTrashGUI.php.

References ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), ROOT_FOLDER_ID, ilFormPropertyGUI\setRequired(), and ilExplorerBaseGUI\setSelectMode().

Referenced by doRestoreToNewLocation(), executeCommand(), and restoreToNewLocation().

                                                    : ilPropertyFormGUI
    {
        $form = new ilPropertyFormGUI();
        $form->setFormAction($this->ctrl->getFormAction($this));

        $target = new ilRepositorySelector2InputGUI(
            $this->lng->txt('rep_target_location'),
            'target_id',
            false
        );
        $target->setRequired(true);

        $explorer = new ilRepositorySelectorExplorerGUI(
            [
                ilAdministrationGUI::class,
                get_class($this->parent_gui),
                self::class,
                ilPropertyFormGUI::class,
                ilFormPropertyDispatchGUI::class,
                ilRepositorySelector2InputGUI::class
            ],
            'handleExplorerCommand',
            $target,
            'root_id',
            'rep_exp_sel_' . $target->getPostVar()
        );
        $explorer->setSelectMode($target->getPostVar() . "_sel", false);
        $explorer->setRootId(ROOT_FOLDER_ID);
        $explorer->setTypeWhiteList(['root','cat','crs','grp','fold']);
        $target->setExplorerGUI($explorer);

        $form->addItem($target);
        $form->addCommandButton('doRestoreToNewLocation', $this->lng->txt('btn_undelete'));
        $form->addCommandButton('cancel', $this->lng->txt('cancel'));

        return $form;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

removeObjectsFromSystem()

ilRepositoryTrashGUI::removeObjectsFromSystem	(	array	$a_ref_ids,
		bool	$a_from_recovery_folder = false
	)

Definition at line 427 of file class.ilRepositoryTrashGUI.php.

References Vendor\Package\$e, $lng, ilRepUtil\removeObjectsFromSystem(), and ilLanguage\txt().

     : bool {
        $lng = $this->lng;

        if (!is_array($a_ref_ids) || count($a_ref_ids) === 0) {
            $this->tpl->setOnScreenMessage('failure', $lng->txt("no_checkbox"), true);
            return false;
        }

        try {
            ilRepUtil::removeObjectsFromSystem($a_ref_ids, $a_from_recovery_folder);
            $this->tpl->setOnScreenMessage('success', $lng->txt("msg_removed"), true);
        } catch (Exception $e) {
            // alex: I outcommented this, since it makes tracking down errors impossible
            // we need a call stack at least in the logs
            //$this->tpl->setOnScreenMessage('failure', $e->getMessage(), true);
            throw $e;
            return false;
        }

        return true;
    }

Here is the call graph for this function:

restoreObjects()

ilRepositoryTrashGUI::restoreObjects	(	int	$a_cur_ref_id,
		array	$a_ref_ids
	)

Restore objects from trash.

Parameters

int	$a_cur_ref_id
	int[]	$a_ref_ids array of ref ids to be restored

Returns

bool

Definition at line 365 of file class.ilRepositoryTrashGUI.php.

References Vendor\Package\$e, $lng, ILIAS\Repository\lng(), ilLanguage\loadLanguageModule(), ilRepUtil\restoreObjects(), and ilLanguage\txt().

     : bool {
        $lng = $this->lng;
        $lng->loadLanguageModule('rep');

        if (!is_array($a_ref_ids) || count($a_ref_ids) === 0) {
            $this->tpl->setOnScreenMessage('failure', $lng->txt("no_checkbox"), true);
            return false;
        }

        $tree_trash_queries = new ilTreeTrashQueries();
        if ($tree_trash_queries->isTrashedTrash($a_ref_ids)) {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt('rep_failure_trashed_trash'), true);
            return false;
        }
        try {
            // find parent foreach node
            $by_location = [];
            foreach ($a_ref_ids as $deleted_node_id) {
                $target_id = $tree_trash_queries->findRepositoryLocationForDeletedNode($deleted_node_id);
                if ($target_id) {
                    $by_location[$target_id][] = $deleted_node_id;
                }
            }
            foreach ($by_location as $target_id => $deleted_node_ids) {
                ilRepUtil::restoreObjects($target_id, $deleted_node_ids);
            }
            $this->tpl->setOnScreenMessage('success', $lng->txt("msg_undeleted"), true);
        } catch (Exception $e) {
            $this->tpl->setOnScreenMessage('failure', $e->getMessage(), true);
            return false;
        }
        return true;
    }

Here is the call graph for this function:

restoreToNewLocation()

ilRepositoryTrashGUI::restoreToNewLocation

(

ilPropertyFormGUI

$form = null

)

Definition at line 90 of file class.ilRepositoryTrashGUI.php.

References ILIAS\Repository\ctrl(), initFormTrashTargetLocation(), and ILIAS\Repository\lng().

     : void {
        $this->lng->loadLanguageModule('rep');

        $trash_ids = $this->request->getTrashIds();

        $this->ctrl->setParameter($this, 'trash_ids', implode(',', $trash_ids));

        if (!count($trash_ids)) {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt('select_one'), true);
            $this->ctrl->returnToParent($this);
        }

        if (!$form instanceof ilPropertyFormGUI) {
            $form = $this->initFormTrashTargetLocation();
        }
        $this->tpl->setOnScreenMessage('info', $this->lng->txt('rep_target_location_info'));
        $this->tpl->setContent($form->getHTML());
    }

Here is the call graph for this function:

showDeleteConfirmation()

ilRepositoryTrashGUI::showDeleteConfirmation	(	?array	$a_ids,
		bool	$a_supress_message = false
	)

Definition at line 174 of file class.ilRepositoryTrashGUI.php.

References $ctrl, $ilSetting, $lng, $obj_definition, $ref_id, $settings, $tpl, ilObject\_getIcon(), ilObject\_lookupObjId(), ilObject\_lookupType(), ilObject\collectDeletionDependencies(), ilObjectFactory\getClassByType(), handleMultiReferences(), ilObjectPlugin\lookupTxtById(), ilGlobalTemplateInterface\setContent(), ilUtil\stripSlashes(), and ilLanguage\txt().

     : bool {
        $lng = $this->lng;
        $ilSetting = $this->settings;
        $ilCtrl = $this->ctrl;
        $tpl = $this->tpl;
        $objDefinition = $this->obj_definition;

        if (!is_array($a_ids) || count($a_ids) === 0) {
            $this->tpl->setOnScreenMessage('failure', $lng->txt("no_checkbox"), true);
            return false;
        }

        // Remove duplicate entries
        $a_ids = array_unique($a_ids);

        $cgui = new ilConfirmationGUI();

        if (!$a_supress_message) {
            $msg = $lng->txt("info_delete_sure");

            if (!$ilSetting->get('enable_trash')) {
                $msg .= "<br/>" . $lng->txt("info_delete_warning_no_trash");
            }

            $cgui->setHeaderText($msg);
        }
        $cgui->setFormAction($ilCtrl->getFormAction($this->parent_gui));
        $cgui->setCancel($lng->txt("cancel"), "cancelDelete");
        $cgui->setConfirm($lng->txt("confirm"), "confirmedDelete");

        $form_name = "cgui_" . md5(uniqid('', true));
        $cgui->setFormName($form_name);

        $deps = [];
        foreach ($a_ids as $ref_id) {
            $obj_id = ilObject::_lookupObjId($ref_id);
            $type = ilObject::_lookupType($obj_id);
            $title = call_user_func([ilObjectFactory::getClassByType($type), '_lookupTitle'], $obj_id);
            $alt = ($objDefinition->isPlugin($type))
                ? $lng->txt("icon") . " " . ilObjectPlugin::lookupTxtById($type, "obj_" . $type)
                : $lng->txt("icon") . " " . $lng->txt("obj_" . $type);

            $cgui->addItem(
                "id[]",
                $ref_id,
                ilUtil::stripSlashes($title) .
                $this->handleMultiReferences($obj_id, $ref_id, $form_name),
                ilObject::_getIcon($obj_id, "small", $type),
                $alt
            );

            ilObject::collectDeletionDependencies($deps, $ref_id, $obj_id, $type);
        }
        $deps_html = "";

        if (is_array($deps) && count($deps) > 0) {
            $tab = new ilRepDependenciesTableGUI($deps);
            $deps_html = "<br/><br/>" . $tab->getHTML();
        }

        $tpl->setContent($cgui->getHTML() . $deps_html);
        return true;
    }

Here is the call graph for this function:

showTrashTable()

ilRepositoryTrashGUI::showTrashTable

(

int

$a_ref_id

)

Definition at line 340 of file class.ilRepositoryTrashGUI.php.

References $lng, $tpl, $tree, ilTree\getSavedNodeData(), ilGlobalTemplateInterface\setContent(), and ilLanguage\txt().

     : void {
        $tpl = $this->tpl;
        $tree = $this->tree;
        $lng = $this->lng;

        $objects = $tree->getSavedNodeData($a_ref_id);

        if (count($objects) === 0) {
            $this->tpl->setOnScreenMessage('info', $lng->txt("msg_trash_empty"));
            return;
        }
        $ttab = new ilTrashTableGUI($this->parent_gui, "trash", $a_ref_id);
        $ttab->setData($objects);

        $tpl->setContent($ttab->getHTML());
    }

Here is the call graph for this function:

Field Documentation

$access

ilAccessHandler ilRepositoryTrashGUI::$access

protected

Definition at line 34 of file class.ilRepositoryTrashGUI.php.

Referenced by handleMultiReferences().

$ctrl

ilCtrl ilRepositoryTrashGUI::$ctrl

protected

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

Referenced by confirmRemoveFromSystemObject(), and showDeleteConfirmation().

$lng

ilLanguage ilRepositoryTrashGUI::$lng

protected

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

Referenced by confirmRemoveFromSystemObject(), deleteObjects(), handleMultiReferences(), removeObjectsFromSystem(), restoreObjects(), showDeleteConfirmation(), and showTrashTable().

$logger

ilLogger ilRepositoryTrashGUI::$logger = null

protected

Definition at line 36 of file class.ilRepositoryTrashGUI.php.

$obj_definition

ilObjectDefinition ilRepositoryTrashGUI::$obj_definition

protected

Definition at line 33 of file class.ilRepositoryTrashGUI.php.

Referenced by confirmRemoveFromSystemObject(), and showDeleteConfirmation().

$parent_cmd

string ilRepositoryTrashGUI::$parent_cmd

protected

Definition at line 39 of file class.ilRepositoryTrashGUI.php.

$parent_gui

object ilRepositoryTrashGUI::$parent_gui

protected

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

$request

TrashGUIRequest ilRepositoryTrashGUI::$request

protected

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

$settings

ilSetting ilRepositoryTrashGUI::$settings

protected

Definition at line 30 of file class.ilRepositoryTrashGUI.php.

Referenced by deleteObjects(), and showDeleteConfirmation().

$tpl

ilGlobalTemplateInterface ilRepositoryTrashGUI::$tpl

protected

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

Referenced by confirmRemoveFromSystemObject(), showDeleteConfirmation(), and showTrashTable().

$tree

ilTree ilRepositoryTrashGUI::$tree

protected

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

Referenced by buildPath(), handleMultiReferences(), and showTrashTable().

---

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

• Services/Repository/Trash/class.ilRepositoryTrashGUI.php