@ilCtrl_isCalledBy ilMailTemplateGUI: ilObjMailGUI More...

Inheritance diagram for ilMailTemplateGUI:

Collaboration diagram for ilMailTemplateGUI:

Public Member Functions
	__construct (protected ilObject $parent_object, ?ilGlobalTemplateInterface $tpl=null, ?ilCtrlInterface $ctrl=null, ?ilLanguage $lng=null, ?ilToolbarGUI $toolbar=null, ?ilRbacSystem $rbacsystem=null, ?ilErrorHandling $error=null, ?GlobalHttpState $http=null, ?Factory $ui_factory=null, ?Renderer $ui_renderer=null, ?ilMailTemplateService $template_service=null)

	getUnsafeGetCommands ()
	This method must return a list of unsafe GET commands. More...

	getSafePostCommands ()
	This method must return a list of safe POST commands. More...

	executeCommand ()

	unsetAsContextDefault ()

	getUnsafeGetCommands ()
	This method must return a list of unsafe GET commands. More...

	getSafePostCommands ()
	This method must return a list of safe POST commands. More...

Protected Member Functions
	deleteTemplateCommand ()

Protected Attributes
ilPropertyFormGUI	$form

ilGlobalTemplateInterface	$tpl

ilCtrlInterface	$ctrl

ilLanguage	$lng

ilToolbarGUI	$toolbar

ilRbacSystem	$rbacsystem

ilErrorHandling	$error

ilMailTemplateService	$service

GlobalHttpState	$http

Refinery	$refinery

Factory	$ui_factory

Renderer	$ui_renderer

Private Member Functions
	isEditingAllowed ()

	executeTableActionCommand ()

	showTemplatesCommand ()

	insertTemplateCommand ()

	showInsertTemplateFormCommand (?ilPropertyFormGUI $form=null)

	updateTemplateCommand ()

	showEditTemplateForm (?ilPropertyFormGUI $form=null)

	populateFormWithTemplate (ilPropertyFormGUI $form, ilMailTemplate $template)

	confirmDeleteTemplate ()

	getAjaxPlaceholdersByIdCommand ()

	getTemplateForm (?ilMailTemplate $template=null)

	setAsContextDefault ()

Detailed Description

@ilCtrl_isCalledBy ilMailTemplateGUI: ilObjMailGUI

Definition at line 30 of file class.ilMailTemplateGUI.php.

Constructor & Destructor Documentation

◆ __construct()

ilMailTemplateGUI::__construct	(	protected ilObject	$parent_object,
		?ilGlobalTemplateInterface	$tpl = `null`,
		?ilCtrlInterface	$ctrl = `null`,
		?ilLanguage	$lng = `null`,
		?ilToolbarGUI	$toolbar = `null`,
		?ilRbacSystem	$rbacsystem = `null`,
		?ilErrorHandling	$error = `null`,
		?GlobalHttpState	$http = `null`,
		?Factory	$ui_factory = `null`,
		?Renderer	$ui_renderer = `null`,
		?ilMailTemplateService	$template_service = `null`
	)

Definition at line 45 of file class.ilMailTemplateGUI.php.

      {
        global $DIC;
        $this->tpl = $tpl ?? $DIC->ui()->mainTemplate();
        $this->ctrl = $ctrl ?? $DIC->ctrl();
        $this->lng = $lng ?? $DIC->language();
        $this->toolbar = $toolbar ?? $DIC->toolbar();
        $this->rbacsystem = $rbacsystem ?? $DIC->rbac()->system();
        $this->error = $error ?? $DIC['ilErr'];
        $this->http = $http ?? $DIC->http();
        $this->refinery = $DIC->refinery();
        $this->ui_factory = $ui_factory ?? $DIC->ui()->factory();
        $this->ui_renderer = $ui_renderer ?? $DIC->ui()->renderer();
        $this->service = $template_service ?? $DIC->mail()->textTemplates();
 
        $this->lng->loadLanguageModule('meta');
    }

References $DIC, $rbacsystem, $tpl, $ui_factory, $ui_renderer, ILIAS\Repository\ctrl(), error(), ILIAS\FileDelivery\http(), ILIAS\Repository\lng(), ILIAS\Repository\refinery(), and ILIAS\Repository\toolbar().

Here is the call graph for this function:

Member Function Documentation

