ilMailFolderGUI Class Reference

Collaboration diagram for ilMailFolderGUI:

Public Member Functions
	__construct ()
	executeCommand ()
	cancelEmptyTrash ()
	cancel Empty Trash Action and return to folder More...
	performEmptyTrash ()
	empty Trash and return to folder More...
	askForEmptyTrash ()
	confirmation message for empty trash action More...
	showUser ()
	addSubfolderCommands ($check_uf=false)
	deleteSubfolder ($a_show_confirm=true)
	performDeleteSubFolder ()
	performAddSubFolder ()
	performRenameSubFolder ()
	changeFolder ()
	editFolder ()
	confirmDeleteMails ()
	cancelDeleteMails ()
	deliverFile ()
	applyFilter ()
	resetFilter ()

Data Fields
	$umail = null
	$mbox = null

Private Attributes
	$current_select_cmd
	$current_selected_cmd
	$tpl = null
	$ctrl = null
	$lng = null
	$errorDelete = false

Detailed Description

Author

Jens Conze

Version

$Id$

ilMailFolderGUI: ilMailOptionsGUI, ilMailAttachmentGUI, ilMailSearchGUI ilMailFolderGUI: ilPublicUserProfileGUI

Definition at line 19 of file class.ilMailFolderGUI.php.

Constructor & Destructor Documentation

__construct()

ilMailFolderGUI::__construct

(

)

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

References $_GET, $_POST, $ilCtrl, $ilUser, $lng, and $tpl.

        {
                global $tpl, $ilCtrl, $lng, $ilUser;

                $this->tpl = $tpl;
                $this->ctrl = $ilCtrl;
                $this->lng = $lng;
                
                $this->umail = new ilMail($ilUser->getId());
                $this->mbox = new ilMailBox($ilUser->getId());

                if(isset($_POST['mobj_id']) && (int)$_POST['mobj_id'])
                {
                        $_GET['mobj_id'] = $_POST['mobj_id'];
                }
                // IF THERE IS NO OBJ_ID GIVEN GET THE ID OF MAIL ROOT NODE
                if(!(int)$_GET['mobj_id'])
                {
                        $_GET['mobj_id'] = $this->mbox->getInboxFolder();
                }
                $_GET['mobj_id'] = (int)$_GET['mobj_id'];
                $ilCtrl->saveParameter($this, 'mobj_id');
                $ilCtrl->setParameter($this, 'mobj_id', $_GET['mobj_id']);
                
        }

Member Function Documentation

addSubfolderCommands()

ilMailFolderGUI::addSubfolderCommands

(

$check_uf = false

)

Definition at line 193 of file class.ilMailFolderGUI.php.

References $_GET, $_POST, $ilUser, $si, array, ilSession\get(), ilUtil\sendFailure(), ilTree\setTableNames(), and ilMailGUI\VIEWMODE_SESSION_KEY.

        {
                global $ilToolbar;

                if('tree' != ilSession::get(ilMailGUI::VIEWMODE_SESSION_KEY))
                {
                        $ilToolbar->addSeparator();
                }
                
                $ilToolbar->addButton($this->lng->txt('mail_add_subfolder'), $this->ctrl->getLinkTarget($this, 'addSubFolder'));

                if($check_uf == true)
                {
                        $ilToolbar->addButton($this->lng->txt('rename'), $this->ctrl->getLinkTarget($this, 'renameSubFolder'));
                        $ilToolbar->addButton($this->lng->txt('delete'), $this->ctrl->getLinkTarget($this, 'deleteSubFolder'));
                }
                return true;
        }

Here is the call graph for this function:

applyFilter()

ilMailFolderGUI::applyFilter

(

)

Definition at line 1006 of file class.ilMailFolderGUI.php.

