ilObjFileGUI Class Reference

GUI class for file objects. More...

Inheritance diagram for ilObjFileGUI:

Collaboration diagram for ilObjFileGUI:

Public Member Functions
	getType ()
	_forwards ()
	executeCommand ()
	initSingleUploadForm ()
	FORM: Init single upload form. More...
	save ()
	save object More...
	saveAndMeta ()
	save object More...
	initZipUploadForm ($a_mode="create")
	FORM: Init zip upload form. More...
	saveUnzip ()
	saveUnzip object More...
	update ()
	updates object entry in object_data More...
	edit ()
	edit object More...
	sendFile ()
	versions ()
	file versions/history More...
	infoScreen ()
	this one is called from the info button in the repository not very nice to set cmdClass/Cmd manually, if everything works through ilCtrl in the future this may be changed More...
	infoScreenForward ()
	show information screen More...
	setTabs ()
	addLocatorItems ()
	initMultiUploadForm ()
	Initializes the upload form for multiple files. More...
	uploadFiles ()
	Called after a file was uploaded. More...
	deleteVersions ()
	Displays a confirmation screen with selected file versions that should be deleted. More...
	confirmDeleteVersions ()
	Deletes the file versions that were confirmed by the user. More...
	cancelDeleteVersions ()
	Cancels the file version deletion. More...
	confirmDeleteFile ()
	Deletes this file object. More...
	cancelDeleteFile ()
	Cancels the file deletion. More...
	compareHistoryIds ($v1, $v2)
	Compares two versions either by passing a history entry or an id. More...
	rollbackVersion ()
	Performs a rollback with the selected file version. More...
Public Member Functions inherited from ilObject2GUI
	__construct ($a_id=0, $a_id_type=self::REPOSITORY_NODE_ID, $a_parent_node_id=0)
	Constructor. More...
&	executeCommand ()
	execute command More...
	delete ()
	Display delete confirmation form (repository/workspace switch) More...
	confirmedDelete ()
	Delete objects (repository/workspace switch) More...
	getHTML ()
	withReferences ()
	Final/Private declaration of unchanged parent methods. More...
	setCreationMode ($a_mode=true)
	getCreationMode ()
	isVisible ()
	trash ()
	undelete ()
	cancelDelete ()
	removeFromSystem ()
	cloneAll ()
	view ()
	view object content (repository/workspace switch) More...
	getType ()
	Functions that must be overwritten. More...
	create ()
	Deleted in ilObject. More...
	save ()
	edit ()
	update ()
	cancel ()
	importFile ()
	Import. More...
Public Member Functions inherited from ilObjectGUI
	ilObjectGUI ($a_data, $a_id=0, $a_call_by_reference=true, $a_prepare_output=true)
	Constructor public. More...