◆ confirmDeleteTemplate()

ilMailTemplateGUI::confirmDeleteTemplate ( )

private

Definition at line 350 of file class.ilMailTemplateGUI.php.

                                            : void
    {
        if (!$this->isEditingAllowed()) {
            $this->error->raiseError($this->lng->txt('msg_no_perm_write'), $this->error->WARNING);
        }
 
        $template_ids = [];
        if ($this->http->wrapper()->query()->has('mail_template_tpl_ids')) {
            $template_ids = $this->http->wrapper()->query()->retrieve(
                'mail_template_tpl_ids',
                $this->refinery->kindlyTo()->listOf($this->refinery->kindlyTo()->string())
            );
            if ($template_ids === ['ALL_OBJECTS']) {
                $template_ids = array_map(
                    static fn(array $template): int => (int) ($template['tpl_id'] ?? 0),
                    $this->service->listAllTemplatesAsArray()
                );
            } else {
                $template_ids = $this->refinery->kindlyTo()->listOf($this->refinery->kindlyTo()->int())
                                               ->transform($template_ids);
            }
        }
 
        if (count($template_ids) === 0) {
            $this->tpl->setOnScreenMessage($this->tpl::MESSAGE_TYPE_FAILURE, $this->lng->txt('select_one'));
            $this->showTemplatesCommand();
            return;
        }
 
        $confirm = new ilConfirmationGUI();
        $confirm->setFormAction($this->ctrl->getFormAction($this, 'deleteTemplate'));
 
        $confirm->setHeaderText($this->lng->txt('mail_tpl_sure_delete_entries'));
        if (count($template_ids) === 1) {
            $confirm->setHeaderText($this->lng->txt('mail_tpl_sure_delete_entry'));
        }
 
        $confirm->setConfirm($this->lng->txt('confirm'), 'deleteTemplate');
        $confirm->setCancel($this->lng->txt('cancel'), 'showTemplates');
 
        foreach ($template_ids as $template_id) {
            $template = $this->service->loadTemplateForId($template_id);
            $confirm->addItem('tpl_id[]', (string) $template_id, $template->getTitle());
        }
 
        $this->tpl->setContent($confirm->getHTML());
    }

References ILIAS\Repository\ctrl(), error(), ILIAS\FileDelivery\http(), isEditingAllowed(), ILIAS\Repository\lng(), ILIAS\Repository\refinery(), and showTemplatesCommand().

Referenced by executeTableActionCommand().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ deleteTemplateCommand()

ilMailTemplateGUI::deleteTemplateCommand ( )

protected

Definition at line 398 of file class.ilMailTemplateGUI.php.

                                              : void
    {
        if (!$this->isEditingAllowed()) {
            $this->error->raiseError($this->lng->txt('msg_no_perm_write'), $this->error->WARNING);
        }
 
        $template_ids = [];
        if ($this->http->wrapper()->post()->has('tpl_id')) {
            $template_ids = $this->http->wrapper()->post()->retrieve(
                'tpl_id',
                $this->refinery->kindlyTo()->listOf($this->refinery->kindlyTo()->int())
            );
        }
        if (count($template_ids) === 0) {
            $template_id = 0;
            if ($this->http->wrapper()->query()->has('tpl_id')) {
                $template_id = $this->http->wrapper()->query()->retrieve('tpl_id', $this->refinery->kindlyTo()->int());
            }
            $template_ids = [$template_id];
        }
 
        if (count($template_ids) === 0) {
            $this->tpl->setOnScreenMessage($this->tpl::MESSAGE_TYPE_FAILURE, $this->lng->txt('select_one'));
            $this->showTemplatesCommand();
            return;
        }
 
        $this->service->deleteTemplatesByIds($template_ids);
 
        if (count($template_ids) === 1) {
            $this->tpl->setOnScreenMessage(
                $this->tpl::MESSAGE_TYPE_SUCCESS,
                $this->lng->txt('mail_tpl_deleted_s'),
                true
            );
        } else {
            $this->tpl->setOnScreenMessage(
                $this->tpl::MESSAGE_TYPE_SUCCESS,
                $this->lng->txt('mail_tpl_deleted_p'),
                true
            );
        }
        $this->ctrl->redirect($this, 'showTemplates');
    }