References $_GET.

        {
                $sentFolderId   = $this->mbox->getSentFolder();
                $draftsFolderId = $this->mbox->getDraftsFolder();

                $isTrashFolder = $_GET['mobj_id'] == $this->mbox->getTrashFolder();
                $isSentFolder  = $_GET['mobj_id'] == $sentFolderId;
                $isDraftFolder = $_GET['mobj_id'] == $draftsFolderId;

                $table = new ilMailFolderTableGUI($this, (int)$_GET['mobj_id'], 'showFolder');
                $table->isSentFolder($isSentFolder)
                        ->isDraftFolder($isDraftFolder)
                        ->isTrashFolder($isTrashFolder)
                        ->initFilter();
                $table->resetOffset();
                $table->writeFilterToSession();

                $this->showFolder();
        }

askForEmptyTrash()

ilMailFolderGUI::askForEmptyTrash

(

)

confirmation message for empty trash action

Definition at line 158 of file class.ilMailFolderGUI.php.

References $_GET.

        {
                if($this->umail->countMailsOfFolder((int)$_GET['mobj_id']))
                {       
                        $this->askForConfirmation = true;
                }
                
                $this->showFolder();
                
                return true;
        }

cancelDeleteMails()

ilMailFolderGUI::cancelDeleteMails

(

)

Definition at line 658 of file class.ilMailFolderGUI.php.

References $_GET, $_SESSION, $file, $ilUser, $tpl, ilFrameTargetInfo\_getFrame(), ilObjUser\_lookupPref(), array, ilAccessKey\DELETE, ilDatePresentation\formatDate(), ilAccessKey\FORWARD_MAIL, ilSession\get(), ilUtil\getImagePath(), ilObjectFactory\getInstanceByObjId(), ilUtil\htmlencodePlainString(), IL_CAL_DATETIME, ilUtil\img(), ilAccessKey\REPLY, ilCustomInputGUI\setHtml(), and ilMailGUI\VIEWMODE_SESSION_KEY.

        {
                $this->ctrl->redirect($this);
        }

Here is the call graph for this function:

cancelEmptyTrash()

ilMailFolderGUI::cancelEmptyTrash

(

)

cancel Empty Trash Action and return to folder

Definition at line 140 of file class.ilMailFolderGUI.php.

        {
                $this->showFolder();
        }

changeFolder()

ilMailFolderGUI::changeFolder

(

)

Definition at line 526 of file class.ilMailFolderGUI.php.

References $_GET, array, and ilUtil\sendInfo().

        {
                switch ($this->current_selected_cmd)
                {
                        default:
                                if(!(int)$_GET["mail_id"] || !(int)$this->current_selected_cmd)
                                {
                                        ilUtil::sendInfo($this->lng->txt("mail_move_error"));
                                        return $this->showMail();
                                }

                                if ($this->umail->moveMailsToFolder(array($_GET["mail_id"]), $this->current_selected_cmd))
                                {
                                        ilUtil::sendInfo($this->lng->txt("mail_moved"), true);
                                        $this->ctrl->redirectByClass("ilMailGUI");
                                }
                                else
                                {
                                        ilUtil::sendInfo($this->lng->txt("mail_move_error"));
                                }
                                break;
                }
                
                $this->showMail();
                
                return true;
        }

Here is the call graph for this function:

confirmDeleteMails()

ilMailFolderGUI::confirmDeleteMails

(

)

Definition at line 635 of file class.ilMailFolderGUI.php.

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

        {
                if($this->mbox->getTrashFolder() == $_GET['mobj_id'])
                {
                        $_POST['mail_id'] = $mail_ids = explode(',', $_GET['mail_id']);
                        if(!is_array($mail_ids))
                        {
                                ilUtil::sendInfo($this->lng->txt('mail_select_one'));
                        }
                        else if($this->umail->deleteMails($mail_ids))
                        {
                                $_GET['offset'] = 0;
                                ilUtil::sendInfo($this->lng->txt('mail_deleted'));
                        }
                        else
                        {
                                ilUtil::sendInfo($this->lng->txt('mail_delete_error'));
                        }
                }

                $this->showFolder();
        }

Here is the call graph for this function:

deleteSubfolder()

