class.ilManualPlaceholderInputGUI.php

Go to the documentation of this file.

<?php

declare(strict_types=1);

use ILIAS\HTTP\GlobalHttpState;
use ILIAS\Filesystem\Stream\Streams;

class ilManualPlaceholderInputGUI extends ilSubEnabledFormPropertyGUI
{
    protected GlobalHttpState $httpState;
    protected array $placeholders = [];
    protected string $rerenderUrl = '';
    protected string $rerenderTriggerElementName = '';
    protected string $instructionText = '';
    protected string $adviseText = '';
    protected ilGlobalTemplateInterface $tpl;
    protected $value;

    public function __construct(string $label, string $http_post_param_name, protected string $dependencyElementId)
    {
        global $DIC;

        $this->tpl = $DIC->ui()->mainTemplate();
        $this->httpState = $DIC->http();

        parent::__construct($label, $http_post_param_name);

        $this->tpl->addJavaScript('assets/js/ilMailComposeFunctions.js');
    }

    public function getRerenderUrl(): ?string
    {
        return $this->rerenderUrl;
    }

    public function getRerenderTriggerElementName(): string
    {
        return $this->rerenderTriggerElementName;
    }

    public function supportsRerenderSignal(string $elementId, string $url): void
    {
        $this->rerenderTriggerElementName = $elementId;
        $this->rerenderUrl = $url;
    }

    public function getAdviseText(): string
    {
        return $this->adviseText;
    }

    public function setAdviseText(string $adviseText): void
    {
        $this->adviseText = $adviseText;
    }

    public function getInstructionText(): string
    {
        return $this->instructionText;
    }

    public function setInstructionText(string $instructionText): void
    {
        $this->instructionText = $instructionText;
    }

    public function addPlaceholder(string $placeholder, string $title): void
    {
        $this->placeholders[$placeholder]['placeholder'] = $placeholder;
        $this->placeholders[$placeholder]['title'] = $title;
    }

    public function insert(ilTemplate $a_tpl): void
    {
        $html = $this->render();

        $a_tpl->setCurrentBlock('prop_generic');
        $a_tpl->setVariable('PROP_GENERIC', $html);
        $a_tpl->parseCurrentBlock();
    }

    public function render(bool $ajax = false): string
    {
        $subtpl = new ilTemplate(
            'tpl.mail_manual_placeholders.html',
            true,
            true,
            'components/ILIAS/Mail'
        );
        $subtpl->setVariable('TXT_USE_PLACEHOLDERS', $this->lng->txt('mail_nacc_use_placeholder'));
        $subtpl->setVariable('DEPENDENCY_ELM_ID_OUTER', $this->dependencyElementId);
        if ($this->getAdviseText() !== '') {
            $subtpl->setVariable('TXT_PLACEHOLDERS_ADVISE', $this->getAdviseText());
        }

        foreach ($this->placeholders as $placeholder) {
            $subtpl->setCurrentBlock('man_placeholder');
            $subtpl->setVariable('DEPENDENCY_ELM_ID', $this->dependencyElementId);
            $subtpl->setVariable('PLACEHOLDER', '&lbrace;&lbrace;' . $placeholder['placeholder'] . '&rbrace;&rbrace;');
            $subtpl->setVariable('PLACEHOLDER_INTERACTION_INFO', sprintf(
                $this->lng->txt('mail_hint_add_placeholder_x'),
                '&lbrace;&lbrace;' . $placeholder['placeholder'] . '&rbrace;&rbrace;'
            ));
            $subtpl->setVariable('PLACEHOLDER_DESCRIPTION', $placeholder['title']);
            $subtpl->parseCurrentBlock();
        }

        if (!$ajax && $this->getRerenderTriggerElementName() && $this->getRerenderUrl()) {
            $subtpl->setVariable('RERENDER_URL', $this->getRerenderUrl());
            $subtpl->setVariable('RERENDER_DEPENDENCY_ELM_ID_OUTER', $this->dependencyElementId);
            $subtpl->setVariable('RERENDER_TRIGGER_ELM_NAME', $this->getRerenderTriggerElementName());
        }

        if ($ajax) {
            $this->httpState->saveResponse(
                $this->httpState
                    ->response()
                    ->withBody(Streams::ofString($subtpl->get()))
            );
            $this->httpState->sendResponse();
            $this->httpState->close();
        }

        return $subtpl->get();
    }

    public function setValueByArray(array $a_values): void
    {
        $this->setValue($a_values[$this->getPostVar()] ?? null);
    }

    public function setValue($a_value): void
    {
        if (is_array($a_value) && $this->getMulti()) {
            $this->setMultiValues($a_value);
            $a_value = array_shift($a_value);
        }
        $this->value = $a_value;
    }

    public function checkInput(): bool
    {
        return true;
    }
}