References ILIAS\Repository\ctrl(), error(), ILIAS\FileDelivery\http(), isEditingAllowed(), ILIAS\Repository\lng(), ILIAS\Repository\refinery(), and showTemplatesCommand().

Here is the call graph for this function:

◆ executeCommand()

ilMailTemplateGUI::executeCommand ( )

Definition at line 91 of file class.ilMailTemplateGUI.php.

                                    : void
    {
        $cmd = $this->ctrl->getCmd();
        if (!$cmd || !method_exists($this, $cmd . 'Command')) {
            $cmd = 'showTemplates';
        }
        $verified_command = $cmd . 'Command';
 
        $this->$verified_command();
    }

References ILIAS\Repository\ctrl().

Here is the call graph for this function:

◆ executeTableActionCommand()

ilMailTemplateGUI::executeTableActionCommand ( )

private

Definition at line 102 of file class.ilMailTemplateGUI.php.

                                                : void
    {
        $action = $this->http->wrapper()->query()->retrieve(
            'mail_template_table_action',
            $this->refinery->kindlyTo()->string()
        );
 
        match ($action) {
            'showEditTemplateForm' => $this->showEditTemplateForm(),
            'confirmDeleteTemplate' => $this->confirmDeleteTemplate(),
            'unsetAsContextDefault' => $this->unsetAsContextDefault(),
            'setAsContextDefault' => $this->setAsContextDefault(),
            default => $this->ctrl->redirect($this, 'showTemplates'),
        };
    }

References confirmDeleteTemplate(), ILIAS\Repository\ctrl(), ILIAS\FileDelivery\http(), ILIAS\Repository\refinery(), setAsContextDefault(), showEditTemplateForm(), and unsetAsContextDefault().

Here is the call graph for this function:

◆ getAjaxPlaceholdersByIdCommand()

ilMailTemplateGUI::getAjaxPlaceholdersByIdCommand ( )

private

Definition at line 443 of file class.ilMailTemplateGUI.php.

                                                     : void
    {
        $trigger_value = '';
        if ($this->http->wrapper()->query()->has('triggerValue')) {
            $trigger_value = $this->http->wrapper()->query()->retrieve(
                'triggerValue',
                $this->refinery->kindlyTo()->string()
            );
        }
        $context_id = ilUtil::stripSlashes($trigger_value);
 
        $placeholders = new ilManualPlaceholderInputGUI(
            $this->lng->txt('mail_form_placeholders_label'),
            'm_placeholders',
            'm_message'
        );
        $placeholders->setInstructionText($this->lng->txt('mail_nacc_use_placeholder'));
        try {
            $placeholders->setAdviseText(sprintf($this->lng->txt('placeholders_advise'), '<br />'));
        } catch (Throwable) {
            $placeholders->setAdviseText($this->lng->txt('placeholders_advise'));
        }
 
        $context = ilMailTemplateContextService::getTemplateContextById($context_id);
        foreach ($context->getPlaceholders() as $value) {
            $placeholders->addPlaceholder($value['placeholder'], $value['label']);
        }
 
        $placeholders->render(true);
    }

References $context, ilMailTemplateContextService\getTemplateContextById(), ILIAS\FileDelivery\http(), ILIAS\Repository\lng(), ILIAS\Repository\refinery(), and ilUtil\stripSlashes().

Here is the call graph for this function:

◆ getSafePostCommands()

ilMailTemplateGUI::getSafePostCommands ( )

This method must return a list of safe POST commands.

Safe post commands returned by this method will no longer be CSRF protected and will NOT be appended by an ilCtrlToken.

Returns: string[]

Implements ilCtrlSecurityInterface.

Definition at line 86 of file class.ilMailTemplateGUI.php.

                                         : array
    {
        return [];
    }

◆ getTemplateForm()

ilMailTemplateGUI::getTemplateForm ( ?ilMailTemplate $template = null )

private

