class.ilMailTemplateGUI.php

Go to the documentation of this file.

<?php
/* Copyright (c) 1998-2015 ILIAS open source, Extended GPL, see docs/LICENSE */

require_once 'Services/Form/classes/class.ilPropertyFormGUI.php';
require_once 'Services/Mail/classes/class.ilMailTemplateDataProvider.php';
require_once 'Services/Mail/classes/class.ilMailTemplate.php';
require_once 'Services/Mail/classes/class.ilMailTemplateService.php';
require_once 'Services/Mail/classes/class.ilMailTemplateGenericContext.php';

class ilMailTemplateGUI
{
    protected $form;

    protected $tpl;

    protected $ctrl;

    protected $lng;

    protected $toolbar;

    protected $rbacsystem;

    protected $parentObject;

    protected $error;

    public function __construct(\ilObject $parentObject)
    {
        global $DIC;

        $this->parentObject = $parentObject;

        $this->tpl        = $DIC->ui()->mainTemplate();
        $this->ctrl       = $DIC->ctrl();
        $this->lng        = $DIC->language();
        $this->toolbar    = $DIC->toolbar();
        $this->rbacsystem = $DIC->rbac()->system();
        $this->error      = $DIC['ilErr'];

        $this->lng->loadLanguageModule('meta');

        $this->provider = new ilMailTemplateDataProvider();
    }

    private function isEditingAllowed()
    {
        return $this->rbacsystem->checkAccess('write', $this->parentObject->getRefId());
    }

