Export User Interface Class. More...

Inheritance diagram for ilExportGUI:

Collaboration diagram for ilExportGUI:

Public Member Functions
	__construct ($a_parent_gui, $a_main_obj=null)
	Constuctor. More...

	addFormat ($a_key, $a_txt="", $a_call_obj=null, $a_call_func="")
	Add formats. More...

	getFormats ()
	Get formats. More...

	addCustomColumn ($a_txt, $a_obj, $a_func)
	Add custom column. More...

	addCustomMultiCommand ($a_txt, $a_obj, $a_func)
	Add custom multi command. More...

	getCustomMultiCommands ()
	Get custom multi commands. More...

	getCustomColumns ()
	Get custom columns. More...

	listExportFiles ()
	List export files. More...

	createExportFile ()
	Create export file. More...

	confirmDeletion ()
	Confirm file deletion. More...

	delete ()
	Delete files. More...

	download ()
	Download file. More...

	handleCustomMultiCommand ()
	Handle custom multi command. More...

Protected Member Functions
	buildExportTableGUI ()

	getParentGUI ()
	get parent gui More...

	showItemSelection ()
	Show container item selection table. More...

	saveItemSelection ()
	Save selection of subitems. More...

Protected Attributes
	$formats = array()

	$custom_columns = array()

	$custom_multi_commands = array()

Private Attributes
	$parent_gui = null

Detailed Description

Export User Interface Class.

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

Version: $Id$

@ilCtrl_Calls ilExportGUI:

Definition at line 14 of file class.ilExportGUI.php.

Constructor & Destructor Documentation

◆ __construct()

ilExportGUI::__construct	(	$a_parent_gui,
		$a_main_obj = `null`
	)

Constuctor.

Parameters

return

Definition at line 28 of file class.ilExportGUI.php.

    {
        global $DIC;
 
        $lng = $DIC['lng'];
        $tpl = $DIC['tpl'];
        
        $this->parent_gui = $a_parent_gui;
        if ($a_main_obj == null) {
            $this->obj = $a_parent_gui->object;
        } else {
            $this->obj = $a_main_obj;
        }
        $lng->loadLanguageModule("exp");
        $this->tpl = $tpl;
    }

References $DIC, $lng, and $tpl.

Member Function Documentation

◆ addCustomColumn()

ilExportGUI::addCustomColumn	(	$a_txt,
		$a_obj,
		$a_func
	)

Add custom column.

Parameters

return

Definition at line 98 of file class.ilExportGUI.php.

    {
        $this->custom_columns[] = array("txt" => $a_txt,
                                        "obj" => $a_obj,
                                        "func" => $a_func);
    }

◆ addCustomMultiCommand()

ilExportGUI::addCustomMultiCommand	(	$a_txt,
		$a_obj,
		$a_func
	)

Add custom multi command.

Parameters

return

Definition at line 111 of file class.ilExportGUI.php.

    {
        $this->custom_multi_commands[] = array("txt" => $a_txt,
                                        "obj" => $a_obj,
                                        "func" => $a_func);
    }

◆ addFormat()

ilExportGUI::addFormat	(	$a_key,
		$a_txt = `""`,
		$a_call_obj = `null`,
		$a_call_func = `""`
	)

Add formats.

Parameters

array formats

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

    {
        global $DIC;
 
        $lng = $DIC['lng'];
        
        if ($a_txt == "") {
            $a_txt = $lng->txt("exp_" . $a_key);
        }
        $this->formats[] = array("key" => $a_key, "txt" => $a_txt,
            "call_obj" => $a_call_obj, "call_func" => $a_call_func);
    }

References $DIC, and $lng.

◆ buildExportTableGUI()

ilExportGUI::buildExportTableGUI ( )

protected

Returns: ilExportTableGUI

Reimplemented in ilDclExportGUI, ilTestExportGUI, and ilQuestionPoolExportGUI.