Definition at line 474 of file class.ilMailTemplateGUI.php.

                                                                      : ilPropertyFormGUI
    {
        $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 = ilMailTemplateContextService::getTemplateContexts();
 
        if (count($contexts) <= 1) {
            $this->tpl->setOnScreenMessage(
                $this->tpl::MESSAGE_TYPE_FAILURE,
                $this->lng->txt('mail_template_no_context_available'),
                true
            );
            $this->ctrl->redirect($this, 'showTemplates');
        }
 
        $context_sort = [];
        $context_options = [];
        $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 (array_keys($context_sort) as $id) {
            $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);
 
        $hidden = new ilHiddenInputGUI('lang');
        $hidden->setValue($this->lng->getLangKey());
        $form->addItem($hidden);
 
        $subject = new ilTextInputGUI($this->lng->txt('subject'), 'm_subject');
        $subject->setDisabled(!$this->isEditingAllowed());
        $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);
 
        $placeholders = new ilManualPlaceholderInputGUI(
            $this->lng->txt('mail_form_placeholders_label'),
            'm_placeholders',
            'm_message'
        );
        $placeholders->setDisabled(!$this->isEditingAllowed());
        $placeholders->setInstructionText($this->lng->txt('mail_nacc_use_placeholder'));
        try {
            $placeholders->setAdviseText(sprintf($this->lng->txt('placeholders_advise'), '<br />'));
        } catch (Throwable) {
            $placeholders->setAdviseText($this->lng->txt('placeholders_advise'));
        }
        $placeholders->supportsRerenderSignal(
            'context',
            $this->ctrl->getLinkTarget($this, 'getAjaxPlaceholdersById', '', true)
        );
        if ($template === null) {
            $context_id = $generic_context->getId();
        } else {
            $context_id = $template->getContext();
        }
        $context = ilMailTemplateContextService::getTemplateContextById($context_id);
        foreach ($context->getPlaceholders() as $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;
    }

References $context, $form, $id, $message, ilPropertyFormGUI\addCommandButton(), ilPropertyFormGUI\addItem(), ILIAS\Repository\ctrl(), ilMailTemplateContextService\getTemplateContextById(), ilMailTemplateContextService\getTemplateContexts(), ilMailTemplate\getTplId(), isEditingAllowed(), ILIAS\Repository\lng(), ilFormGUI\setFormAction(), and ilPropertyFormGUI\setTitle().

Referenced by insertTemplateCommand(), showEditTemplateForm(), showInsertTemplateFormCommand(), and updateTemplateCommand().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getUnsafeGetCommands()

ilMailTemplateGUI::getUnsafeGetCommands ( )

This method must return a list of unsafe GET commands.

Unsafe get commands returned by this method will now be CSRF protected, which means an ilCtrlToken is appended each time a link-target is generated to the class implementing this interface with a command from that list.

Tokens will be validated in

See also: ilCtrlInterface::getCmd(), whereas the fallback command will be used if the CSRF validation fails.

Returns: string[]

Implements ilCtrlSecurityInterface.

Definition at line 79 of file class.ilMailTemplateGUI.php.

                                          : array
    {
        return [
            'executeTableAction',
        ];
    }

◆ insertTemplateCommand()

ilMailTemplateGUI::insertTemplateCommand ( )

private

Definition at line 152 of file class.ilMailTemplateGUI.php.

                                            : void
    {
        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->showInsertTemplateFormCommand($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->showInsertTemplateFormCommand($form);
            return;
        }
 
        try {
            $this->service->createNewTemplate(
                ilMailTemplateContextService::getTemplateContextById($form->getInput('context'))->getId(),
                $form->getInput('title'),
                $form->getInput('m_subject'),
                $form->getInput('m_message'),
                $form->getInput('lang')
            );
 
            $this->tpl->setOnScreenMessage(
                $this->tpl::MESSAGE_TYPE_SUCCESS,
                $this->lng->txt('saved_successfully'),
                true
            );
            $this->ctrl->redirect($this, 'showTemplates');
        } catch (\ILIAS\Mail\Templates\TemplateSubjectSyntaxException) {
            $form->getItemByPostVar('m_subject')->setAlert($this->lng->txt('mail_template_invalid_tpl_syntax'));
            $this->tpl->setOnScreenMessage($this->tpl::MESSAGE_TYPE_FAILURE, $this->lng->txt('form_input_not_valid'));
        } catch (\ILIAS\Mail\Templates\TemplateMessageSyntaxException) {
            $form->getItemByPostVar('m_message')->setAlert($this->lng->txt('mail_template_invalid_tpl_syntax'));
            $this->tpl->setOnScreenMessage($this->tpl::MESSAGE_TYPE_FAILURE, $this->lng->txt('form_input_not_valid'));
        } catch (Exception) {
            $form->getItemByPostVar('context')->setAlert(
                $this->lng->txt('mail_template_no_valid_context')
            );
            $this->tpl->setOnScreenMessage($this->tpl::MESSAGE_TYPE_FAILURE, $this->lng->txt('form_input_not_valid'));
        }
 
        $form->setValuesByPost();
        $this->showInsertTemplateFormCommand($form);
    }