ilMailFolderGUI::deleteSubfolder

(

$a_show_confirm = true

)

Definition at line 369 of file class.ilMailFolderGUI.php.

        {
                if($a_show_confirm)
                {
                        include_once './Services/Utilities/classes/class.ilConfirmationGUI.php';
                        $oConfirmationGUI = new ilConfirmationGUI();

                        // set confirm/cancel commands
                        $oConfirmationGUI->setFormAction($this->ctrl->getFormAction($this,"showFolder"));
                        $oConfirmationGUI->setHeaderText($this->lng->txt("mail_sure_delete_folder"));
                        $oConfirmationGUI->setCancel($this->lng->txt("cancel"), "showFolder");
                        $oConfirmationGUI->setConfirm($this->lng->txt("confirm"), "performDeleteSubfolder");
                        $this->tpl->setVariable('CONFIRMATION',$oConfirmationGUI->getHTML());

                        return $this->showFolder(true);
                }
                else
                        return $this->showFolder(false);
        }

deliverFile()

ilMailFolderGUI::deliverFile

(

)

Definition at line 963 of file class.ilMailFolderGUI.php.

References $_GET, $_POST, $_SESSION, $file, $filename, $GLOBALS, ilUtil\deliverFile(), and ilUtil\sendInfo().

        {
                if ($_SESSION["mail_id"])
                {
                        $_GET["mail_id"] = $_SESSION["mail_id"];
                }
                $_SESSION["mail_id"] = "";

                $filename = ($_SESSION["filename"]
                                                ? $_SESSION["filename"]
                                                : ($_POST["filename"]
                                                        ? $_POST["filename"]
                                                        : $_GET["filename"]));
                $_SESSION["filename"] = "";

                if ($filename != "")
                {
                        require_once "./Services/Mail/classes/class.ilFileDataMail.php";
                        
                        // secure filename
                        $filename = str_replace("..", "", $filename);
                        
                        $mfile = new ilFileDataMail($GLOBALS['DIC']['ilUser']->getId());
                        if(!is_array($file = $mfile->getAttachmentPathByMD5Filename($filename, $_GET['mail_id'])))
                        {
                                ilUtil::sendInfo($this->lng->txt('mail_error_reading_attachment'));
                                $this->showMail();
                        }
                        else
                        {
                                ilUtil::deliverFile($file['path'], $file['filename']);
                        }
                }
                else
                {
                        ilUtil::sendInfo($this->lng->txt('mail_select_attachment'));
                        $this->showMail();
                }
        }

Here is the call graph for this function:

editFolder()

ilMailFolderGUI::editFolder

(

)

Definition at line 554 of file class.ilMailFolderGUI.php.

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

        {
                switch ($this->current_selected_cmd)
                {
                        case 'markMailsRead':
                                if(is_array($_POST["mail_id"]))
                                {
                                        $this->umail->markRead($_POST["mail_id"]);
                                }
                                else
                                {
                                        ilUtil::sendInfo($this->lng->txt("mail_select_one"));
                                }
                                break;
                        case 'markMailsUnread':
                                if(is_array($_POST["mail_id"]))
                                {
                                        $this->umail->markUnread($_POST["mail_id"]);
                                }
                                else
                                {
                                        ilUtil::sendInfo($this->lng->txt("mail_select_one"));
                                }
                                break;
        
                        case 'deleteMails':
                                // IF MAILBOX IS TRASH ASK TO CONFIRM
                                if($this->mbox->getTrashFolder() == $_GET["mobj_id"])
                                {
                                        if(!is_array($_POST["mail_id"]))
                                        {
                                                ilUtil::sendInfo($this->lng->txt("mail_select_one"));
                                                $this->errorDelete = true;
                                        }
                                } // END IF MAILBOX IS TRASH FOLDER
                                else
                                {
                                        // MOVE MAILS TO TRASH
                                        if(!is_array($_POST["mail_id"]))
                                        {
                                                ilUtil::sendInfo($this->lng->txt("mail_select_one"));
                                        }
                                        else if($this->umail->moveMailsToFolder($_POST["mail_id"], $this->mbox->getTrashFolder()))
                                        {
                                                $_GET["offset"] = 0;
                                                ilUtil::sendInfo($this->lng->txt("mail_moved_to_trash"));
                                        }
                                        else
                                        {
                                                ilUtil::sendInfo($this->lng->txt("mail_move_error"));
                                        }
                                }
                                break;
        
                        case 'add':
                                $this->ctrl->setParameterByClass("ilmailoptionsgui", "cmd", "add");
                                $this->ctrl->redirectByClass("ilmailoptionsgui");
        
                        case 'moveMails':
                        default:
                                if(!is_array($_POST["mail_id"]))
                                {
                                        ilUtil::sendInfo($this->lng->txt("mail_select_one"));
                                }
                                else if($this->umail->moveMailsToFolder($_POST["mail_id"],$this->current_selected_cmd))
                                {
                                        ilUtil::sendInfo($this->lng->txt("mail_moved"));
                                }
                                else
                                {
                                        ilUtil::sendInfo($this->lng->txt("mail_move_error"));
                                }
                                break;
                }
                
                $this->showFolder();
        }