&	executeCommand ()
	execute command More...
	withReferences ()
	determines wether objects are referenced or not (got ref ids or not) More...
	setCreationMode ($a_mode=true)
	if true, a creation screen is displayed the current $_GET[ref_id] don't belong to the current class! the mode is determined in ilrepositorygui More...
	getCreationMode ()
	get creation mode More...
	getAdminTabs (&$tabs_gui)
	administration tabs show only permissions and trash folder More...
	getHTML ()
	confirmedDeleteObject ()
	confirmed deletion of object -> objects are moved to trash or deleted immediately, if trash is disabled More...
	cancelDeleteObject ()
	cancel deletion of object More...
	cancelObject ($in_rep=false)
	cancel action and go back to previous page public More...
	createObject ()
	create new object form More...
	cancelCreation ()
	cancel create action and go back to repository parent More...
	saveObject ()
	save object More...
	editObject ()
	edit object More...
	updateObject ()
	updates object entry in object_data More...
	getFormAction ($a_cmd, $a_formaction="")
	get form action for command (command is method name without "Object", e.g. More...
	isVisible ($a_ref_id, $a_type)
	viewObject ()
	list childs of current object More...
	deleteObject ($a_error=false)
	Display deletion confirmation screen. More...
	cloneAllObject ()
	Clone single (not container object) Method is overwritten in ilContainerGUI. More...

Static Public Member Functions
static	_goto ($a_target, $a_additional=null)
Static Public Member Functions inherited from ilObject2GUI
static	handleAfterSaveCallback (ilObject $a_obj, $a_callback_ref_id)
	After creation callback. More...
Static Public Member Functions inherited from ilObjectGUI
static	_gotoRepositoryRoot ($a_raise_error=false)
	Goto repository root. More...
static	_gotoRepositoryNode ($a_ref_id, $a_cmd="frameset")
	Goto repository root. More...

Protected Member Functions
	initCreationForms ()
	initPropertiesForm ()
	handleFileUpload ($file_upload)
	Handles the upload of a single file and adds it to the parent object. More...
	initHeaderAction ($a_sub_type=null, $a_sub_id=null)
Protected Member Functions inherited from ilObject2GUI
	afterConstructor ()
	Do anything that should be done after constructor in here. More...
	assignObject ()
	create object instance as internal property (repository/workspace switch) More...
	getAccessHandler ()
	Get access handler. More...
	setLocator ()
	set Locator More...
	deleteConfirmation ()
	Display delete confirmation form (workspace specific) More...
	deleteConfirmedObjects ()
	Delete objects (workspace specific) More...
	prepareOutput ()
	setTitleAndDescription ()
	showUpperIcon ()
	omitLocator ($a_omit=true)
	getTargetFrame ($a_cmd, $a_target_frame="")
	setTargetFrame ($a_cmd, $a_target_frame)
	getCenterColumnHTML ()
	getRightColumnHTML ()
	setColumnSettings ($column_gui)
	checkPermission ($a_perm, $a_cmd="")
	showPossibleSubObjects ()
	redirectToRefId ()
	fillCloneTemplate ($a_tpl_varname, $a_type)
	fillCloneSearchTemplate ($a_tpl_varname, $a_type)
	searchCloneSource ()
	buildCloneSelect ($existing_objs)
	addAdminLocatorItems ()
	setTabs ()
	create tabs (repository/workspace switch) More...
	getReturnLocation ()
	Deprecated functions. More...
	setReturnLocation ()
	showActions ()
	getTitlesByRefId ()
	getTabs ()
	__showButton ()
	hitsperpageObject ()
	__initTableGUI ()
	__setTableGUIBasicData ()
	addLocatorItems ()
	Functions to be overwritten. More...
	initCreationForms ($a_new_type)
	Init creation froms. More...
	putObjectInTree (ilObject $a_obj, $a_parent_node_id=null)
	Add object to tree at given position. More...
	checkPermissionBool ($a_perm, $a_cmd="", $a_type="", $a_node_id=null)
	Check permission. More...
	initHeaderAction ($a_sub_type=null, $a_sub_id=null)
	Add header action menu. More...
	redrawHeaderAction ()
	Updating icons after ajax call. More...
	getPermanentLinkWidget ($a_append=null, $a_center=false)
	handleAutoRating (ilObject $a_new_obj)
Protected Member Functions inherited from ilObjectGUI
	assignObject ()
	prepareOutput ()
	prepare output More...
	setTitleAndDescription ()
	called by prepare output More...
	initHeaderAction ($a_sub_type=null, $a_sub_id=null)
	Add header action menu. More...
	insertHeaderAction ($a_list_gui)
	Insert header action into main template. More...
	addHeaderAction ()
	Add header action menu. More...
	redrawHeaderActionObject ()
	Ajax call: redraw action header only. More...
	showMountWebfolderIcon ()
	setTabs ()
	set admin tabs public More...
	setAdminTabs ()
	set admin tabs public More...
	setLocator ()
	set Locator More...
	addLocatorItems ()
	should be overwritten to add object specific items (repository items are preloaded) More...
	omitLocator ($a_omit=true)
	addAdminLocatorItems ($a_do_not_add_object=false)
	should be overwritten to add object specific items (repository items are preloaded) More...
	initCreationForms ($a_new_type)
	Init creation froms. More...
	getCreationFormsHTML (array $a_forms)
	Get HTML for creation forms (accordion) More...
	initCreateForm ($a_new_type)
	Init object creation form. More...
	initDidacticTemplate (ilPropertyFormGUI $form)
	Show didactic template types. More...
	addDidacticTemplateOptions (array &$a_options)
	Add custom templates. More...
	getDidacticTemplateVar ($a_type)
	Get didactic template setting from creation screen. More...
	putObjectInTree (ilObject $a_obj, $a_parent_node_id=null)
	Add object to tree at given position. More...
	afterSave (ilObject $a_new_object)
	Post (successful) object creation hook. More...
	initEditForm ()
	Init object edit form. More...
	initEditCustomForm (ilPropertyFormGUI $a_form)
	Add custom fields to update form. More...
	getEditFormValues ()
	Get values for edit form. More...
	getEditFormCustomValues (array &$a_values)
	Add values to custom edit fields. More...
	validateCustom (ilPropertyFormGUI $a_form)
	Validate custom values (if not possible with checkInput()) More...
	updateCustom (ilPropertyFormGUI $a_form)
	Insert custom update form values into object. More...
	afterUpdate ()
	Post (successful) object update hook. More...
	initImportForm ($a_new_type)
	Init object import form. More...
	importFileObject ($parent_id=null)
	Import. More...
	afterImport (ilObject $a_new_object)
	Post (successful) object import hook. More...
	setFormAction ($a_cmd, $a_formaction)
	set specific form action for command More...
	getReturnLocation ($a_cmd, $a_location="")
	get return location for command (command is method name without "Object", e.g. More...
	setReturnLocation ($a_cmd, $a_location)
	set specific return location for command More...
	getTargetFrame ($a_cmd, $a_target_frame="")
	get target frame for command (command is method name without "Object", e.g. More...
	setTargetFrame ($a_cmd, $a_target_frame)
	set specific target frame for command More...
	showPossibleSubObjects ()
	show possible subobjects (pulldown menu) More...
	getTemplateFile ($a_cmd, $a_type="")
	get a template blockfile format: tpl. More...
	getTitlesByRefId ($a_ref_ids)
	get Titles of objects this method is used for error messages in methods cut/copy/paste More...
	getTabs (&$tabs_gui)
	get tabs abstract method. More...
	__showButton ($a_cmd, $a_text, $a_target='')
	hitsperpageObject ()
&	__initTableGUI ()
	__setTableGUIBasicData (&$tbl, &$result_set, $a_from="")
	standard implementation for tables use 'from' variable use different initial setting of table More...
	redirectToRefId ($a_ref_id, $a_cmd="")
	redirects to (repository) view per ref id usually to a container and usually used at the end of a save/import method where the object gui type (of the new object) doesn't match with the type of the current $_GET["ref_id"] value More...
	fillCloneTemplate ($a_tpl_varname, $a_type)
	Fill object clone template This method can be called from any object GUI class that wants to offer object cloning. More...
	getCenterColumnHTML ()
	Get center column. More...
	getRightColumnHTML ()
	Display right column. More...
	setColumnSettings ($column_gui)
	May be overwritten in subclasses. More...
	checkPermission ($a_perm, $a_cmd="", $a_type="", $a_ref_id=null)
	Check permission and redirect on error. More...
	checkPermissionBool ($a_perm, $a_cmd="", $a_type="", $a_ref_id=null)
	Check permission. More...
	enableDragDropFileUpload ()
	Enables the file upload into this object by dropping files. More...
	handleAutoRating (ilObject $a_new_obj)
	Activate rating automatically if parent container setting. More...

Additional Inherited Members
Data Fields inherited from ilObject2GUI
	$tree
const	OBJECT_ID = 0
const	REPOSITORY_NODE_ID = 1
const	WORKSPACE_NODE_ID = 2
const	REPOSITORY_OBJECT_ID = 3
const	WORKSPACE_OBJECT_ID = 4
const	PORTFOLIO_OBJECT_ID = 5
Data Fields inherited from ilObjectGUI
const	COPY_WIZARD_NEEDS_PAGE = 1
	$ilias
	$objDefinition
	$tpl
	$tree
	$lng
	$data
	$object
	$ref_id
	$obj_id
	$maxcount
	$formaction
	$return_location
	$target_frame
	$tab_target_script
	$actions
	$sub_objects
	$omit_locator = false
const	CFORM_NEW = 1
const	CFORM_IMPORT = 2
const	CFORM_CLONE = 3
Protected Attributes inherited from ilObject2GUI
	$object_id
	$node_id
	$creation_forms = array()
	$id_type = array()
	$parent_id
	$access_handler

Detailed Description

GUI class for file objects.

Author

Sascha Hofmann shofm.nosp@m.ann@.nosp@m.datab.nosp@m.ay.d.nosp@m.e

Stefan Born stefa.nosp@m.n.bo.nosp@m.rn@ph.nosp@m.zh.c.nosp@m.h

Version

$Id$

ilObjFileGUI: ilMDEditorGUI, ilInfoScreenGUI, ilPermissionGUI, ilShopPurchaseGUI, ilObjectCopyGUI ilObjFileGUI: ilExportGUI, ilWorkspaceAccessGUI, ilPortfolioPageGUI, ilCommonActionDispatcherGUI

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

Member Function Documentation

_forwards()

ilObjFileGUI::_forwards

(

)

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

        {
                return array();
        }

_goto()

static ilObjFileGUI::_goto (   $a_target,   $a_additional = null  )

static

Definition at line 927 of file class.ilObjFileGUI.php.

References $_GET, $ilErr, ilObjectGUI\$lng, ilObjectGUI\_gotoRepositoryNode(), ilObjectGUI\_gotoRepositoryRoot(), ilObject\_lookupObjId(), ilObject\_lookupTitle(), exit, and ilUtil\sendFailure().

        {
                global $ilErr, $lng, $ilAccess;
                
                if($a_additional && substr($a_additional, -3) == "wsp")
                {
                        $_GET["baseClass"] = "ilsharedresourceGUI";     
                        $_GET["wsp_id"] = $a_target;            
                        include("ilias.php");
                        exit;
                }
                
                // added support for direct download goto links
                if($a_additional && substr($a_additional, -8) == "download")
                {
                        ilObjectGUI::_gotoRepositoryNode($a_target, "sendfile");
                }

                // static method, no workspace support yet

                if ($ilAccess->checkAccess("visible", "", $a_target))
                {
                        ilObjectGUI::_gotoRepositoryNode($a_target, "infoScreen");
                }
                else if ($ilAccess->checkAccess("read", "", ROOT_FOLDER_ID))
                {
                        ilUtil::sendFailure(sprintf($lng->txt("msg_no_perm_read_item"),
                                ilObject::_lookupTitle(ilObject::_lookupObjId($a_target))), true);
                        ilObjectGUI::_gotoRepositoryRoot();
                }

                $ilErr->raiseError($lng->txt("msg_no_perm_read"), $ilErr->FATAL);
        }

Here is the call graph for this function:

addLocatorItems()

ilObjFileGUI::addLocatorItems

(

)

Definition at line 964 of file class.ilObjFileGUI.php.

References ilObject2GUI\$node_id.

        {
                global $ilLocator;
                
                if (is_object($this->object))
                {
                        $ilLocator->addItem($this->object->getTitle(), $this->ctrl->getLinkTarget($this, ""), "", $this->node_id);
                }
        }

cancelDeleteFile()

ilObjFileGUI::cancelDeleteFile

(

)

Cancels the file deletion.

Definition at line 1369 of file class.ilObjFileGUI.php.

        {
                $this->ctrl->redirect($this, "versions");
        }

cancelDeleteVersions()

ilObjFileGUI::cancelDeleteVersions

(

)

Cancels the file version deletion.

Definition at line 1340 of file class.ilObjFileGUI.php.

        {
                $this->ctrl->redirect($this, "versions");
        }

compareHistoryIds()

ilObjFileGUI::compareHistoryIds	(		$v1,
			$v2
	)

Compares two versions either by passing a history entry or an id.

Parameters

$v1	The first version to compare.
$v2	The second version to compare.

Returns

Definition at line 1381 of file class.ilObjFileGUI.php.

        {
                if (is_array($v1))
                        $v1 = (int)$v1["hist_entry_id"];
                else if (!is_int($v1))
                        $v1 = (int)$v1;
                        
                if (is_array($v2))
                        $v2 = (int)$v2["hist_entry_id"];
                else if (!is_int($v2))
                        $v2 = (int)$v2;
                
                return $v1 - $v2;
        }

confirmDeleteFile()

ilObjFileGUI::confirmDeleteFile

(

)

Deletes this file object.

Definition at line 1348 of file class.ilObjFileGUI.php.

References ilObject2GUI\checkPermissionBool().

        {
                // has the user the rights to delete the file?
                if (!$this->checkPermissionBool("write"))
                {
                        $this->ilErr->raiseError($this->lng->txt("permission_denied"), $this->ilErr->MESSAGE);
                }
                
                // delete this file object
                include_once("./Services/Repository/classes/class.ilRepUtilGUI.php");
                $ru = new ilRepUtilGUI($this);
                $ru->deleteObjects($this->parent_id, array($this->ref_id));
                
                // redirect to parent object
                $this->ctrl->setParameterByClass("ilrepositorygui", "ref_id", $this->parent_id);
                $this->ctrl->redirectByClass("ilrepositorygui");
        }

Here is the call graph for this function:

confirmDeleteVersions()

ilObjFileGUI::confirmDeleteVersions

(

)

Deletes the file versions that were confirmed by the user.

Definition at line 1316 of file class.ilObjFileGUI.php.

References $_POST, ilObject2GUI\checkPermissionBool(), and ilUtil\sendSuccess().

        {
                global $ilTabs;
                
                // has the user the rights to delete versions?
                if (!$this->checkPermissionBool("write"))
                {
                        $this->ilErr->raiseError($this->lng->txt("permission_denied"), $this->ilErr->MESSAGE);
                }
                
                // delete versions after confirmation
                if (count($_POST["hist_id"]) > 0)
                {
                        $this->object->deleteVersions($_POST["hist_id"]);
                        ilUtil::sendSuccess($this->lng->txt("file_versions_deleted"), true);
                }

                $this->ctrl->setParameter($this, "hist_id", "");                
                $this->ctrl->redirect($this, "versions");
        }

Here is the call graph for this function:

deleteVersions()

ilObjFileGUI::deleteVersions

(

)

Displays a confirmation screen with selected file versions that should be deleted.

Definition at line 1258 of file class.ilObjFileGUI.php.

References $_GET, $_POST, ilObject\_getIcon(), ilUtil\sendFailure(), and ilUtil\sendQuestion().

        {
                global $ilTabs, $ilLocator;
                
                // get ids either from GET (if single item was clicked) or 
                // from POST (if multiple items were selected)
                $version_ids = isset($_GET["hist_id"]) ? array($_GET["hist_id"]) : $_POST["hist_id"];
                
                if (count($version_ids) < 1)
                {
                        ilUtil::sendFailure($this->lng->txt("no_checkbox"), true);
                        $this->ctrl->redirect($this, "versions");
                }
                else
                {
                        $ilTabs->activateTab("id_versions");

                        // check if all versions are selected
                        $versionsToKeep = array_udiff($this->object->getVersions(), $version_ids, array($this, "compareHistoryIds"));
                        if (count($versionsToKeep) < 1) 
                        {
                                // set our message
                                ilUtil::sendQuestion($this->lng->txt("file_confirm_delete_all_versions"));
                                
                                // show confirmation gui
                                include_once("./Services/Utilities/classes/class.ilConfirmationGUI.php");
                                $conf_gui = new ilConfirmationGUI();
                                $conf_gui->setFormAction($this->ctrl->getFormAction($this, "versions"));
                                $conf_gui->setCancel($this->lng->txt("cancel"), "cancelDeleteFile");
                                $conf_gui->setConfirm($this->lng->txt("confirm"), "confirmDeleteFile");
                                
                                $conf_gui->addItem("id[]", $this->ref_id, $this->object->getTitle(),
                                        ilObject::_getIcon($this->object->getId(), "small", $this->object->getType()),
                                        $this->lng->txt("icon")." ".$this->lng->txt("obj_".$this->object->getType()));
                        
                                $html = $conf_gui->getHTML();
                        }
                        else
                        {               
                                include_once("./Modules/File/classes/class.ilFileVersionTableGUI.php");
                        
                                ilUtil::sendQuestion($this->lng->txt("file_confirm_delete_versions"));
                                $versions = $this->object->getVersions($version_ids);
                        
                                $table = new ilFileVersionTableGUI($this, 'versions', true);
                                $table->setMaxCount(sizeof($versions));
                                $table->setData($versions);
                        
                                $html = $table->getHTML();
                        }

                        $this->tpl->setVariable('ADM_CONTENT', $html);
                }
        }

Here is the call graph for this function:

edit()

ilObjFileGUI::edit

(

)

edit object

public

Definition at line 574 of file class.ilObjFileGUI.php.

References $ilErr, ilObject2GUI\checkPermissionBool(), and initPropertiesForm().

        {
                global $ilTabs, $ilErr;

                if (!$this->checkPermissionBool("write"))
                {
                        $ilErr->raiseError($this->lng->txt("msg_no_perm_write"));
                }

                $ilTabs->activateTab("settings");

                $form = $this->initPropertiesForm();

                $val = array();
                $val['title'] = $this->object->getTitle();
                $val['description'] = $this->object->getLongDescription();
                $val['rating'] = $this->object->hasRating();
                $form->setValuesByArray($val);
                
                // Edit ecs export settings
                include_once 'Modules/File/classes/class.ilECSFileSettings.php';
                $ecs = new ilECSFileSettings($this->object);            
                $ecs->addSettingsToForm($form, 'file');
                
                $this->tpl->setContent($form->getHTML());
                return true;
        }

Here is the call graph for this function:

executeCommand()

ilObjFileGUI::executeCommand

(

)

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

References $_GET, $cmd, $ilCtrl, $ilErr, $ilUser, $ret, ilPaymentBookings\_readBookingByTransaction(), ilPaymentObject\_requiresPurchaseToAccess(), ilObjectGUI\addHeaderAction(), ilMDEditorGUI\addObserver(), ilObject2GUI\checkPermissionBool(), ilObject2GUI\getAccessHandler(), ilObject2GUI\getCreationMode(), ilCommonActionDispatcherGUI\getInstanceFromAjaxCall(), infoScreenForward(), ilObject2GUI\prepareOutput(), ilObject2GUI\setLocator(), and ilFileInputGUI\setPersonalWorkspaceQuotaCheck().

        {
                global $ilNavigationHistory, $ilCtrl, $ilUser, $ilTabs, $ilAccess, $ilErr;
                
                $next_class = $this->ctrl->getNextClass($this);
                $cmd = $this->ctrl->getCmd();
                
                if($this->id_type == self::WORKSPACE_NODE_ID)
                {
                        include_once "Services/Form/classes/class.ilFileInputGUI.php";
                        ilFileInputGUI::setPersonalWorkspaceQuotaCheck(true);
                }

                if(!$this->getCreationMode())
                {
                        // do not move this payment block!!
                        if(IS_PAYMENT_ENABLED)
                        {
                                include_once './Services/Payment/classes/class.ilPaymentObject.php';
                                if(ANONYMOUS_USER_ID == $ilUser->getId() && isset($_GET['transaction']))
                                {
                                        $transaction = $_GET['transaction'];
                                        include_once './Services/Payment/classes/class.ilPaymentBookings.php';
                                        $valid_transaction = ilPaymentBookings::_readBookingByTransaction($transaction);
                                }
                        
                                if(ilPaymentObject::_requiresPurchaseToAccess($this->node_id, $type = (isset($_GET['purchasetype'])
                                                ? $_GET['purchasetype'] : NULL) ))
                                {
                                        $this->setLocator();
                                        $this->tpl->getStandardTemplate();

                                        include_once './Services/Payment/classes/class.ilShopPurchaseGUI.php';
                                        $pp = new ilShopPurchaseGUI((int)$this->node_id);
                                        $ret = $this->ctrl->forwardCommand($pp);
                                        return true;
                                }
                        }
                        else if($this->id_type == self::REPOSITORY_NODE_ID 
                                && $this->checkPermissionBool("read"))
                        {
                                $ilCtrl->setParameterByClass("ilrepositorygui", "ref_id", $this->node_id);
                                $link = $ilCtrl->getLinkTargetByClass("ilrepositorygui", "infoScreen");
                                $ilCtrl->setParameterByClass("ilrepositorygui", "ref_id", $_GET["ref_id"]);                             

                                // add entry to navigation history
                                $ilNavigationHistory->addItem($this->node_id,
                                        $link, "file");
                        }
                }
                
                $this->prepareOutput();
                
                switch ($next_class)
                {
                        case "ilinfoscreengui":
                                $this->infoScreenForward();     // forwards command
                                break;

                        case 'ilmdeditorgui':                                                           
                                if(!$this->checkPermissionBool("write"))
                                {
                                        $ilErr->raiseError($this->lng->txt('permission_denied'),$ilErr->WARNING);
                                }                       
                                
                                $ilTabs->activateTab("id_meta");

                                include_once 'Services/MetaData/classes/class.ilMDEditorGUI.php';

                                $md_gui =& new ilMDEditorGUI($this->object->getId(), 0, $this->object->getType());
                                $md_gui->addObserver($this->object,'MDUpdateListener','General');
                                
                                // todo: make this work
                                $md_gui->addObserver($this->object,'MDUpdateListener','Technical');
                                
                                $this->ctrl->forwardCommand($md_gui);
                                break;
                                
                        // repository permissions
                        case 'ilpermissiongui':
                                $ilTabs->activateTab("id_permissions");
                                include_once("Services/AccessControl/classes/class.ilPermissionGUI.php");
                                $perm_gui =& new ilPermissionGUI($this);
                                $ret =& $this->ctrl->forwardCommand($perm_gui);
                                break;
                
                        case "ilexportgui":
                                if(!$this->checkPermissionBool("write"))
                                {
                                        $ilErr->raiseError($this->lng->txt('permission_denied'),$ilErr->WARNING);
                                }
                                $ilTabs->activateTab("export");
                                include_once("./Services/Export/classes/class.ilExportGUI.php");
                                $exp_gui = new ilExportGUI($this);
                                $exp_gui->addFormat("xml");
                                $ret = $this->ctrl->forwardCommand($exp_gui);
                                break;

                        case 'ilobjectcopygui':
                                include_once './Services/Object/classes/class.ilObjectCopyGUI.php';
                                $cp = new ilObjectCopyGUI($this);
                                $cp->setType('file');
                                $this->ctrl->forwardCommand($cp);
                                break;
                        
                        // personal workspace permissions
                        case "ilworkspaceaccessgui";                            
                                $ilTabs->activateTab("id_permissions");
                                include_once('./Services/PersonalWorkspace/classes/class.ilWorkspaceAccessGUI.php');
                                $wspacc = new ilWorkspaceAccessGUI($this->node_id, $this->getAccessHandler());
                                $this->ctrl->forwardCommand($wspacc);
                                break;
                        
                        case "ilcommonactiondispatchergui":
                                include_once("Services/Object/classes/class.ilCommonActionDispatcherGUI.php");
                                $gui = ilCommonActionDispatcherGUI::getInstanceFromAjaxCall();
                                $this->ctrl->forwardCommand($gui);
                                break;
                        
                        default:
                                // in personal workspace use object2gui 
                                if($this->id_type == self::WORKSPACE_NODE_ID)
                                {
                                        $this->addHeaderAction();
                                        
                                        // coming from goto we need default command
                                        if (empty($cmd))
                                        {
                                                $ilCtrl->setCmd("infoScreen");
                                        }
                                        $ilTabs->clearTargets();
                                        return parent::executeCommand();
                                }
                                
                                if (empty($cmd))
                                {
                                        $cmd = "infoScreen";
                                }

                                $this->$cmd();
                                break;
                }               
                
                $this->addHeaderAction();
        }

Here is the call graph for this function:

getType()

ilObjFileGUI::getType

(

)

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

        {
                return "file";
        }

handleFileUpload()

ilObjFileGUI::handleFileUpload (   $file_upload )

protected

Handles the upload of a single file and adds it to the parent object.

Parameters

array

$file_upload

An array containing the file upload parameters.

Returns

object The response object.

Definition at line 1083 of file class.ilObjFileGUI.php.

References ilObject2GUI\$access_handler, $filename, $ilUser, ilObjectGUI\$object, $size, ilObject2GUI\$tree, ilObjFileAccess\_getFileExtension(), ilObject\_lookupType(), ilChangeEvent\_recordWriteEvent(), ilObject2GUI\checkPermissionBool(), ilUtil\delDir(), ilObject2GUI\getAccessHandler(), ilMimeTypeUtil\getMimeType(), ilFileUtils\getNewObjects(), ilObject2GUI\handleAutoRating(), ilUtil\ilTempnam(), ilUtil\makeDir(), ilFileUtils\processZipFile(), ilObject2GUI\putObjectInTree(), and ilUtil\stripSlashes().

Referenced by uploadFiles().

        {
                global $ilUser;

                // file upload params
                $filename = ilUtil::stripSlashes($file_upload["name"]);
                $type = ilUtil::stripSlashes($file_upload["type"]);
                $size = ilUtil::stripSlashes($file_upload["size"]);
                $temp_name = $file_upload["tmp_name"];
                
                // additional params
                $title = ilUtil::stripSlashes($file_upload["title"]);
                $description = ilUtil::stripSlashes($file_upload["description"]);
                $extract = ilUtil::stripSlashes($file_upload["extract"]);
                $keep_structure = ilUtil::stripSlashes($file_upload["keep_structure"]);
                
                // create answer object         
                $response = new stdClass();
                $response->fileName = $filename;
                $response->fileSize = intval($size);
                $response->fileType = $type;
                $response->fileUnzipped = $extract;
                $response->error = null;

                // extract archive?
                if ($extract)
                {
                        $zip_file = $filename;
                        $adopt_structure = $keep_structure;

                        include_once ("Services/Utilities/classes/class.ilFileUtils.php");

                        // Create unzip-directory
                        $newDir = ilUtil::ilTempnam();
                        ilUtil::makeDir($newDir);
                        
                        // Check if permission is granted for creation of object, if necessary
                        if($this->id_type != self::WORKSPACE_NODE_ID)
                        {                                       
                                $type = ilObject::_lookupType((int)$this->parent_id, true);
                        }
                        else
                        {
                                $type = ilObject::_lookupType($this->tree->lookupObjectId($this->parent_id), false);
                        }                       
                        
                        $tree = $access_handler = null;
                        switch($type)
                        {
                                // workspace structure
                                case 'wfld':
                                case 'wsrt':
                                        $permission = $this->checkPermissionBool("create", "", "wfld");
                                        $containerType = "WorkspaceFolder";     
                                        $tree = $this->tree;
                                        $access_handler = $this->getAccessHandler();                                            
                                        break;
                                
                                // use categories as structure
                                case 'cat':
                                case 'root':
                                        $permission = $this->checkPermissionBool("create", "", "cat");
                                        $containerType = "Category";
                                        break;
                                
                                // use folders as structure (in courses)
                                default:
                                        $permission = $this->checkPermissionBool("create", "", "fold");
                                        $containerType = "Folder";      
                                        break;                                  
                        }                                                                                               
                        
                        try 
                        {
                                //      processZipFile ( 
                                //              Dir to unzip, 
                                //              Path to uploaded file, 
                                //              should a structure be created (+ permission check)?
                                //              ref_id of parent
                                //              object that contains files (folder or category)  
                                //              should sendInfo be persistent?)
                                ilFileUtils::processZipFile( 
                                        $newDir, 
                                        $temp_name,
                                        ($adopt_structure && $permission),
                                        $this->parent_id,
                                        $containerType,
                                        $tree,
                                        $access_handler);
                        }
                        catch (ilFileUtilsException $e) 
                        {
                                $response->error = $e->getMessage();
                        }
                        catch (Exception $ex)
                        {
                                $response->error = $ex->getMessage();      
                        }

                        ilUtil::delDir($newDir);
                        
                        // #15404
                        if($this->id_type != self::WORKSPACE_NODE_ID)
                        {
                                foreach(ilFileUtils::getNewObjects() as $parent_ref_id => $objects)
                                {
                                        if($parent_ref_id != $this->parent_id)
                                        {
                                                continue;
                                        }

                                        foreach($objects as $object)
                                        {
                                                $this->after_creation_callback_objects[] = $object;
                                        }
                                }       
                        }
                }
                else
                {
                        if (trim($title) == "")
                        {
                                $title = $filename;
                        }
                        else
                        {
                                // BEGIN WebDAV: Ensure that object title ends with the filename extension
                                $fileExtension = ilObjFileAccess::_getFileExtension($filename);
                                $titleExtension = ilObjFileAccess::_getFileExtension($title);
                                if ($titleExtension != $fileExtension && strlen($fileExtension) > 0)
                                {
                                        $title .= '.'.$fileExtension;
                                }
                                // END WebDAV: Ensure that object title ends with the filename extension
                        }
                        
                        // create and insert file in grp_tree
                        include_once("./Modules/File/classes/class.ilObjFile.php");
                        $fileObj = new ilObjFile();
                        $fileObj->setTitle($title);
                        $fileObj->setDescription($description);
                        $fileObj->setFileName($filename);
                        
                        include_once("./Services/Utilities/classes/class.ilMimeTypeUtil.php");
                        $fileObj->setFileType(ilMimeTypeUtil::getMimeType("", $filename, $type));
                        $fileObj->setFileSize($size);
                        $this->object_id = $fileObj->create();
                        
                        $this->putObjectInTree($fileObj, $this->parent_id);
                        
                        // see uploadFiles()
                        if(is_array($this->after_creation_callback_objects))
                        {
                                $this->after_creation_callback_objects[] = $fileObj;
                        }
                        
                        // upload file to filesystem
                        $fileObj->createDirectory();
                        $fileObj->raiseUploadError(false);
                        $fileObj->getUploadFile($temp_name, $filename);
                        
                        $this->handleAutoRating($fileObj);
                        
                        // BEGIN ChangeEvent: Record write event.
                        require_once('./Services/Tracking/classes/class.ilChangeEvent.php');
                        ilChangeEvent::_recordWriteEvent($fileObj->getId(), $ilUser->getId(), 'create');
                        // END ChangeEvent: Record write event.    
                }
                
                return $response;
        }

Here is the call graph for this function:

Here is the caller graph for this function:

infoScreen()

ilObjFileGUI::infoScreen

(

)

this one is called from the info button in the repository not very nice to set cmdClass/Cmd manually, if everything works through ilCtrl in the future this may be changed

Definition at line 737 of file class.ilObjFileGUI.php.

References infoScreenForward().

        {
                $this->ctrl->setCmd("showSummary");
                $this->ctrl->setCmdClass("ilinfoscreengui");
                $this->infoScreenForward();
        }

Here is the call graph for this function:

infoScreenForward()

ilObjFileGUI::infoScreenForward

(

)

show information screen

Definition at line 747 of file class.ilObjFileGUI.php.

References ilObject2GUI\$access_handler, $ilErr, $preview, ilObjectGUI\$tpl, ilObjFileAccess\_getPermanentDownloadLink(), ilObjFile\_lookupFileSize(), ilObject2GUI\checkPermissionBool(), ilPreviewGUI\CONTEXT_REPOSITORY, ilPreviewGUI\CONTEXT_WORKSPACE, ilFormat\formatSize(), ilLinkButton\getInstance(), ilUserUtil\getNamePresentation(), ilObject2GUI\getPermanentLinkWidget(), and ilPreview\hasPreview().

Referenced by executeCommand(), and infoScreen().

        {
                global $ilTabs, $ilErr, $ilToolbar;
                
                $ilTabs->activateTab("id_info");

                if (!$this->checkPermissionBool("visible"))
                {
                        $ilErr->raiseError($this->lng->txt("msg_no_perm_read"));
                }

                include_once("./Services/InfoScreen/classes/class.ilInfoScreenGUI.php");
                $info = new ilInfoScreenGUI($this);

                if ($this->checkPermissionBool("read", "sendfile"))
                {
                        // #9876
                        $this->lng->loadLanguageModule("file");
                        
                        // #14378
                        include_once "Services/UIComponent/Button/classes/class.ilLinkButton.php";
                        $button = ilLinkButton::getInstance();
                        $button->setCaption("file_download");
                        $button->setPrimary(true);
                        
                        // get permanent download link for repository
                        if ($this->id_type == self::REPOSITORY_NODE_ID)
                        {
                                $button->setUrl(ilObjFileAccess::_getPermanentDownloadLink($this->node_id));                            
                        }
                        else
                        {
                                $button->setUrl($this->ctrl->getLinkTarget($this, "sendfile"));         
                        }
                        
                        $ilToolbar->addButtonInstance($button);
                }
                
                $info->enablePrivateNotes();
                
                if ($this->checkPermissionBool("read"))
                {
                        $info->enableNews();
                }

                // no news editing for files, just notifications
                $info->enableNewsEditing(false);
                if ($this->checkPermissionBool("write"))
                {
                        $news_set = new ilSetting("news");
                        $enable_internal_rss = $news_set->get("enable_rss_for_internal");
                        
                        if ($enable_internal_rss)
                        {
                                $info->setBlockProperty("news", "settings", true);
                                $info->setBlockProperty("news", "public_notifications_option", true);
                        }
                }

                
                // standard meta data
                $info->addMetaDataSections($this->object->getId(),0, $this->object->getType());
                
                $info->addSection($this->lng->txt("file_info"));
                $info->addProperty($this->lng->txt("filename"),
                        $this->object->getFileName());
                // BEGIN WebDAV Guess file type.
                $info->addProperty($this->lng->txt("type"),
                                $this->object->guessFileType());
                // END WebDAV Guess file type.
                $info->addProperty($this->lng->txt("size"),
                        ilFormat::formatSize(ilObjFile::_lookupFileSize($this->object->getId()),'long'));
                $info->addProperty($this->lng->txt("version"),
                        $this->object->getVersion());
                
                // using getVersions function instead of ilHistory direct
                $uploader = $this->object->getVersions();
                $uploader = array_shift($uploader);
                $uploader = $uploader["user_id"];               
                
                $this->lng->loadLanguageModule("file");
                include_once "Services/User/classes/class.ilUserUtil.php";
                $info->addProperty($this->lng->txt("file_uploaded_by"), ilUserUtil::getNamePresentation($uploader));
                
                // download link added in repository
                if ($this->id_type == self::REPOSITORY_NODE_ID && $this->checkPermissionBool("read", "sendfile"))
                {
                        $tpl = new ilTemplate("tpl.download_link.html", true, true, "Modules/File");
                        $tpl->setVariable("LINK", ilObjFileAccess::_getPermanentDownloadLink($this->node_id));
                        $info->addProperty($this->lng->txt("download_link"), $tpl->get());
                }
                
                if($this->id_type == self::WORKSPACE_NODE_ID)
                {                       
                        $info->addProperty($this->lng->txt("perma_link"), $this->getPermanentLinkWidget());
                }
                
                // display previews
                include_once("./Services/Preview/classes/class.ilPreview.php");
                if (!$this->ctrl->isAsynch() && 
                        ilPreview::hasPreview($this->object->getId(), $this->object->getType()) && 
                        $this->checkPermissionBool("read"))
                {
                        include_once("./Services/Preview/classes/class.ilPreviewGUI.php");
                        
                        // get context for access checks later on
            $context;
                        switch ($this->id_type)
                        {
                                case self::WORKSPACE_NODE_ID:
                                case self::WORKSPACE_OBJECT_ID:
                                        $context = ilPreviewGUI::CONTEXT_WORKSPACE;
                                        break;  
                                
                                default:
                                        $context = ilPreviewGUI::CONTEXT_REPOSITORY;
                                        break;  
                        }
                        
            $preview = new ilPreviewGUI($this->node_id, $context, $this->object->getId(), $this->access_handler);
                        $info->addProperty($this->lng->txt("preview"), $preview->getInlineHTML());
                }

                // forward the command
            // $this->ctrl->setCmd("showSummary");
                // $this->ctrl->setCmdClass("ilinfoscreengui");
            $this->ctrl->forwardCommand($info);
        }

Here is the call graph for this function:

Here is the caller graph for this function:

initCreationForms()

ilObjFileGUI::initCreationForms ( )

protected

Definition at line 179 of file class.ilObjFileGUI.php.

References ilObject2GUI\fillCloneTemplate(), ilObjectGUI\initImportForm(), initMultiUploadForm(), initSingleUploadForm(), initZipUploadForm(), ilFileUploadSettings\isDragAndDropUploadEnabled(), ilDiskQuotaHandler\isUploadPossible(), and ilUtil\sendFailure().

        {                               
                $forms = array();               
                        
                if($this->id_type == self::WORKSPACE_NODE_ID)
                {
                        include_once "Services/DiskQuota/classes/class.ilDiskQuotaHandler.php";
                        if(!ilDiskQuotaHandler::isUploadPossible())
                        {                               
                                $this->lng->loadLanguageModule("file");
                                ilUtil::sendFailure($this->lng->txt("personal_workspace_quota_exceeded_warning"), true);
                                $this->ctrl->redirect($this, "cancel");
                        }
                }
                
                // use drag-and-drop upload if configured
                require_once("Services/FileUpload/classes/class.ilFileUploadSettings.php");
                if (ilFileUploadSettings::isDragAndDropUploadEnabled())
                {
                        $forms[] = $this->initMultiUploadForm();
                }
                else
                {
                        $forms[] = $this->initSingleUploadForm();
                        $forms[] = $this->initZipUploadForm();
                }

                // repository only
                if($this->id_type != self::WORKSPACE_NODE_ID)
                {
                        $forms[self::CFORM_IMPORT] = $this->initImportForm('file');
                        $forms[self::CFORM_CLONE] = $this->fillCloneTemplate(null, "file");             
                }                       
                
                return $forms;
        }

Here is the call graph for this function:

initHeaderAction()

ilObjFileGUI::initHeaderAction (   $a_sub_type = null,   $a_sub_id = null  )

protected

Definition at line 1427 of file class.ilObjFileGUI.php.

        {
                $lg = parent::initHeaderAction($a_sub_type, $a_sub_id); 
                if(is_object($lg))
                {                       
                        if($this->object->hasRating())
                        {
                                $lg->enableRating(true, null, false,
                                        array("ilcommonactiondispatchergui", "ilratinggui"));
                        }                                               
                }       
                return $lg;
        }

initMultiUploadForm()

ilObjFileGUI::initMultiUploadForm

(

)

Initializes the upload form for multiple files.

Returns

object The created property form.

Definition at line 979 of file class.ilObjFileGUI.php.

References ilUtil\getImagePath(), ilObject2GUI\getTargetFrame(), and ilDragDropFileInputGUI\setArchiveSuffixes().

Referenced by initCreationForms(), and uploadFiles().

        {
                include_once("Services/Form/classes/class.ilPropertyFormGUI.php");
                $dnd_form_gui = new ilPropertyFormGUI();
                $dnd_form_gui->setMultipart(true);
                $dnd_form_gui->setHideLabels();
                
                // file input
                include_once("Services/Form/classes/class.ilDragDropFileInputGUI.php");
                $dnd_input = new ilDragDropFileInputGUI($this->lng->txt("files"), "upload_files");
                $dnd_input->setArchiveSuffixes(array("zip"));
                $dnd_input->setCommandButtonNames("uploadFiles", "cancel");
                $dnd_form_gui->addItem($dnd_input);
                
                // add commands
                $dnd_form_gui->addCommandButton("uploadFiles", $this->lng->txt("upload_files"));
                $dnd_form_gui->addCommandButton("cancel", $this->lng->txt("cancel"));
                
                $dnd_form_gui->setTableWidth("100%");
                $dnd_form_gui->setTarget($this->getTargetFrame("save"));
                $dnd_form_gui->setTitle($this->lng->txt("upload_files_title"));
                $dnd_form_gui->setTitleIcon(ilUtil::getImagePath('icon_file.gif'), $this->lng->txt('obj_file'));
                
                $this->ctrl->setParameter($this, "new_type", "file");
                $dnd_form_gui->setFormAction($this->ctrl->getFormAction($this, "uploadFiles"));
                
                return $dnd_form_gui;
        }

Here is the call graph for this function:

Here is the caller graph for this function:

initPropertiesForm()

ilObjFileGUI::initPropertiesForm ( )

protected

Parameters

Definition at line 607 of file class.ilObjFileGUI.php.

References $file, ilDiskQuotaHandler\isUploadPossible(), ilRadioOption\setInfo(), ilFormPropertyGUI\setInfo(), ilTextAreaInputGUI\setRows(), and ilTextInputGUI\setValue().

Referenced by edit(), and update().

        {
                include_once('./Services/Form/classes/class.ilPropertyFormGUI.php');
                
                $this->lng->loadLanguageModule('file');

                $form = new ilPropertyFormGUI();
                $form->setFormAction($this->ctrl->getFormAction($this),'update');
                $form->setTitle($this->lng->txt('file_edit'));
                $form->addCommandButton('update',$this->lng->txt('save'));
                $form->addCommandButton('cancel',$this->lng->txt('cancel'));
                        
                $title = new ilTextInputGUI($this->lng->txt('title'),'title');
                $title->setValue($this->object->getTitle());
                $title->setInfo($this->lng->txt("if_no_title_then_filename"));
                $form->addItem($title);
                
                $upload_possible = true;
                if($this->id_type == self::WORKSPACE_NODE_ID)
                {
                        include_once "Services/DiskQuota/classes/class.ilDiskQuotaHandler.php";
                        $upload_possible = ilDiskQuotaHandler::isUploadPossible();                      
                }
                
                if($upload_possible)
                {
                        $file = new ilFileInputGUI($this->lng->txt('obj_file'),'file');
                        $file->setRequired(false);
        //              $file->enableFileNameSelection('title');
                        $form->addItem($file);

                        $group = new ilRadioGroupInputGUI('','replace');
                        $group->setValue(0);

                        $replace = new ilRadioOption($this->lng->txt('replace_file'),1);
                        $replace->setInfo($this->lng->txt('replace_file_info'));
                        $group->addOption($replace);


                        $keep = new ilRadioOption($this->lng->txt('file_new_version'),0);
                        $keep->setInfo($this->lng->txt('file_new_version_info'));
                        $group->addOption($keep);

                        $file->addSubItem($group);
                }
                else
                {                       
                        $file = new ilNonEditableValueGUI($this->lng->txt('obj_file'));
                        $file->setValue($this->lng->txt("personal_workspace_quota_exceeded_warning"));
                        $form->addItem($file);
                }
                        
                $desc = new ilTextAreaInputGUI($this->lng->txt('description'),'description');
                $desc->setRows(3);
                #$desc->setCols(40);
                $form->addItem($desc);
                
                if($this->id_type == self::REPOSITORY_NODE_ID)
                {                       
                        $this->lng->loadLanguageModule('rating');
                        $rate = new ilCheckboxInputGUI($this->lng->txt('rating_activate_rating'), 'rating');
                        $rate->setInfo($this->lng->txt('rating_activate_rating_info'));
                        $form->addItem($rate);
                }

                return $form;
        }

Here is the call graph for this function:

Here is the caller graph for this function:

initSingleUploadForm()

ilObjFileGUI::initSingleUploadForm

(

)

FORM: Init single upload form.

Definition at line 219 of file class.ilObjFileGUI.php.

References ilObjectGUI\$lng, ilUtil\getImagePath(), ilObject2GUI\getTargetFrame(), ilFormPropertyGUI\setInfo(), ilFormPropertyGUI\setRequired(), and ilObject\TITLE_LENGTH.

Referenced by initCreationForms(), and save().

        {
                global $lng;
                
                include_once("Services/Form/classes/class.ilPropertyFormGUI.php");
                $single_form_gui = new ilPropertyFormGUI();
                $single_form_gui->setMultipart(true);
                
                // File Title
                $in_title = new ilTextInputGUI($lng->txt("title"), "title");
                $in_title->setInfo($this->lng->txt("if_no_title_then_filename"));
                $in_title->setSize(min(40, ilObject::TITLE_LENGTH));
                $in_title->setMaxLength(ilObject::TITLE_LENGTH);
                $single_form_gui->addItem($in_title);
                
                // File Description
                $in_descr = new ilTextAreaInputGUI($lng->txt("description"), "description");
                $single_form_gui->addItem($in_descr);
                
                // File
                $in_file = new ilFileInputGUI($lng->txt("file"), "upload_file");
                $in_file->setRequired(true);
                $single_form_gui->addItem($in_file);
                
                $single_form_gui->addCommandButton("save", $this->lng->txt($this->type."_add"));
                $single_form_gui->addCommandButton("saveAndMeta", $this->lng->txt("file_add_and_metadata"));
                $single_form_gui->addCommandButton("cancel", $lng->txt("cancel"));
                
                $single_form_gui->setTableWidth("600px");
                $single_form_gui->setTarget($this->getTargetFrame("save"));
                $single_form_gui->setTitle($this->lng->txt($this->type."_new"));
                $single_form_gui->setTitleIcon(ilUtil::getImagePath('icon_file.svg'), $this->lng->txt('obj_file'));
                
                $this->ctrl->setParameter($this, "new_type", "file");
        
                $single_form_gui->setFormAction($this->ctrl->getFormAction($this, "save"));

                return $single_form_gui;
        }

Here is the call graph for this function:

Here is the caller graph for this function:

initZipUploadForm()

ilObjFileGUI::initZipUploadForm

(

$a_mode = "create"

)

FORM: Init zip upload form.

Definition at line 357 of file class.ilObjFileGUI.php.

References ilObjectGUI\$lng, ilUtil\getImagePath(), ilObject2GUI\getTargetFrame(), ilFormPropertyGUI\setInfo(), and ilFormPropertyGUI\setRequired().

Referenced by initCreationForms(), and saveUnzip().

        {
                global $lng;
                
                include_once("Services/Form/classes/class.ilPropertyFormGUI.php");
                $zip_form_gui = new ilPropertyFormGUI();
                $zip_form_gui->setMultipart(true);
                                
                // File
                $in_file = new ilFileInputGUI($lng->txt("file"), "zip_file");
                $in_file->setRequired(true);
                $in_file->setSuffixes(array("zip"));
                $zip_form_gui->addItem($in_file);

                // Take over structure
                $in_str = new ilCheckboxInputGUI($this->lng->txt("take_over_structure"), "adopt_structure");
                $in_str->setInfo($this->lng->txt("take_over_structure_info"));
                $zip_form_gui->addItem($in_str);
                
                $zip_form_gui->addCommandButton("saveUnzip", $this->lng->txt($this->type."_add"));
                $zip_form_gui->addCommandButton("cancel", $lng->txt("cancel"));
                
                $zip_form_gui->setTableWidth("600px");
                $zip_form_gui->setTarget($this->getTargetFrame("save"));
                $zip_form_gui->setTitle($this->lng->txt("header_zip"));
                $zip_form_gui->setTitleIcon(ilUtil::getImagePath('icon_file.svg'), $this->lng->txt('obj_file'));
                
                $this->ctrl->setParameter($this, "new_type", "file");
                
                $zip_form_gui->setFormAction($this->ctrl->getFormAction($this, "saveUnzip"));

                return $zip_form_gui;
        }

Here is the call graph for this function:

Here is the caller graph for this function:

rollbackVersion()

ilObjFileGUI::rollbackVersion

(

)

Performs a rollback with the selected file version.

Definition at line 1399 of file class.ilObjFileGUI.php.

References $_GET, $_POST, ilObject2GUI\checkPermissionBool(), ilUtil\sendInfo(), and ilUtil\sendSuccess().

        {
                global $ilTabs;
                
                // has the user the rights to delete the file?
                if (!$this->checkPermissionBool("write"))
                {
                        $this->ilErr->raiseError($this->lng->txt("permission_denied"), $this->ilErr->MESSAGE);
                }
                
                // get ids either from GET (if single item was clicked) or 
                // from POST (if multiple items were selected)
                $version_ids = isset($_GET["hist_id"]) ? array($_GET["hist_id"]) : $_POST["hist_id"];
                
                // more than one entry selected?
                if (count($version_ids) != 1)
                {
                        ilUtil::sendInfo($this->lng->txt("file_rollback_select_exact_one"), true);
                        $this->ctrl->redirect($this, "versions");
                }

                // rollback the version
                $new_version = $this->object->rollback($version_ids[0]);

                ilUtil::sendSuccess(sprintf($this->lng->txt("file_rollback_done"), $new_version["rollback_version"]), true);
                $this->ctrl->redirect($this, "versions");
        }

Here is the call graph for this function:

save()

ilObjFileGUI::save

(

)

save object

public

Definition at line 264 of file class.ilObjFileGUI.php.

References $ilUser, ilObjectGUI\$objDefinition, ilObjFileAccess\_getFileExtension(), ilChangeEvent\_recordWriteEvent(), ilObject2GUI\checkPermissionBool(), ilMimeTypeUtil\getMimeType(), ilObject2GUI\handleAutoRating(), initSingleUploadForm(), ilObject2GUI\putObjectInTree(), ilUtil\redirect(), and ilUtil\sendSuccess().

Referenced by saveAndMeta().

        {
                global $objDefinition, $ilUser;

                if (!$this->checkPermissionBool("create", "", "file"))
                {
                        $this->ilErr->raiseError($this->lng->txt("permission_denied"),$this->ilErr->MESSAGE);
                }

                $single_form_gui = $this->initSingleUploadForm();

                if ($single_form_gui->checkInput())
                {
                        $title = $single_form_gui->getInput("title");
                        $description = $single_form_gui->getInput("description");
                        $upload_file = $single_form_gui->getInput("upload_file");

                        if (trim($title) == "")
                        {
                                $title = $upload_file["name"];
                        }
                        else
                        {
                                // BEGIN WebDAV: Ensure that object title ends with the filename extension
                                $fileExtension = ilObjFileAccess::_getFileExtension($upload_file["name"]);
                                $titleExtension = ilObjFileAccess::_getFileExtension($title);
                                if ($titleExtension != $fileExtension && strlen($fileExtension) > 0)
                                {
                                        $title .= '.'.$fileExtension;
                                }
                                // END WebDAV: Ensure that object title ends with the filename extension
                        }

                        // create and insert file in grp_tree
                        include_once("./Modules/File/classes/class.ilObjFile.php");
                        $fileObj = new ilObjFile();
                        $fileObj->setTitle($title);
                        $fileObj->setDescription($description);
                        $fileObj->setFileName($upload_file["name"]);
                        //$fileObj->setFileType($upload_file["type"]);
                        include_once("./Services/Utilities/classes/class.ilMimeTypeUtil.php");
                        $fileObj->setFileType(ilMimeTypeUtil::getMimeType(
                                "", $upload_file["name"], $upload_file["type"]));
                        $fileObj->setFileSize($upload_file["size"]);
                        $this->object_id = $fileObj->create();

                        $this->putObjectInTree($fileObj, $this->parent_id);

                        // upload file to filesystem
                        $fileObj->createDirectory();
                        $fileObj->getUploadFile($upload_file["tmp_name"],
                                $upload_file["name"]);
                        
                        $this->handleAutoRating($fileObj);

                        // BEGIN ChangeEvent: Record write event.
                        require_once('Services/Tracking/classes/class.ilChangeEvent.php');
                        ilChangeEvent::_recordWriteEvent($fileObj->getId(), $ilUser->getId(), 'create');
                        // END ChangeEvent: Record write event.
                        
                        ilUtil::sendSuccess($this->lng->txt("file_added"),true);

                        if ($this->ctrl->getCmd() == "saveAndMeta")
                        {
                                $this->ctrl->setParameter($this, "new_type", "");
                                $target = $this->ctrl->getLinkTargetByClass(array("ilobjfilegui", "ilmdeditorgui"), "listSection", "", false, false);
                                ilUtil::redirect($target);
                        }
                        else
                        {
                                $this->ctrl->returnToParent($this);
                        }
                }
                else
                {
                        $single_form_gui->setValuesByPost();
                        $this->tpl->setContent($single_form_gui->getHTML());
                }
        }

Here is the call graph for this function:

Here is the caller graph for this function:

saveAndMeta()

ilObjFileGUI::saveAndMeta

(

)

save object

public

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

References save().

        {
                $this->save();
        }

Here is the call graph for this function:

saveUnzip()

ilObjFileGUI::saveUnzip

(

)

saveUnzip object

public

Definition at line 396 of file class.ilObjFileGUI.php.

References ilObject2GUI\$access_handler, ilObject2GUI\$tree, ilObject\_lookupType(), ilObject2GUI\checkPermissionBool(), ilUtil\delDir(), ilObject2GUI\getAccessHandler(), ilUtil\ilTempnam(), initZipUploadForm(), ilUtil\makeDir(), ilFileUtils\processZipFile(), ilUtil\sendFailure(), and ilUtil\sendSuccess().

        {
                $zip_form_gui = $this->initZipUploadForm();

                if ($this->checkPermissionBool("create", "", "file"))
                {
                        if ($zip_form_gui->checkInput())
                        {
                                $zip_file = $zip_form_gui->getInput("zip_file");
                                $adopt_structure = $zip_form_gui->getInput("adopt_structure");

                                include_once ("Services/Utilities/classes/class.ilFileUtils.php");

                                // Create unzip-directory
                                $newDir = ilUtil::ilTempnam();
                                ilUtil::makeDir($newDir);
                                
                                // Check if permission is granted for creation of object, if necessary
                                if($this->id_type != self::WORKSPACE_NODE_ID)
                                {
                                        
                                        $type = ilObject::_lookupType((int)$this->parent_id, true);
                                }
                                else
                                {
                                        $type = ilObject::_lookupType($this->tree->lookupObjectId($this->parent_id), false);
                                }                       
                                
                                $tree = $access_handler = null;
                                switch($type)
                                {
                                        // workspace structure
                                        case 'wfld':
                                        case 'wsrt':
                                                $permission = $this->checkPermissionBool("create", "", "wfld");
                                                $containerType = "WorkspaceFolder";     
                                                $tree = $this->tree;
                                                $access_handler = $this->getAccessHandler();                                            
                                                break;
                                        
                                        // use categories as structure
                                        case 'cat':
                                        case 'root':
                                                $permission = $this->checkPermissionBool("create", "", "cat");
                                                $containerType = "Category";
                                                break;
                                        
                                        // use folders as structure (in courses)
                                        default:
                                                $permission = $this->checkPermissionBool("create", "", "fold");
                                                $containerType = "Folder";      
                                                break;                                  
                                }                                                                                               
                                //      processZipFile ( 
                                //              Dir to unzip, 
                                //              Path to uploaded file, 
                                //              should a structure be created (+ permission check)?
                                //              ref_id of parent
                                //              object that contains files (folder or category)  
                                //              should sendInfo be persistent?)
                                try 
                                {
                                        $processDone = ilFileUtils::processZipFile( $newDir, 
                                                $zip_file["tmp_name"],
                                                ($adopt_structure && $permission),
                                                $this->parent_id,
                                                $containerType,
                                                $tree,
                                                $access_handler);
                                        ilUtil::sendSuccess($this->lng->txt("file_added"),true);
                                }
                                catch (ilFileUtilsException $e) 
                                {
                                        ilUtil::sendFailure($e->getMessage(), true);
                                }

                                ilUtil::delDir($newDir);
                                $this->ctrl->returnToParent($this);
                        }
                        else
                        {
                                $zip_form_gui->setValuesByPost();
                                $this->tpl->setContent($zip_form_gui->getHTML());
                        }
                }
                else
                {
                        $this->ilErr->raiseError($this->lng->txt("permission_denied"),$this->ilErr->MESSAGE);
                }
        }

Here is the call graph for this function:

sendFile()

ilObjFileGUI::sendFile

(

)

Definition at line 675 of file class.ilObjFileGUI.php.

References $_GET, $ilCtrl, $ilUser, ilChangeEvent\_recordReadEvent(), and ilObject2GUI\checkPermissionBool().

        {
                global $ilUser, $ilCtrl;
                
                if(ANONYMOUS_USER_ID == $ilUser->getId() && isset($_GET['transaction']) )
                {
                        $this->object->sendFile($_GET["hist_id"]);
                }

                if ($this->checkPermissionBool("read"))
                {
                        // BEGIN ChangeEvent: Record read event.
                        require_once('Services/Tracking/classes/class.ilChangeEvent.php');
                        global $ilUser;
                        // Record read event and catchup with write events
                        ilChangeEvent::_recordReadEvent($this->object->getType(), $this->object->getRefId(),
                                $this->object->getId(), $ilUser->getId());                      
                        // END ChangeEvent: Record read event.

                        $this->object->sendFile($_GET["hist_id"]);
                }
                else
                {
                        $this->ilErr->raiseError($this->lng->txt("permission_denied"),$this->ilErr->MESSAGE);
                }
                return true;
        }

Here is the call graph for this function:

setTabs()

ilObjFileGUI::setTabs

(

)

Definition at line 878 of file class.ilObjFileGUI.php.

References ilObjectGUI\$lng, and ilObject2GUI\checkPermissionBool().

        {
                global $ilTabs, $lng, $ilHelp;
                
                $ilHelp->setScreenIdComponent("file");

                $this->ctrl->setParameter($this,"ref_id",$this->node_id);

                if ($this->checkPermissionBool("visible"))
                {
                        $ilTabs->addTab("id_info",
                                $lng->txt("info_short"),
                                $this->ctrl->getLinkTargetByClass(array("ilobjfilegui", "ilinfoscreengui"), "showSummary"));
                }

                if ($this->checkPermissionBool("write"))
                {
                        $ilTabs->addTab("settings",
                                $lng->txt("edit"),
                                $this->ctrl->getLinkTarget($this, "edit"));
                }

                if ($this->checkPermissionBool("write"))
                {
                        $ilTabs->addTab("id_versions",
                                $lng->txt("versions"),
                                $this->ctrl->getLinkTarget($this, "versions"));
                }

                // meta data
                if ($this->checkPermissionBool("write"))
                {
                        $ilTabs->addTab("id_meta",
                                $lng->txt("meta_data"),
                                $this->ctrl->getLinkTargetByClass(array('ilobjfilegui','ilmdeditorgui'),'listSection'));
                }

                // export
                if ($this->checkPermissionBool("write"))
                {
                        $ilTabs->addTab("export",
                                $lng->txt("export"),
                                $this->ctrl->getLinkTargetByClass("ilexportgui", ""));
                }

                // will add permission tab if needed
                parent::setTabs();
        }

Here is the call graph for this function:

update()

ilObjFileGUI::update

(

)

updates object entry in object_data

public

Definition at line 492 of file class.ilObjFileGUI.php.

References ilObjectGUI\$data, $filename, $ilUser, ilChangeEvent\_catchupWriteEvents(), ilChangeEvent\_recordWriteEvent(), ilMimeTypeUtil\getMimeType(), initPropertiesForm(), ilUtil\redirect(), and ilUtil\sendSuccess().

        {
                global $ilTabs;
                
                $form = $this->initPropertiesForm();
                if(!$form->checkInput())
                {
                        $ilTabs->activateTab("settings");
                        $form->setValuesByPost();
                        $this->tpl->setContent($form->getHTML());
                        return false;   
                }

                $data = $form->getInput('file');                

                // delete trailing '/' in filename
                while (substr($data["name"],-1) == '/')
                {
                        $data["name"] = substr($data["name"],0,-1);
                }
                
                $filename = empty($data["name"]) ? $this->object->getFileName() : $data["name"];
                $title = $form->getInput('title');
                if(strlen(trim($title)) == 0)
                {
                        $title = $filename;
                }
                else
                {
                        $title = $this->object->checkFileExtension($filename,$title);
                }
                $this->object->setTitle($title);
                
                if (!empty($data["name"]))
                {
                        switch($form->getInput('replace'))
                        {
                                case 1:
                                        $this->object->deleteVersions();
                                        $this->object->clearDataDirectory();
                                        $this->object->replaceFile($data['tmp_name'],$data['name']);
                                        break;
                                case 0:
                                        $this->object->addFileVersion($data['tmp_name'],$data['name']);
                                        break;
                        }
                        $this->object->setFileName($data['name']);
                        include_once("./Services/Utilities/classes/class.ilMimeTypeUtil.php");
                        $this->object->setFileType(ilMimeTypeUtil::getMimeType(
                                "", $data["name"], $data["type"]));
                        $this->object->setFileSize($data['size']);
                }
                
                $this->object->setDescription($form->getInput('description'));
                $this->object->setRating($form->getInput('rating'));
                
                $this->update = $this->object->update();

                // BEGIN ChangeEvent: Record update event.
                if (!empty($data["name"]))
                {
                        require_once('Services/Tracking/classes/class.ilChangeEvent.php');
                        global $ilUser;
                        ilChangeEvent::_recordWriteEvent($this->object->getId(), $ilUser->getId(), 'update');
                        ilChangeEvent::_catchupWriteEvents($this->object->getId(), $ilUser->getId());                   
                }
                // END ChangeEvent: Record update event.
                
                // Update ecs export settings
                include_once 'Modules/File/classes/class.ilECSFileSettings.php';        
                $ecs = new ilECSFileSettings($this->object);                    
                $ecs->handleSettingsUpdate();
                
                ilUtil::sendSuccess($this->lng->txt("msg_obj_modified"),true);
                ilUtil::redirect($this->ctrl->getLinkTarget($this,'edit','',false,false));
        }

Here is the call graph for this function:

uploadFiles()

ilObjFileGUI::uploadFiles

(

)

Called after a file was uploaded.

Definition at line 1011 of file class.ilObjFileGUI.php.

References $_REQUEST, ilObject2GUI\checkPermissionBool(), ilJsonUtil\encode(), exit, ilObject2GUI\handleAfterSaveCallback(), handleFileUpload(), and initMultiUploadForm().

        {
                include_once("./Services/JSON/classes/class.ilJsonUtil.php");
                
                $response = new stdClass();     
                $response->error = null;
                $response->debug = null;        
                
                $files = $_FILES;
                
                // #14249 - race conditions because of concurrent uploads
                $after_creation_callback = (int)$_REQUEST["crtcb"];
                if($after_creation_callback)
                {
                        $this->after_creation_callback_objects = array();
                        unset($_REQUEST["crtcb"]);
                }
                
                // load form
                $dnd_form_gui = $this->initMultiUploadForm();
                if ($dnd_form_gui->checkInput())
                {
                        try
                        {
                                if (!$this->checkPermissionBool("create", "", "file"))
                                {
                                        $response->error = $this->lng->txt("permission_denied");
                                }
                                else
                                {
                                        // handle the file
                                        $fileresult = $this->handleFileUpload($dnd_form_gui->getInput("upload_files"));
                                        if ($fileresult)
                                                $response = (object)array_merge((array)$response, (array)$fileresult);
                                }
                        }
                        catch (Exception $ex)
                        {
                                $response->error = $ex->getMessage() . " ## " . $ex->getTraceAsString();
                        }
                }
                else
                {
                        $dnd_input = $dnd_form_gui->getItemByPostVar("upload_files");
                        $response->error = $dnd_input->getAlert();
                }
                
                if($after_creation_callback &&
                        sizeof($this->after_creation_callback_objects))
                {                       
                        foreach($this->after_creation_callback_objects as $new_file_obj)
                        {                               
                                ilObject2GUI::handleAfterSaveCallback($new_file_obj, $after_creation_callback);
                        }
                        unset($this->after_creation_callback_objects);
                }

                // send response object (don't use 'application/json' as IE wants to download it!)
                header('Vary: Accept');
                header('Content-type: text/plain');
                echo ilJsonUtil::encode($response);
                
                // no further processing!
                exit;
        }       

Here is the call graph for this function:

versions()

ilObjFileGUI::versions

(

)

file versions/history

public

Definition at line 709 of file class.ilObjFileGUI.php.

References ilObject2GUI\checkPermissionBool().

        {
                global $ilTabs;
                
                $ilTabs->activateTab("id_versions");

                if (!$this->checkPermissionBool("write"))
                {
                        $this->ilErr->raiseError($this->lng->txt("permission_denied"),$this->ilErr->MESSAGE);
                }
                
                // get versions
                $versions = $this->object->getVersions();
                
                // build versions table
                require_once("Modules/File/classes/class.ilFileVersionTableGUI.php");
                $table = new ilFileVersionTableGUI($this, "versions");
                $table->setMaxCount(sizeof($versions));
                $table->setData($versions);             
                
                $this->tpl->setVariable("ADM_CONTENT", $table->getHTML());
        }

Here is the call graph for this function:

---

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

• Modules/File/classes/class.ilObjFileGUI.php