References $form, ilPropertyFormGUI\checkInput(), ILIAS\Repository\ctrl(), error(), ilPropertyFormGUI\getInput(), ilPropertyFormGUI\getItemByPostVar(), ilMailTemplateContextService\getTemplateContextById(), getTemplateForm(), isEditingAllowed(), ILIAS\Repository\lng(), ilPropertyFormGUI\setValuesByPost(), and showInsertTemplateFormCommand().

Here is the call graph for this function:

◆ isEditingAllowed()

ilMailTemplateGUI::isEditingAllowed ( )

private

Definition at line 74 of file class.ilMailTemplateGUI.php.

                                       : bool
    {
        return $this->rbacsystem->checkAccess('write', $this->parent_object->getRefId());
    }

Referenced by confirmDeleteTemplate(), deleteTemplateCommand(), getTemplateForm(), insertTemplateCommand(), setAsContextDefault(), showTemplatesCommand(), unsetAsContextDefault(), and updateTemplateCommand().

Here is the caller graph for this function:

◆ populateFormWithTemplate()

ilMailTemplateGUI::populateFormWithTemplate	(	ilPropertyFormGUI	$form,
		ilMailTemplate	$template
	)

private

Definition at line 338 of file class.ilMailTemplateGUI.php.

                                                                                                : void
    {
        $form->setValuesByArray([
            'tpl_id' => $template->getTplId(),
            'title' => $template->getTitle(),
            'context' => $template->getContext(),
            'lang' => $template->getLang(),
            'm_subject' => $template->getSubject(),
            'm_message' => $template->getMessage(),
        ]);
    }

References $form, ilMailTemplate\getContext(), ilMailTemplate\getLang(), ilMailTemplate\getMessage(), ilMailTemplate\getSubject(), ilMailTemplate\getTitle(), ilMailTemplate\getTplId(), and ilPropertyFormGUI\setValuesByArray().

Referenced by showEditTemplateForm().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setAsContextDefault()

ilMailTemplateGUI::setAsContextDefault ( )

private

Definition at line 630 of file class.ilMailTemplateGUI.php.

                                          : void
    {
        if (!$this->isEditingAllowed()) {
            $this->error->raiseError($this->lng->txt('msg_no_perm_write'), $this->error->WARNING);
        }
 
        $template_id = 0;
        if ($this->http->wrapper()->query()->has('mail_template_tpl_ids')) {
            $template_id = $this->http->wrapper()->query()->retrieve(
                'mail_template_tpl_ids',
                $this->refinery->kindlyTo()->listOf($this->refinery->kindlyTo()->int())
            )[0];
        }
 
        if (!is_numeric($template_id) || $template_id < 1) {
            $this->tpl->setOnScreenMessage(
                $this->tpl::MESSAGE_TYPE_FAILURE,
                $this->lng->txt('mail_template_missing_id')
            );
            $this->showTemplatesCommand();
            return;
        }
 
        try {
            $template = $this->service->loadTemplateForId((int) $template_id);
            $this->service->setAsContextDefault($template);
        } catch (Exception) {
            $this->tpl->setOnScreenMessage(
                $this->tpl::MESSAGE_TYPE_FAILURE,
                $this->lng->txt('mail_template_missing_id')
            );
            $this->showTemplatesCommand();
            return;
        }
 
        $this->tpl->setOnScreenMessage($this->tpl::MESSAGE_TYPE_SUCCESS, $this->lng->txt('saved_successfully'), true);
        $this->ctrl->redirect($this, 'showTemplates');
    }

References ILIAS\Repository\ctrl(), error(), ILIAS\FileDelivery\http(), isEditingAllowed(), ILIAS\Repository\lng(), ILIAS\Repository\refinery(), and showTemplatesCommand().

Referenced by executeTableActionCommand().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ showEditTemplateForm()

ilMailTemplateGUI::showEditTemplateForm ( ?ilPropertyFormGUI $form = null )