Here is the call graph for this function:

executeCommand()

ilMailFolderGUI::executeCommand

(

)

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

References $_GET, $_POST, $cmd, $ret, and array.

        {
                if ($_POST["select_cmd"])
                {
                        $_GET["cmd"] = 'editFolder';

                        // lower menubar execute-button
                        $this->current_select_cmd = $_POST['select_cmd'];
                        $this->current_selected_cmd = $_POST['selected_cmd'];
                }
                else if ($_POST["select_cmd2"])
                {
                        // upper menubar execute-button
                        $_GET["cmd"] = 'editFolder';
                        $this->current_select_cmd = $_POST['select_cmd2'];
                        $this->current_selected_cmd = $_POST['selected_cmd2'];
                }

                /* Fix: User views mail and wants to delete it... 
                   mjansen: The mail system needs a revision :-)
                */
                if ($_GET['selected_cmd'] == "deleteMails" && $_GET["mail_id"])
                {
                        $_GET["cmd"] = "editFolder";
                        $this->current_selected_cmd = "deleteMails";
                        $_POST["mail_id"] = array($_GET["mail_id"]);
                }
                
                /* Fix: User views mail and wants to move it...
                   mjansen: The mail system needs a revision :-)
                */
                $cmd = $this->ctrl->getCmd();
                if($cmd == 'changeFolder' && 
                   is_numeric($_POST['selected_cmd']) && 
                   $_GET["mail_id"])
                {
                        $this->current_selected_cmd = (int)$_POST['selected_cmd'];
                }               

                $forward_class = $this->ctrl->getNextClass($this);              
                switch($forward_class)
                {
                        case 'ilcontactgui':
                                require_once 'Services/Contact/classes/class.ilContactGUI.php';
                                $this->ctrl->forwardCommand(new ilContactGUI());
                                break;

                        case 'ilmailoptionsgui':
                                include_once 'Services/Mail/classes/class.ilMailOptionsGUI.php';

                                $this->ctrl->forwardCommand(new ilMailOptionsGUI());
                                break;

                        case 'ilpublicuserprofilegui':
                                include_once("Services/User/classes/class.ilPublicUserProfileGUI.php");
                                $this->tpl->setTitle($this->lng->txt("mail"));
                                $this->ctrl->saveParameter($this, "mail_id");
                                $profile_gui = new ilPublicUserProfileGUI($_GET["user"]);
                                $profile_gui->setBackUrl($this->ctrl->getLinkTarget($this, "showMail"));
                                $ret = $this->ctrl->forwardCommand($profile_gui);
                                if ($ret != "")
                                {
                                        $this->tpl->setContent($ret);
                                        $this->tpl->show();
                                }
                                break;

                        default:
                                if (!($cmd = $this->ctrl->getCmd()))
                                {
                                        $cmd = "showFolder";
                                }
                                $this->$cmd();
                                break;
                }
                return true;
        }

