class.ilMailGUI.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
use ILIAS\HTTP\GlobalHttpState;
use ILIAS\Mail\Folder\MailFolderType;
use ILIAS\Refinery\Factory as Refinery;
use ILIAS\Mail\Provider\MailGlobalScreenToolProvider;
 
class ilMailGUI implements ilCtrlBaseClassInterface
{
    private readonly ilGlobalTemplateInterface $tpl;
    private readonly ilCtrlInterface $ctrl;
    private readonly ilLanguage $lng;
    private string $forward_class = '';
    private readonly GlobalHttpState $http;
    private readonly Refinery $refinery;
    private int $current_folder_id = 0;
    private readonly ilObjUser $user;
    public ilMail $umail;
    public ilMailbox $mbox;
 
    public function __construct()
    {
        global $DIC;
        $this->tpl = $DIC->ui()->mainTemplate();
        $this->ctrl = $DIC->ctrl();
        $this->lng = $DIC->language();
        $this->user = $DIC->user();
        $this->http = $DIC->http();
        $this->refinery = $DIC->refinery();
 
        $this->lng->loadLanguageModule('mail');
 
        $this->mbox = new ilMailbox($this->user->getId());
        $this->umail = new ilMail($this->user->getId());
        if (
            !$DIC->rbac()->system()->checkAccess(
                'internal_mail',
                $this->umail->getMailObjectReferenceId()
            )
        ) {
            $DIC['ilErr']->raiseError($this->lng->txt('permission_denied'), $DIC['ilErr']->WARNING);
        }
 
        $this->initFolder();
 
        $tool_context = $DIC->globalScreen()
                           ->tool()
                           ->context()
                           ->current();
 
        $additional_data_exists = $tool_context->getAdditionalData()->exists(
            MailGlobalScreenToolProvider::SHOW_MAIL_FOLDERS_TOOL
        );
        if ($additional_data_exists === false) {
            $tool_context->addAdditionalData(MailGlobalScreenToolProvider::SHOW_MAIL_FOLDERS_TOOL, true);
        }
    }
 
    protected function initFolder(): void
    {
        if ($this->http->wrapper()->post()->has('mobj_id')) {
            $folder_id = $this->http->wrapper()->post()->retrieve('mobj_id', $this->refinery->kindlyTo()->int());
        } elseif ($this->http->wrapper()->query()->has('mobj_id')) {
            $folder_id = $this->http->wrapper()->query()->retrieve('mobj_id', $this->refinery->kindlyTo()->int());
        } else {
            $folder_id = $this->refinery->byTrying([
                $this->refinery->kindlyTo()->int(),
                $this->refinery->always($this->current_folder_id),
            ])->transform(ilSession::get('mobj_id'));
        }
        if ($folder_id === 0 || !$this->mbox->isOwnedFolder($folder_id)) {
            $folder_id = $this->mbox->getInboxFolder();
        }
        $this->current_folder_id = $folder_id;
    }
 