private

Definition at line 301 of file class.ilMailTemplateGUI.php.

                                                                          : void
    {
        if (!($form instanceof ilPropertyFormGUI)) {
            $template_id = 0;
            if ($this->http->wrapper()->query()->has('mail_template_tpl_ids')) {
                $template_id = $this->http->wrapper()->query()->retrieve(
                    'mail_template_tpl_ids',
                    $this->refinery->kindlyTo()->listOf($this->refinery->kindlyTo()->int())
                )[0];
            }
 
            if (!is_numeric($template_id) || $template_id < 1) {
                $this->tpl->setOnScreenMessage(
                    $this->tpl::MESSAGE_TYPE_FAILURE,
                    $this->lng->txt('mail_template_missing_id')
                );
                $this->showTemplatesCommand();
                return;
            }
 
            try {
                $template = $this->service->loadTemplateForId((int) $template_id);
                $form = $this->getTemplateForm($template);
                $this->populateFormWithTemplate($form, $template);
            } catch (Exception) {
                $this->tpl->setOnScreenMessage(
                    $this->tpl::MESSAGE_TYPE_FAILURE,
                    $this->lng->txt('mail_template_missing_id')
                );
                $this->showTemplatesCommand();
                return;
            }
        }
 
        $this->tpl->setContent($form->getHTML());
    }

References $form, ilPropertyFormGUI\getHTML(), getTemplateForm(), ILIAS\FileDelivery\http(), ILIAS\Repository\lng(), populateFormWithTemplate(), ILIAS\Repository\refinery(), and showTemplatesCommand().

Referenced by executeTableActionCommand(), and updateTemplateCommand().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ showInsertTemplateFormCommand()

ilMailTemplateGUI::showInsertTemplateFormCommand ( ?ilPropertyFormGUI $form = null )

private

Definition at line 208 of file class.ilMailTemplateGUI.php.

                                                                                   : void
    {
        if (!($form instanceof ilPropertyFormGUI)) {
            $form = $this->getTemplateForm();
        }
 
        $this->tpl->setContent($form->getHTML());
    }

References $form, ilPropertyFormGUI\getHTML(), and getTemplateForm().

Referenced by insertTemplateCommand().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ showTemplatesCommand()

ilMailTemplateGUI::showTemplatesCommand ( )

private

Definition at line 118 of file class.ilMailTemplateGUI.php.

                                           : void
    {
        $contexts = ilMailTemplateContextService::getTemplateContexts();
        if (count($contexts) <= 1) {
            $this->tpl->setOnScreenMessage(
                $this->tpl::MESSAGE_TYPE_FAILURE,
                $this->lng->txt('mail_template_no_context_available')
            );
        } elseif ($this->isEditingAllowed()) {
            $this->toolbar->addComponent(
                $this->ui_factory->button()->standard(
                    $this->lng->txt('mail_new_template'),
                    $this->ctrl->getLinkTarget($this, 'showInsertTemplateForm')
                )
            );
        }
 
        $table_uri = (new DataFactory())->uri(
            ILIAS_HTTP_PATH . '/'
            . $this->ctrl->getLinkTarget($this, 'executeTableAction')
        );
 
        $tbl = new ilMailTemplateTable(
            $this->http->request(),
            $this->lng,
            $this->ui_factory,
            $table_uri,
            $this->service,
            !$this->isEditingAllowed()
        );
 
        $this->tpl->setContent($this->ui_renderer->render($tbl->getComponent()));
    }

References ILIAS\Repository\ctrl(), ilMailTemplateContextService\getTemplateContexts(), ILIAS\FileDelivery\http(), isEditingAllowed(), ILIAS\Repository\lng(), and ILIAS\Repository\toolbar().

Referenced by confirmDeleteTemplate(), deleteTemplateCommand(), setAsContextDefault(), showEditTemplateForm(), unsetAsContextDefault(), and updateTemplateCommand().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ unsetAsContextDefault()

ilMailTemplateGUI::unsetAsContextDefault ( )