Definition at line 48 of file class.ilExportGUI.php.

    {
        include_once("./Services/Export/classes/class.ilExportTableGUI.php");
        $table = new ilExportTableGUI($this, "listExportFiles", $this->obj);
        return $table;
    }

Referenced by listExportFiles().

Here is the caller graph for this function:

◆ confirmDeletion()

ilExportGUI::confirmDeletion ( )

Confirm file deletion.

Definition at line 280 of file class.ilExportGUI.php.

    {
        global $DIC;
 
        $ilCtrl = $DIC['ilCtrl'];
        $tpl = $DIC['tpl'];
        $lng = $DIC['lng'];
            
        if (!is_array($_POST["file"]) || count($_POST["file"]) == 0) {
            ilUtil::sendInfo($lng->txt("no_checkbox"), true);
            $ilCtrl->redirect($this, "listExportFiles");
        } else {
            include_once("./Services/Utilities/classes/class.ilConfirmationGUI.php");
            $cgui = new ilConfirmationGUI();
            $cgui->setFormAction($ilCtrl->getFormAction($this));
            $cgui->setHeaderText($lng->txt("exp_really_delete"));
            $cgui->setCancel($lng->txt("cancel"), "listExportFiles");
            $cgui->setConfirm($lng->txt("delete"), "delete");
            
            foreach ($_POST["file"] as $i) {
                if (strpos($i, ':') !== false) {
                    $iarr = explode(":", $i);
                    $filename = $iarr[1];
                } else {
                    $filename = $i;
                }
                $cgui->addItem("file[]", $i, $filename);
            }
            
            $tpl->setContent($cgui->getHTML());
        }
    }

References $_POST, $DIC, $filename, $i, $lng, $tpl, and ilUtil\sendInfo().

Here is the call graph for this function:

◆ createExportFile()

ilExportGUI::createExportFile ( )

Create export file.

Parameters

return

Reimplemented in ilDclExportGUI.

Definition at line 247 of file class.ilExportGUI.php.

    {
        global $DIC;
 
        $ilCtrl = $DIC['ilCtrl'];
        $lng = $DIC['lng'];
        
        if ($ilCtrl->getCmd() == "createExportFile") {
            $format = ilUtil::stripSlashes($_POST["format"]);
        } else {
            $format = substr($ilCtrl->getCmd(), 7);
        }
        foreach ($this->getFormats() as $f) {
            if ($f["key"] == $format) {
                if (is_object($f["call_obj"])) {
                    $f["call_obj"]->{$f["call_func"]}();
                } elseif ($this->getParentGUI() instanceof ilContainerGUI) {
                    return $this->showItemSelection();
                } elseif ($format == "xml") {           // standard procedure
                    include_once("./Services/Export/classes/class.ilExport.php");
                    $exp = new ilExport();
                    $exp->exportObject($this->obj->getType(), $this->obj->getId());
                }
            }
        }
        
        ilUtil::sendSuccess($lng->txt("exp_file_created"), true);
        $ilCtrl->redirect($this, "listExportFiles");
    }

References $_POST, $DIC, Vendor\Package\$f, $format, $lng, getFormats(), getParentGUI(), showItemSelection(), and ilUtil\stripSlashes().

Here is the call graph for this function:

◆ delete()

ilExportGUI::delete ( )

Delete files.

Definition at line 316 of file class.ilExportGUI.php.

    {
        global $DIC;
 
        $ilCtrl = $DIC['ilCtrl'];
        
        foreach ($_POST["file"] as $file) {
            $file = explode(":", $file);
            
            $file[1] = basename($file[1]);
            
            include_once("./Services/Export/classes/class.ilExport.php");
            $export_dir = ilExport::_getExportDirectory(
                $this->obj->getId(),
                str_replace("..", "", $file[0]),
                $this->obj->getType()
            );
 
            $exp_file = $export_dir . "/" . str_replace("..", "", $file[1]);
            $exp_dir = $export_dir . "/" . substr($file[1], 0, strlen($file[1]) - 4);
            if (@is_file($exp_file)) {
                unlink($exp_file);
            }
            if (@is_dir($exp_dir)) {
                ilUtil::delDir($exp_dir);
            }
            
            // delete entry in database
            include_once './Services/Export/classes/class.ilExportFileInfo.php';
            $info = new ilExportFileInfo($this->obj->getId(), $file[0], $file[1]);
            $info->delete();
        }
        $ilCtrl->redirect($this, "listExportFiles");
    }