    public function executeCommand()
    {
        $next_class = $this->ctrl->getNextClass($this);
        $cmd        = $this->ctrl->getCmd();

        switch ($next_class) {
            default:
                if (!$cmd || !method_exists($this, $cmd)) {
                    $cmd = 'showTemplates';
                }

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

    protected function showTemplates()
    {
        require_once 'Services/UIComponent/Button/classes/class.ilLinkButton.php';
        require_once 'Services/Mail/classes/class.ilMailTemplateTableGUI.php';

        $contexts = ilMailTemplateService::getTemplateContexts();
        if (count($contexts) <= 1) {
            ilUtil::sendFailure($this->lng->txt('mail_template_no_context_available'));
        } elseif ($this->isEditingAllowed()) {
            $create_tpl_button = ilLinkButton::getInstance();
            $create_tpl_button->setCaption('mail_new_template');
            $create_tpl_button->setUrl($this->ctrl->getLinkTarget($this, 'showInsertTemplateForm'));
            $this->toolbar->addButtonInstance($create_tpl_button);
        }

        $tbl = new ilMailTemplateTableGUI($this, 'showTemplates', !$this->isEditingAllowed());
        $tbl->setData($this->provider->getTableData());

        $this->tpl->setContent($tbl->getHTML());
    }

    protected function insertTemplate()
    {
        if (!$this->isEditingAllowed()) {
            $this->error->raiseError($this->lng->txt('msg_no_perm_write'), $this->error->WARNING);
        }

        $form = $this->getTemplateForm();

        if (!$form->checkInput()) {
            $form->setValuesByPost();
            $this->showInsertTemplateForm($form);
            return;
        }

        $generic_context = new ilMailTemplateGenericContext();
        if ($form->getInput('context') == $generic_context->getId()) {
            $form->getItemByPostVar('context')->setAlert($this->lng->txt('mail_template_no_valid_context'));
            $form->setValuesByPost();
            $this->showInsertTemplateForm($form);
            return;
        }

        try {
            $context  = ilMailTemplateService::getTemplateContextById($form->getInput('context'));
            $template = new ilMailTemplate();
            $template->setTitle($form->getInput('title'));
            $template->setContext($context->getId());
            $template->setLang($form->getInput('lang'));
            $template->setSubject($form->getInput('m_subject'));
            $template->setMessage($form->getInput('m_message'));
            $template->insert();

            ilUtil::sendSuccess($this->lng->txt('saved_successfully'), true);
            $this->ctrl->redirect($this, 'showTemplates');
        } catch (Exception $e) {
            $form->getItemByPostVar('context')->setAlert($this->lng->txt('mail_template_no_valid_context'));
            ilUtil::sendFailure($this->lng->txt('form_input_not_valid'));
        }

        $form->setValuesByPost();
        $this->showInsertTemplateForm($form);
    }

    protected function showInsertTemplateForm(ilPropertyFormGUI $form = null)
    {
        if (!($form instanceof ilPropertyFormGUI)) {
            $form = $this->getTemplateForm();
        }

        $this->tpl->setContent($form->getHTML());
    }

    protected function updateTemplate()
    {
        if (!$this->isEditingAllowed()) {
            $this->error->raiseError($this->lng->txt('msg_no_perm_write'), $this->error->WARNING);
        }

        if (!isset($_POST['tpl_id']) || !strlen($_POST['tpl_id'])) {
            ilUtil::sendFailure($this->lng->txt('mail_template_missing_id'));
            $this->showTemplates();
            return;
        }

        $template = $this->provider->getTemplateById((int) $_POST['tpl_id']);
        if (!($template instanceof ilMailTemplate)) {
            ilUtil::sendFailure($this->lng->txt('mail_template_missing_id'));
            $this->showTemplates();
            return;
        }

        $form = $this->getTemplateForm();
        if (!$form->checkInput()) {
            $form->setValuesByPost();
            $this->showEditTemplateForm($form);
            return;
        }

        $generic_context = new ilMailTemplateGenericContext();
        if ($form->getInput('context') == $generic_context->getId()) {
            $form->getItemByPostVar('context')->setAlert($this->lng->txt('mail_template_no_valid_context'));
            $form->setValuesByPost();
            $this->showEditTemplateForm($form);
            return;
        }

        try {
            $context = ilMailTemplateService::getTemplateContextById($form->getInput('context'));
            $template->setTitle($form->getInput('title'));
            $template->setContext($context->getId());
            $template->setLang($form->getInput('lang'));
            $template->setSubject($form->getInput('m_subject'));
            $template->setMessage($form->getInput('m_message'));
            $template->update();

            ilUtil::sendSuccess($this->lng->txt('saved_successfully'), true);
            $this->ctrl->redirect($this, 'showTemplates');
        } catch (Exception $e) {
            $form->getItemByPostVar('context')->setAlert($this->lng->txt('mail_template_no_valid_context'));
            ilUtil::sendFailure($this->lng->txt('form_input_not_valid'));
        }

        $form->setValuesByPost();
        $this->showEditTemplateForm($form);
    }

    protected function showEditTemplateForm(ilPropertyFormGUI $form = null)
    {
        if (!($form instanceof ilPropertyFormGUI)) {
            if (!isset($_GET['tpl_id']) || !strlen($_GET['tpl_id'])) {
                ilUtil::sendFailure($this->lng->txt('mail_template_missing_id'));
                $this->showTemplates();
                return;
            }

            $template = $this->provider->getTemplateById((int) $_GET['tpl_id']);
            if (!($template instanceof ilMailTemplate)) {
                ilUtil::sendFailure($this->lng->txt('mail_template_missing_id'));
                $this->showTemplates();
                return;
            }

            $form = $this->getTemplateForm($template);
            $this->populateFormWithTemplate($form, $template);
        }

        $this->tpl->setContent($form->getHTML());
    }

    protected function populateFormWithTemplate(ilPropertyFormGUI $form, ilMailTemplate $template)
    {
        $form->setValuesByArray(array(
            'tpl_id'    => $template->getTplId(),
            'title'     => $template->getTitle(),
            'context'   => $template->getContext(),
            'lang'      => $template->getLang(),
            'm_subject' => $template->getSubject(),
            'm_message' => $template->getMessage()
        ));
    }

    protected function confirmDeleteTemplate()
    {
        if (!$this->isEditingAllowed()) {
            $this->error->raiseError($this->lng->txt('msg_no_perm_write'), $this->error->WARNING);
        }

        if (isset($_POST['tpl_id']) && is_array($_POST['tpl_id']) && count($_POST['tpl_id']) > 0) {
            $tpl_ids = array_filter(array_map('intval', $_POST['tpl_id']));
        } else {
            if (isset($_GET['tpl_id']) && strlen($_GET['tpl_id'])) {
                $tpl_ids = array_filter(array((int) $_GET['tpl_id']));
            } else {
                $tpl_ids = array();
            }
        }

        if (count($tpl_ids) == 0) {
            ilUtil::sendFailure($this->lng->txt('select_one'));
            $this->showTemplates();
            return;
        }

        require_once 'Services/Utilities/classes/class.ilConfirmationGUI.php';
        $confirm = new ilConfirmationGUI();
        $confirm->setFormAction($this->ctrl->getFormAction($this, 'deleteTemplate'));
        $confirm->setHeaderText($this->lng->txt('mail_sure_delete_entry'));
        $confirm->setConfirm($this->lng->txt('confirm'), 'deleteTemplate');
        $confirm->setCancel($this->lng->txt('cancel'), 'showTemplates');

        foreach ($tpl_ids as $tpl_id) {
            $template = $this->provider->getTemplateById((int) $tpl_id);
            $confirm->addItem('tpl_id[]', $tpl_id, $template->getTitle());
        }
        $this->tpl->setContent($confirm->getHTML());
    }

    protected function deleteTemplate()
    {
        if (!$this->isEditingAllowed()) {
            $this->error->raiseError($this->lng->txt('msg_no_perm_write'), $this->error->WARNING);
        }

        if (isset($_POST['tpl_id']) && is_array($_POST['tpl_id']) && count($_POST['tpl_id']) > 0) {
            $tpl_ids = array_filter(array_map('intval', $_POST['tpl_id']));
            if (0 == count($tpl_ids)) {
                ilUtil::sendFailure($this->lng->txt('select_one'));
                $this->showTemplates();
                return;
            }
        } else {
            ilUtil::sendFailure($this->lng->txt('select_one'));
            $this->showTemplates();
            return;
        }

        $this->provider->deleteTemplates($tpl_ids);

        if (1 == count($tpl_ids)) {
            ilUtil::sendSuccess($this->lng->txt('mail_tpl_deleted_s'), true);
        } else {
            ilUtil::sendSuccess($this->lng->txt('mail_tpl_deleted_p'), true);
        }
        $this->ctrl->redirect($this, 'showTemplates');
    }

    public function getAjaxPlaceholdersById()
    {
        $context_id = ilUtil::stripSlashes($_GET['triggerValue']);
        require_once 'Services/Mail/classes/Form/class.ilManualPlaceholderInputGUI.php';
        $placeholders = new ilManualPlaceholderInputGUI('m_message');
        $placeholders->setInstructionText($this->lng->txt('mail_nacc_use_placeholder'));
        $placeholders->setAdviseText(sprintf($this->lng->txt('placeholders_advise'), '<br />'));
        $context = ilMailTemplateService::getTemplateContextById($context_id);
        foreach ($context->getPlaceholders() as $key => $value) {
            $placeholders->addPlaceholder($value['placeholder'], $value['label']);
        }
        $placeholders->render(true);
        exit();
    }

    protected function getTemplateForm(ilMailTemplate $template = null)
    {
        $form = new ilPropertyFormGUI();

        $title = new ilTextInputGUI($this->lng->txt('mail_template_title'), 'title');
        $title->setRequired(true);
        $title->setDisabled(!$this->isEditingAllowed());
        $form->addItem($title);

        $context  = new ilRadioGroupInputGUI($this->lng->txt('mail_template_context'), 'context');
        $context->setDisabled(!$this->isEditingAllowed());
        $contexts = ilMailTemplateService::getTemplateContexts();

        if (count($contexts) <= 1) {
            ilUtil::sendFailure($this->lng->txt('mail_template_no_context_available'), true);
            $this->ctrl->redirect($this, 'showTemplates');
        }

        $context_sort    = array();
        $context_options = array();
        $generic_context = new ilMailTemplateGenericContext();
        foreach ($contexts as $ctx) {
            if ($ctx->getId() != $generic_context->getId()) {
                $context_options[$ctx->getId()] = $ctx;
                $context_sort[$ctx->getId()]    = $ctx->getTitle();
            }
        }
        asort($context_sort);
        $first = null;
        foreach ($context_sort as $id => $title) {
            $ctx    = $context_options[$id];
            $option = new ilRadioOption($ctx->getTitle(), $ctx->getId());
            $option->setInfo($ctx->getDescription());
            $context->addOption($option);

            if (!$first) {
                $first = $id;
            }
        }
        $context->setValue($first);
        $context->setRequired(true);
        $form->addItem($context);

        $hidde_language = new ilHiddenInputGUI('lang');
        $hidde_language->setValue($this->lng->getLangKey());
        $form->addItem($hidde_language);

        $subject = new ilTextInputGUI($this->lng->txt('subject'), 'm_subject');
        $subject->setDisabled(!$this->isEditingAllowed());
        $subject->setRequired(true);
        $subject->setSize(50);
        $form->addItem($subject);

        $message = new ilTextAreaInputGUI($this->lng->txt('message'), 'm_message');
        $message->setDisabled(!$this->isEditingAllowed());
        $message->setRequired(true);
        $message->setCols(60);
        $message->setRows(10);
        $form->addItem($message);

        require_once 'Services/Mail/classes/Form/class.ilManualPlaceholderInputGUI.php';
        $placeholders = new ilManualPlaceholderInputGUI('m_message');
        $placeholders->setDisabled(!$this->isEditingAllowed());
        $placeholders->setInstructionText($this->lng->txt('mail_nacc_use_placeholder'));
        $placeholders->setAdviseText(sprintf($this->lng->txt('placeholders_advise'), '<br />'));
        $placeholders->supportsRerenderSignal(
            'context',
            $this->ctrl->getLinkTarget($this, 'getAjaxPlaceholdersById', '', true, false)
        );
        if ($template === null) {
            $context_id = $generic_context->getId();
        } else {
            $context_id = $template->getContext();
        }
        $context = ilMailTemplateService::getTemplateContextById($context_id);
        foreach ($context->getPlaceholders() as $key => $value) {
            $placeholders->addPlaceholder($value['placeholder'], $value['label']);
        }
        $form->addItem($placeholders);
        if ($template instanceof ilMailTemplate && $template->getTplId() > 0) {
            $id = new ilHiddenInputGUI('tpl_id');
            $form->addItem($id);

            $form->setTitle($this->lng->txt('mail_edit_tpl'));
            $form->setFormAction($this->ctrl->getFormaction($this, 'updateTemplate'));

            if ($this->isEditingAllowed()) {
                $form->addCommandButton('updateTemplate', $this->lng->txt('save'));
            }
        } else {
            $form->setTitle($this->lng->txt('mail_create_tpl'));
            $form->setFormAction($this->ctrl->getFormaction($this, 'insertTemplate'));

            if ($this->isEditingAllowed()) {
                $form->addCommandButton('insertTemplate', $this->lng->txt('save'));
            }
        }

        if ($this->isEditingAllowed()) {
            $form->addCommandButton('showTemplates', $this->lng->txt('cancel'));
        } else {
            $form->addCommandButton('showTemplates', $this->lng->txt('back'));
        }

        return $form;
    }
}