    public function executeCommand(): void
    {
        $type = '';
        if ($this->http->wrapper()->query()->has('type')) {
            $type = $this->http->wrapper()->query()->retrieve('type', $this->refinery->kindlyTo()->string());
        }
        $mail_id = 0;
        if ($this->http->wrapper()->query()->has('mail_id')) {
            $mail_id = $this->http->wrapper()->query()->retrieve('mail_id', $this->refinery->kindlyTo()->int());
        }
 
        $this->ctrl->setParameterByClass(ilMailFormGUI::class, 'mobj_id', $this->current_folder_id);
        $this->ctrl->setParameterByClass(ilMailFolderGUI::class, 'mobj_id', $this->current_folder_id);
 
        if (ilMailFormGUI::MAIL_FORM_TYPE_SEARCH_RESULT === $type) {
            ilMailFormCall::storeReferer($this->http->request()->getQueryParams());
            $this->ctrl->redirectByClass(ilMailFormGUI::class, 'searchResults');
        } elseif (ilMailFormGUI::MAIL_FORM_TYPE_ATTACH === $type) {
            ilMailFormCall::storeReferer($this->http->request()->getQueryParams());
            $this->ctrl->redirectByClass(ilMailFormGUI::class, 'mailAttachment');
        } elseif (ilMailFormGUI::MAIL_FORM_TYPE_NEW === $type) {
            foreach (['to', 'cc', 'bcc'] as $reciepient_type) {
                $key = 'rcp_' . $reciepient_type;
 
                $recipients = '';
                if ($this->http->wrapper()->query()->has($key)) {
                    $recipients = $this->http->wrapper()->query()->retrieve(
                        $key,
                        $this->refinery->kindlyTo()->string()
                    );
                }
 
                ilSession::set($key, ilUtil::stripSlashes($recipients));
 
                if (ilSession::get($key) === '' &&
                    ($recipients = ilMailFormCall::getRecipients($reciepient_type))) {
                    ilSession::set($key, implode(',', $recipients));
                    ilMailFormCall::setRecipients([], $reciepient_type);
                }
            }
            ilMailFormCall::storeReferer($this->http->request()->getQueryParams());
            $this->ctrl->redirectByClass(ilMailFormGUI::class, 'mailUser');
        } elseif (ilMailFormGUI::MAIL_FORM_TYPE_REPLY === $type) {
            $this->ctrl->setParameterByClass(ilMailFormGUI::class, 'mail_id', $mail_id);
            $this->ctrl->redirectByClass(ilMailFormGUI::class, 'replyMail');
        } elseif ($type === 'read') {
            $this->ctrl->setParameterByClass(ilMailFolderGUI::class, 'mail_id', $mail_id);
            $this->ctrl->redirectByClass(ilMailFolderGUI::class, 'showMail');
        } elseif ($type === 'deliverFile') {
            $filename = '';
            if ($this->http->wrapper()->post()->has('filename')) {
                $filename = $this->http->wrapper()->post()->retrieve(
                    'filename',
                    $this->refinery->kindlyTo()->string()
                );
            } elseif ($this->http->wrapper()->query()->has('filename')) {
                $filename = $this->http->wrapper()->query()->retrieve(
                    'filename',
                    $this->refinery->kindlyTo()->string()
                );
            }
 
            ilSession::set('filename', ilUtil::stripSlashes($filename));
            $this->ctrl->setParameterByClass(ilMailFolderGUI::class, 'mail_id', $mail_id);
            $this->ctrl->redirectByClass(ilMailFolderGUI::class, 'deliverFile');
        } elseif ($type === 'message_sent') {
            $this->tpl->setOnScreenMessage('success', $this->lng->txt('mail_message_send'), true);
            $this->ctrl->redirectByClass(ilMailFolderGUI::class);
        } elseif (ilMailFormGUI::MAIL_FORM_TYPE_ROLE === $type) {
            $roles = [];
            if ($this->http->wrapper()->post()->has('roles')) {
                $roles = $this->http->wrapper()->post()->retrieve(
                    'roles',
                    $this->refinery->kindlyTo()->listOf($this->refinery->kindlyTo()->string())
                );
            } elseif ($this->http->wrapper()->query()->has('role')) {
                $roles = [$this->http->wrapper()->query()->retrieve('role', $this->refinery->kindlyTo()->string())];
            }
 
            if ($roles !== []) {
                ilSession::set('mail_roles', $roles);
            }
 
            ilMailFormCall::storeReferer($this->http->request()->getQueryParams());
            $this->ctrl->redirectByClass(ilMailFormGUI::class, 'mailRole');
        }
 
        $view = '';
        if ($this->http->wrapper()->query()->has('view')) {
            $view = $this->http->wrapper()->query()->retrieve('view', $this->refinery->kindlyTo()->string());
        }
        if ($view === 'my_courses') {
            $search_crs = '';
            if ($this->http->wrapper()->query()->has('search_crs')) {
                $search_crs = ilUtil::stripSlashes(
                    $this->http->wrapper()->query()->retrieve('search_crs', $this->refinery->kindlyTo()->string())
                );
            }
            $this->ctrl->setParameter($this, 'search_crs', $search_crs);
            $this->ctrl->redirectByClass(ilMailFormGUI::class, 'searchCoursesTo');
        }
 
        $this->forward_class = (string) $this->ctrl->getNextClass($this);
        $this->showHeader();
 
        switch (strtolower($this->forward_class)) {
            case strtolower(ilMailFormGUI::class):
                $this->ctrl->forwardCommand(new ilMailFormGUI());
                break;
 
            case strtolower(ilMailAttachmentGUI::class):
                $this->tpl->setTitle($this->lng->txt('mail_attachments'));
                $gui = new ilMailAttachmentGUI();
                $gui->manage();
                $this->ctrl->forwardCommand($gui);
                break;
 
            case strtolower(ilMailOptionsGUI::class):
                $this->tpl->setTitle($this->lng->txt('mail_options'));
                $this->ctrl->forwardCommand(new ilMailOptionsGUI());
                break;
 
            case strtolower(ilMailFolderGUI::class):
                $this->ctrl->forwardCommand(new ilMailFolderGUI());
                break;
 
            default:
                if (!($cmd = $this->ctrl->getCmd()) || !method_exists($this, $cmd)) {
                    $cmd = 'setViewMode';
                }
 
                $this->{$cmd}();
                break;
        }
    }
 