References $_POST, $DIC, ilExport\_getExportDirectory(), and ilUtil\delDir().

Here is the call graph for this function:

◆ download()

ilExportGUI::download ( )

Download file.

Reimplemented in ilQuestionPoolExportGUI.

Definition at line 354 of file class.ilExportGUI.php.

    {
        global $DIC;
 
        $ilCtrl = $DIC['ilCtrl'];
        $lng = $DIC['lng'];
                        
        if (!isset($_GET["file"]) ||
            is_array($_GET["file"])) {
            $ilCtrl->redirect($this, "listExportFiles");
        }
 
        $file = explode(":", trim($_GET["file"]));
        include_once("./Services/Export/classes/class.ilExport.php");
        $export_dir = ilExport::_getExportDirectory(
            $this->obj->getId(),
            str_replace("..", "", $file[0]),
            $this->obj->getType()
        );
        
        $file[1] = basename($file[1]);
        
        ilUtil::deliverFile(
            $export_dir . "/" . $file[1],
            $file[1]
        );
    }

References $_GET, $DIC, $lng, ilExport\_getExportDirectory(), and ilUtil\deliverFile().

Here is the call graph for this function:

◆ getCustomColumns()

ilExportGUI::getCustomColumns ( )

Get custom columns.

Parameters

return

Definition at line 132 of file class.ilExportGUI.php.

    {
        return $this->custom_columns;
    }

References $custom_columns.

Referenced by ilTestExportGUI\listExportFiles(), and listExportFiles().

Here is the caller graph for this function:

◆ getCustomMultiCommands()

ilExportGUI::getCustomMultiCommands ( )

Get custom multi commands.

Definition at line 121 of file class.ilExportGUI.php.

    {
        return $this->custom_multi_commands;
    }

References $custom_multi_commands.

Referenced by ilTestExportGUI\listExportFiles(), and listExportFiles().

Here is the caller graph for this function:

◆ getFormats()

ilExportGUI::getFormats ( )

Get formats.

Returns: array formats

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

    {
        return $this->formats;
    }

References $formats.

Referenced by createExportFile(), ilTestExportGUI\listExportFiles(), and listExportFiles().

Here is the caller graph for this function:

◆ getParentGUI()

ilExportGUI::getParentGUI ( )

protected

get parent gui

Returns

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

    {
        return $this->parent_gui;
    }

References $parent_gui.

Referenced by createExportFile(), and ilTestExportGUI\listExportFiles().

Here is the caller graph for this function:

◆ handleCustomMultiCommand()

ilExportGUI::handleCustomMultiCommand ( )

Handle custom multi command.

Parameters

return

Definition at line 388 of file class.ilExportGUI.php.

    {
        global $DIC;
 
        $ilCtrl = $DIC['ilCtrl'];
 
        $cmd = substr($ilCtrl->getCmd(), 6);
        foreach ($this->getCustomMultiCommands() as $c) {
            if ($c["func"] == $cmd) {
                $c["obj"]->{$c["func"]}($_POST["file"]);
            }
        }
    }

References $_POST, $c, and $DIC.

◆ listExportFiles()

ilExportGUI::listExportFiles ( )

List export files.

Parameters

return

Reimplemented in ilOrgUnitExportGUI, and ilTestExportGUI.