performAddSubFolder()

ilMailFolderGUI::performAddSubFolder

(

)

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

References $_GET, $_POST, $_SESSION, $ilCtrl, $tpl, ilSession\get(), ilUtil\sendFailure(), ilUtil\sendInfo(), ilUtil\stripSlashes(), and ilMailGUI\VIEWMODE_SESSION_KEY.

        {               
                if (isset($_POST["subfolder_title"]) && 'tree' == ilSession::get(ilMailGUI::VIEWMODE_SESSION_KEY)) $_SESSION["subfolder_title"] = ilUtil::stripSlashes($_POST['subfolder_title']);

                if (empty($_POST['subfolder_title']))
                {
                        ilUtil::sendInfo($this->lng->txt("mail_insert_folder_name"));
                        return $this->addSubFolder();
                }
                else if ($mobj_id = $this->mbox->addFolder($_GET["mobj_id"], ilUtil::stripSlashes($_POST["subfolder_title"])))
                {                       
                        unset($_SESSION["subfolder_title"]);
                        ilUtil::sendInfo($this->lng->txt("mail_folder_created"), true);         
                        
                        $this->ctrl->setParameterByClass("ilMailGUI", 'mobj_id', $mobj_id);
                        $this->ctrl->redirectByClass("ilMailGUI");
                }
                else
                {
                        ilUtil::sendFailure($this->lng->txt("mail_folder_exists"));
                        $this->addSubFolder();
                        return;
                }
        }

Here is the call graph for this function:

performDeleteSubFolder()

ilMailFolderGUI::performDeleteSubFolder

(

)

Definition at line 389 of file class.ilMailFolderGUI.php.

References $_GET, ilUtil\sendFailure(), and ilUtil\sendInfo().

        {
                $new_parent = $this->mbox->getParentFolderId((int)$_GET['mobj_id']);
                if($this->mbox->deleteFolder((int)$_GET['mobj_id']))
                {
                        ilUtil::sendInfo($this->lng->txt('mail_folder_deleted'), true);
                        $this->ctrl->setParameterByClass('ilMailGUI', 'mobj_id', (int)$new_parent);
                        $this->ctrl->redirectByClass('ilMailGUI');
                }
                else
                {
                        ilUtil::sendFailure($this->lng->txt('mail_error_delete'));
                        $this->showFolder();
                        return;
                }
        }

Here is the call graph for this function:

performEmptyTrash()

ilMailFolderGUI::performEmptyTrash

(

)

empty Trash and return to folder

Definition at line 148 of file class.ilMailFolderGUI.php.

References $_GET, and ilUtil\sendInfo().

        {
                $this->umail->deleteMailsOfFolder($_GET['mobj_id']); 
                ilUtil::sendInfo($this->lng->txt('mail_deleted'));
                $this->showFolder();
        }

Here is the call graph for this function:

performRenameSubFolder()

ilMailFolderGUI::performRenameSubFolder

(

)

Definition at line 496 of file class.ilMailFolderGUI.php.

References $_GET, $_POST, $_SESSION, ilSession\get(), ilUtil\sendFailure(), ilUtil\sendInfo(), ilUtil\stripSlashes(), and ilMailGUI\VIEWMODE_SESSION_KEY.

        {
                if (isset($_POST["subfolder_title"]) && 'tree' == ilSession::get(ilMailGUI::VIEWMODE_SESSION_KEY)) $_SESSION["subfolder_title"] = $_POST['subfolder_title'];

                $tmp_data = $this->mbox->getFolderData($_GET["mobj_id"]);
                if ($tmp_data["title"] != $_POST["subfolder_title"])
                {
                        if ($_POST["subfolder_title"] == "")
                        {
                                ilUtil::sendInfo($this->lng->txt("mail_insert_folder_name"));
                                return $this->renameSubFolder();
                        }
                        else
                        {
                                if ($this->mbox->renameFolder($_GET["mobj_id"], ilUtil::stripSlashes($_POST["subfolder_title"])))
                                {
                                        ilUtil::sendInfo($this->lng->txt("mail_folder_name_changed"), true);
                                        unset($_SESSION["subfolder_title"]);
                                        $this->ctrl->redirectByClass("ilMailGUI");
                                }
                                else
                                {
                                        ilUtil::sendFailure($this->lng->txt("mail_folder_exists"));
                                        return $this->renameSubFolder();
                                }
                        }
                }               
                return $this->showFolder();
        }