Definition at line 591 of file class.ilMailTemplateGUI.php.

                                           : void
    {
        if (!$this->isEditingAllowed()) {
            $this->error->raiseError($this->lng->txt('msg_no_perm_write'), $this->error->WARNING);
        }
 
        $template_id = 0;
        if ($this->http->wrapper()->query()->has('mail_template_tpl_ids')) {
            $template_id = $this->http->wrapper()->query()->retrieve(
                'mail_template_tpl_ids',
                $this->refinery->kindlyTo()->listOf($this->refinery->kindlyTo()->int())
            )[0];
        }
 
        if (!is_numeric($template_id) || $template_id < 1) {
            $this->tpl->setOnScreenMessage(
                $this->tpl::MESSAGE_TYPE_FAILURE,
                $this->lng->txt('mail_template_missing_id')
            );
            $this->showTemplatesCommand();
            return;
        }
 
        try {
            $template = $this->service->loadTemplateForId((int) $template_id);
            $this->service->unsetAsContextDefault($template);
        } catch (Exception) {
            $this->tpl->setOnScreenMessage(
                $this->tpl::MESSAGE_TYPE_FAILURE,
                $this->lng->txt('mail_template_missing_id')
            );
            $this->showTemplatesCommand();
            return;
        }
 
        $this->tpl->setOnScreenMessage($this->tpl::MESSAGE_TYPE_SUCCESS, $this->lng->txt('saved_successfully'), true);
        $this->ctrl->redirect($this, 'showTemplates');
    }

References ILIAS\Repository\ctrl(), error(), ILIAS\FileDelivery\http(), isEditingAllowed(), ILIAS\Repository\lng(), ILIAS\Repository\refinery(), and showTemplatesCommand().

Referenced by executeTableActionCommand().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ updateTemplateCommand()

ilMailTemplateGUI::updateTemplateCommand ( )

private

Definition at line 217 of file class.ilMailTemplateGUI.php.

                                            : void
    {
        if (!$this->isEditingAllowed()) {
            $this->error->raiseError($this->lng->txt('msg_no_perm_write'), $this->error->WARNING);
        }
 
        $template_id = 0;
        if ($this->http->wrapper()->post()->has('tpl_id')) {
            $template_id = $this->http->wrapper()->post()->retrieve('tpl_id', $this->refinery->kindlyTo()->int());
        }
 
        if (!is_numeric($template_id) || $template_id < 1) {
            $this->tpl->setOnScreenMessage(
                $this->tpl::MESSAGE_TYPE_FAILURE,
                $this->lng->txt('mail_template_missing_id')
            );
            $this->showTemplatesCommand();
            return;
        }
 
        try {
            $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 {
                $this->service->modifyExistingTemplate(
                    (int) $template_id,
                    ilMailTemplateContextService::getTemplateContextById($form->getInput('context'))->getId(),
                    $form->getInput('title'),
                    $form->getInput('m_subject'),
                    $form->getInput('m_message'),
                    $form->getInput('lang')
                );
 
                $this->tpl->setOnScreenMessage(
                    $this->tpl::MESSAGE_TYPE_SUCCESS,
                    $this->lng->txt('saved_successfully'),
                    true
                );
                $this->ctrl->redirect($this, 'showTemplates');
            } catch (OutOfBoundsException) {
                $this->tpl->setOnScreenMessage(
                    $this->tpl::MESSAGE_TYPE_FAILURE,
                    $this->lng->txt('mail_template_missing_id')
                );
            } catch (\ILIAS\Mail\Templates\TemplateSubjectSyntaxException) {
                $form->getItemByPostVar('m_subject')->setAlert($this->lng->txt('mail_template_invalid_tpl_syntax'));
            } catch (\ILIAS\Mail\Templates\TemplateMessageSyntaxException) {
                $form->getItemByPostVar('m_message')->setAlert($this->lng->txt('mail_template_invalid_tpl_syntax'));
            } catch (Exception) {
                $form->getItemByPostVar('context')->setAlert(
                    $this->lng->txt('mail_template_no_valid_context')
                );
                $this->tpl->setOnScreenMessage(
                    $this->tpl::MESSAGE_TYPE_FAILURE,
                    $this->lng->txt('form_input_not_valid')
                );
            }
 
            $form->setValuesByPost();
            $this->showEditTemplateForm($form);
        } catch (Exception) {
            $this->tpl->setOnScreenMessage(
                $this->tpl::MESSAGE_TYPE_FAILURE,
                $this->lng->txt('mail_template_missing_id')
            );
            $this->showTemplatesCommand();
        }
    }