Definition at line 194 of file class.ilExportGUI.php.

    {
        global $DIC;
 
        $tpl = $DIC['tpl'];
        $ilToolbar = $DIC['ilToolbar'];
        $ilCtrl = $DIC['ilCtrl'];
        $lng = $DIC['lng'];
 
        include_once "Services/UIComponent/Button/classes/class.ilSubmitButton.php";
        $button = ilSubmitButton::getInstance();
        
        // creation buttons
        $ilToolbar->setFormAction($ilCtrl->getFormAction($this));
        if (count($this->getFormats()) > 1) {
            // type selection
            foreach ($this->getFormats() as $f) {
                $options[$f["key"]] = $f["txt"];
            }
            include_once("./Services/Form/classes/class.ilSelectInputGUI.php");
            $si = new ilSelectInputGUI($lng->txt("type"), "format");
            $si->setOptions($options);
            $ilToolbar->addInputItem($si, true);
            
            $button->setCaption("exp_create_file");
            $button->setCommand("createExportFile");
        } else {
            $format = $this->getFormats();
            $format = $format[0];
            
            $button->setCaption($lng->txt("exp_create_file") . " (" . $format["txt"] . ")", false);
            $button->setCommand("create_" . $format["key"]);
        }
        
        $ilToolbar->addButtonInstance($button);
 
        $table = $this->buildExportTableGUI();
        $table->setSelectAllCheckbox("file");
        foreach ($this->getCustomColumns() as $c) {
            $table->addCustomColumn($c["txt"], $c["obj"], $c["func"]);
        }
        foreach ($this->getCustomMultiCommands() as $c) {
            $table->addCustomMultiCommand($c["txt"], "multi_" . $c["func"]);
        }
        $tpl->setContent($table->getHTML());
    }

References $c, $DIC, Vendor\Package\$f, $format, $lng, $si, $tpl, buildExportTableGUI(), getCustomColumns(), getCustomMultiCommands(), getFormats(), and ilSubmitButton\getInstance().

Here is the call graph for this function:

◆ saveItemSelection()

ilExportGUI::saveItemSelection ( )

protected

Save selection of subitems.

Returns

Definition at line 425 of file class.ilExportGUI.php.

    {
        global $DIC;
 
        $tree = $DIC['tree'];
        $objDefinition = $DIC['objDefinition'];
        $ilAccess = $DIC['ilAccess'];
        $ilCtrl = $DIC['ilCtrl'];
        $lng = $DIC['lng'];
 
        include_once './Services/Export/classes/class.ilExportOptions.php';
        $eo = ilExportOptions::newInstance(ilExportOptions::allocateExportId());
        $eo->addOption(ilExportOptions::KEY_ROOT, 0, 0, $this->obj->getId());
 
        // check export limitation
        $exp_limit = new ilExportLimitation();
        try {
            $exp_limit->checkLimitation(
                $this->getParentGUI()->object->getRefId(),
                $_POST['cp_options']
            );
        } catch (Exception $e) {
            ilUtil::sendFailure($e->getMessage());
            $this->showItemSelection();
            return;
        }
        
        $items_selected = false;
        foreach ($tree->getSubTree($root = $tree->getNodeData($this->getParentGUI()->object->getRefId())) as $node) {
            if ($node['type'] == 'rolf') {
                continue;
            }
            if ($node['ref_id'] == $this->getParentGUI()->object->getRefId()) {
                $eo->addOption(
                    ilExportOptions::KEY_ITEM_MODE,
                    $node['ref_id'],
                    $node['obj_id'],
                    ilExportOptions::EXPORT_BUILD
                );
                continue;
            }
            // no export available or no access
            if (!$objDefinition->allowExport($node['type']) or !$ilAccess->checkAccess('write', '', $node['ref_id'])) {
                $eo->addOption(
                    ilExportOptions::KEY_ITEM_MODE,
                    $node['ref_id'],
                    $node['obj_id'],
                    ilExportOptions::EXPORT_OMIT
                );
                continue;
            }
            
            $mode = isset($_POST['cp_options'][$node['ref_id']]['type']) ?
                $_POST['cp_options'][$node['ref_id']]['type'] :
                ilExportOptions::EXPORT_OMIT;
            $eo->addOption(
                ilExportOptions::KEY_ITEM_MODE,
                $node['ref_id'],
                $node['obj_id'],
                $mode
            );
            if ($mode != ilExportOptions::EXPORT_OMIT) {
                $items_selected = true;
            }
        }
        
        include_once("./Services/Export/classes/class.ilExport.php");
        if ($items_selected) {
            // TODO: move this to background soap
            $eo->read();
            $exp = new ilExport();
            foreach ($eo->getSubitemsForCreation($this->obj->getRefId()) as $ref_id) {
                $obj_id = ilObject::_lookupObjId($ref_id);
                $type = ilObject::_lookupType($obj_id);
                $exp->exportObject($type, $obj_id);
            }
            // Fixme: there is a naming conflict between the container settings xml and the container subitem xml.
            sleep(1);
            // Export container
            include_once './Services/Export/classes/class.ilExportContainer.php';
            $cexp = new ilExportContainer($eo);
            $cexp->exportObject($this->obj->getType(), $this->obj->getId());
        } else {
            $exp = new ilExport();
            $exp->exportObject($this->obj->getType(), $this->obj->getId());
        }
 
        // Delete export options
        $eo->delete();
 
        ilUtil::sendSuccess($lng->txt('export_created'), true);
        $ilCtrl->redirect($this, "listExportFiles");
    }