    private function setViewMode(): void
    {
        $target_class = ilMailFolderGUI::class;
        if ($this->http->wrapper()->query()->has('target')) {
            $target_class = $this->http->wrapper()->query()->retrieve(
                'target',
                $this->refinery->kindlyTo()->string()
            );
        }
        $type = '';
        if ($this->http->wrapper()->query()->has('type')) {
            $type = $this->http->wrapper()->query()->retrieve('type', $this->refinery->kindlyTo()->string());
        }
        $mail_id = 0;
        if ($this->http->wrapper()->query()->has('mail_id')) {
            $mail_id = $this->http->wrapper()->query()->retrieve('mail_id', $this->refinery->kindlyTo()->int());
        }
 
        $this->ctrl->setParameterByClass($target_class, 'mobj_id', $this->current_folder_id);
 
        if ($type === 'redirect_to_read') {
            $this->ctrl->setParameterByClass(
                ilMailFolderGUI::class,
                'mail_id',
                $mail_id
            );
            $this->ctrl->setParameterByClass(
                ilMailFolderGUI::class,
                'mobj_id',
                $this->current_folder_id
            );
            $this->ctrl->redirectByClass(ilMailFolderGUI::class, 'showMail');
        } elseif ($type === 'add_subfolder') {
            $this->ctrl->redirectByClass($target_class, 'addSubFolder');
        } elseif ($type === 'enter_folderdata') {
            $this->ctrl->redirectByClass($target_class, 'enterFolderData');
        } elseif ($type === 'confirmdelete_folderdata') {
            $this->ctrl->redirectByClass($target_class, 'confirmDeleteFolder');
        } else {
            $this->ctrl->redirectByClass($target_class);
        }
    }
 
    private function showHeader(): void
    {
        global $DIC;
 
        $DIC['ilHelp']->setScreenIdComponent('mail');
 
        $folder = $this->mbox->getFolderData($this->current_folder_id);
        $type = 'mail';
 
 
        if ($folder) {
            switch ($folder->getType()) {
                case MailFolderType::USER:
                    $type = "local";
                    break;
 
                default:
                    switch (strtolower($this->ctrl->getCmdClass() ?? '')) {
                        case strtolower(ilMailFormGUI::class):
                            $type = 'mail';
                            break;
 
                        case strtolower(ilMailOptionsGUI::class):
                            $type = 'adm';
                            break;
 
                        case strtolower(ilMailAttachmentGUI::class):
                            $type = 'fils';
                            break;
 
                        default:
                            $type = $folder->getType()->value;
                            break;
                    }
                    break;
            }
        }
 
        $this->tpl->setTitleIcon(ilUtil::getImagePath("standard/icon_$type.svg"));
    }
}