Here is the call graph for this function:

resetFilter()

ilMailFolderGUI::resetFilter

(

)

Definition at line 1029 of file class.ilMailFolderGUI.php.

References $_GET.

        {
                $sentFolderId   = $this->mbox->getSentFolder();
                $draftsFolderId = $this->mbox->getDraftsFolder();

                $isTrashFolder = $_GET['mobj_id'] == $this->mbox->getTrashFolder();
                $isSentFolder  = $_GET['mobj_id'] == $sentFolderId;
                $isDraftFolder = $_GET['mobj_id'] == $draftsFolderId;

                $table = new ilMailFolderTableGUI($this, (int)$_GET['mobj_id'], 'showFolder');
                $table->isSentFolder($isSentFolder)
                        ->isDraftFolder($isDraftFolder)
                        ->isTrashFolder($isTrashFolder)
                        ->initFilter();
                $table->resetOffset();
                $table->resetFilter();

                $this->showFolder();
        }

showUser()

ilMailFolderGUI::showUser

(

)

Definition at line 170 of file class.ilMailFolderGUI.php.

References $_GET, $ilCtrl, ilObjUser\_lookupLogin(), and ilUtil\getImagePath().

        {
                global $ilCtrl, $ilToolbar;
                
                $this->ctrl->setParameter($this, "mail_id", $_GET["mail_id"]);
                
                $this->tpl->setTitle($this->lng->txt("mail"));
                //$ilToolbar->addButton($this->lng->txt("back"), $this->ctrl->getLinkTarget($this, "showMail"));
                
                $this->tpl->setVariable("TBL_TITLE", $this->lng->txt("profile_of")." ".
                        ilObjUser::_lookupLogin($_GET["user"]));
                $this->tpl->setVariable("TBL_TITLE_IMG",ilUtil::getImagePath("icon_usr.svg"));
                $this->tpl->setVariable("TBL_TITLE_IMG_ALT", $this->lng->txt("public_profile"));
                
                include_once './Services/User/classes/class.ilPublicUserProfileGUI.php';                
                $profile_gui = new ilPublicUserProfileGUI($_GET["user"]);
                $profile_gui->setBackUrl($this->ctrl->getLinkTarget($this, "showMail"));
                $this->tpl->setContent($ilCtrl->getHTML($profile_gui));
                $this->tpl->show();
                
                return true;
        }       

Here is the call graph for this function:

Field Documentation

$ctrl

ilMailFolderGUI::$ctrl = null

private

Definition at line 25 of file class.ilMailFolderGUI.php.

$current_select_cmd

ilMailFolderGUI::$current_select_cmd

private

Definition at line 21 of file class.ilMailFolderGUI.php.

$current_selected_cmd

ilMailFolderGUI::$current_selected_cmd

private

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

$errorDelete

ilMailFolderGUI::$errorDelete = false

private

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

$lng

ilMailFolderGUI::$lng = null

private

Definition at line 26 of file class.ilMailFolderGUI.php.

Referenced by __construct().

$mbox

ilMailFolderGUI::$mbox = null

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

$tpl

ilMailFolderGUI::$tpl = null

private

Definition at line 24 of file class.ilMailFolderGUI.php.

Referenced by __construct(), cancelDeleteMails(), and performAddSubFolder().

$umail

ilMailFolderGUI::$umail = null

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

---

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

• Services/Mail/classes/class.ilMailFolderGUI.php