References $_POST, $DIC, Vendor\Package\$e, $lng, $type, ilObject\_lookupObjId(), ilObject\_lookupType(), ilExportOptions\allocateExportId(), ilExportOptions\EXPORT_BUILD, ilExportOptions\EXPORT_OMIT, ilExportOptions\KEY_ITEM_MODE, ilExportOptions\KEY_ROOT, ilExportOptions\newInstance(), and ilUtil\sendFailure().

Here is the call graph for this function:

◆ showItemSelection()

ilExportGUI::showItemSelection ( )

protected

Show container item selection table.

Returns

Definition at line 406 of file class.ilExportGUI.php.

    {
        global $DIC;
 
        $tpl = $DIC['tpl'];
        
        $tpl->addJavaScript('./Services/CopyWizard/js/ilContainer.js');
        $tpl->setVariable('BODY_ATTRIBUTES', 'onload="ilDisableChilds(\'cmd\');"');
 
        include_once './Services/Export/classes/class.ilExportSelectionTableGUI.php';
        $table = new ilExportSelectionTableGUI($this, 'listExportFiles');
        $table->parseContainer($this->getParentGUI()->object->getRefId());
        $this->tpl->setContent($table->getHTML());
    }

References $DIC, and $tpl.

Referenced by createExportFile().

Here is the caller graph for this function:

Field Documentation

◆ $custom_columns

ilExportGUI::$custom_columns = array()

protected

Definition at line 17 of file class.ilExportGUI.php.

Referenced by getCustomColumns().

◆ $custom_multi_commands

ilExportGUI::$custom_multi_commands = array()

protected

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

Referenced by getCustomMultiCommands().

◆ $formats

ilExportGUI::$formats = array()

protected

Definition at line 16 of file class.ilExportGUI.php.

Referenced by getFormats().

◆ $parent_gui

ilExportGUI::$parent_gui = null

private

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

Referenced by getParentGUI().

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

Services/Export/classes/class.ilExportGUI.php

Public Member Functions

Protected Member Functions

Protected Attributes

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ addCustomColumn()

◆ addCustomMultiCommand()

◆ addFormat()

◆ buildExportTableGUI()

◆ confirmDeletion()

◆ createExportFile()

◆ delete()

◆ download()

◆ getCustomColumns()

◆ getCustomMultiCommands()

◆ getFormats()

◆ getParentGUI()

◆ handleCustomMultiCommand()

◆ listExportFiles()

◆ saveItemSelection()

◆ showItemSelection()

Field Documentation

◆ $custom_columns

◆ $custom_multi_commands

◆ $formats

◆ $parent_gui