class.ilTestInfoScreenToolbarGUI.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
use ILIAS\Test\Settings\MainSettings\SettingsMainGUI;
 
use ILIAS\UI\Factory as UIFactory;
use ILIAS\UI\Renderer as UIRenderer;
 
class ilTestInfoScreenToolbarGUI extends ilToolbarGUI
{
    private static array $TARGET_CLASS_PATH_BASE = ['ilRepositoryGUI', 'ilObjTestGUI'];
 
    protected ?ilTestQuestionSetConfig $testQuestionSetConfig = null;
    protected ?ilTestSession $testSession = null;
 
    protected $testSequence;
 
    private string $sessionLockString = '';
    private array $infoMessages = [];
    private array $failureMessages = [];
 
    public function __construct(
        private ilObjTest $test_obj,
        private ilTestPlayerAbstractGUI $test_player_gui,
        private ilTestQuestionSetConfig $test_question_set_config,
        private ilTestSession $test_session,
        private ilDBInterface $db,
        private ilAccessHandler $access,
        private ilCtrlInterface $ctrl,
        protected ilLanguage $lng,
        private UIFactory $ui_factory,
        private UIRenderer $ui_renderer,
        private ilGlobalTemplateInterface $main_tpl,
        private ilToolbarGUI $global_toolbar
    ) {
    }
 
    private function getTestQuestionSetConfig(): ?ilTestQuestionSetConfig
    {
        return $this->test_question_set_config;
    }
 
    private function getTestOBJ(): ilObjTest
    {
        return $this->test_obj;
    }
 
    private function getTestPlayerGUI(): ?ilTestPlayerAbstractGUI
    {
        return $this->test_player_gui;
    }
 
    private function getTestSession(): ?ilTestSession
    {
        return $this->test_session;
    }
 
    public function getSessionLockString(): ?string
    {
        return $this->sessionLockString;
    }
 
    public function setSessionLockString($sessionLockString): void
    {
        $this->sessionLockString = $sessionLockString;
    }
 
    public function getInfoMessages(): array
    {
        return $this->infoMessages;
    }
 
    public function addInfoMessage($infoMessage): void
    {
        $this->infoMessages[] = $infoMessage;
    }
 
    public function getFailureMessages(): array
    {
        return $this->failureMessages;
    }
 
    public function addFailureMessage(string $failureMessage): void
    {
        $this->failureMessages[] = $failureMessage;
    }
 
    public function setFormAction(
        string $a_val,
        bool $a_multipart = false,
        string $a_target = ""
    ): void {
        if ($this->global_toolbar instanceof parent) {
            $this->global_toolbar->setFormAction($a_val, $a_multipart, $a_target);
        } else {
            parent::setFormAction($a_val, $a_multipart, $a_target);
        }
    }
 
    public function setCloseFormTag(bool $a_val): void
    {
        if ($this->global_toolbar instanceof parent) {
            $this->global_toolbar->setCloseFormTag($a_val);
        } else {
            parent::setCloseFormTag($a_val);
        }
    }
 
    public function addInputItem(
        ilToolbarItem $a_item,
        bool $a_output_label = false
    ): void {
        if ($this->global_toolbar instanceof parent) {
            $this->global_toolbar->addInputItem($a_item, $a_output_label);
        } else {
            parent::addInputItem($a_item, $a_output_label);
        }
    }
 
    public function addFormInput($formInput): void
    {
        if ($this->global_toolbar instanceof parent) {
            $this->global_toolbar->addFormInput($formInput);
        }
    }
 
    public function clearItems(): void
    {
        if ($this->global_toolbar instanceof parent) {
            $this->global_toolbar->setItems([]);
        } else {
            $this->setItems([]);
        }
    }
 
    private function getClassName($target)
    {
        if (is_object($target)) {
            $target = get_class($target);
        }
 
        return $target;
    }
 
    private function getClassNameArray($target): array
    {
        if (is_array($target)) {
            return $target;
        }
 
        return [$this->getClassName($target)];
    }
 
    private function getClassPath($target): array
    {
        return array_merge(self::$TARGET_CLASS_PATH_BASE, $this->getClassNameArray($target));
    }
 
    private function setParameter($target, $parameter, $value): void
    {
        $this->ctrl->setParameterByClass($this->getClassName($target), $parameter, $value);
    }
 
    private function buildLinkTarget($target, $cmd = null): string
    {
        return $this->ctrl->getLinkTargetByClass($this->getClassPath($target), $cmd);
    }
 
    private function buildFormAction($target): string
    {
        return $this->ctrl->getFormActionByClass($this->getClassPath($target));
    }
 
    private function ensureInitialisedSessionLockString(): void
    {
        if ($this->getSessionLockString() === '') {
            $this->setSessionLockString($this->buildSessionLockString());
        }
    }
 
    private function buildSessionLockString(): string
    {
        return md5($_COOKIE[session_name()] . time());
    }
 
    private function hasFixedQuestionSetSkillAssignsLowerThanBarrier(): bool
    {
        if (!$this->test_obj->isFixedTest()) {
            return false;
        }
 
        $assignmentList = new ilAssQuestionSkillAssignmentList($this->db);
        $assignmentList->setParentObjId($this->test_obj->getId());
        $assignmentList->loadFromDb();
 
        return $assignmentList->hasSkillsAssignedLowerThanBarrier();
    }
 
    private function getSkillAssignBarrierInfo(): string
    {
        return sprintf(
            $this->lng->txt('tst_skill_triggerings_num_req_answers_not_reached_warn'),
            $this->getTestOBJ()->getGlobalSettings()->getSkillTriggeringNumberOfAnswers()
        );
    }
 
    public function build(): void
    {
        $this->ensureInitialisedSessionLockString();
 
        $this->setParameter($this->getTestPlayerGUI(), 'lock', $this->getSessionLockString());
        $this->setParameter($this->getTestPlayerGUI(), 'sequence', $this->getTestSession()->getLastSequence());
        $this->setParameter('ilObjTestGUI', 'ref_id', $this->getTestOBJ()->getRefId());
        $this->setFormAction($this->buildFormAction($this->getTestPlayerGUI()));
 
        if ($this->getTestOBJ()->getOfflineStatus()) {
            $message = $this->lng->txt('test_is_offline');
 
            $links = [];
 
            if ($this->access->checkAccess("write", "", $this->getTestOBJ()->getRefId())) {
                $links[] = $this->ui_factory->link()->standard(
                    $this->lng->txt('test_edit_settings'),
                    $this->buildLinkTarget(SettingsMainGUI::class)
                );
            }
 
            $msgBox = $this->ui_factory->messageBox()->info($message)->withLinks($links);
 
            $this->populateMessage($this->ui_renderer->render($msgBox));
        }
 
        if ($this->access->checkAccess("write", "", $this->getTestOBJ()->getRefId())) {
            $qsaImportFails = new ilAssQuestionSkillAssignmentImportFails($this->test_obj->getId());
            $sltImportFails = new ilTestSkillLevelThresholdImportFails($this->test_obj->getId());
 
            if ($qsaImportFails->failedImportsRegistered() || $sltImportFails->failedImportsRegistered()) {
                $importFailsMsg = [];
 
                if ($qsaImportFails->failedImportsRegistered()) {
                    $importFailsMsg[] = $qsaImportFails->getFailedImportsMessage($this->lng);
                }
 
                if ($sltImportFails->failedImportsRegistered()) {
                    $importFailsMsg[] = $sltImportFails->getFailedImportsMessage($this->lng);
                }
 
                $message = implode('<br />', $importFailsMsg);
 
                $button = $this->ui_factory->button()->standard(
                    $this->lng->txt('ass_skl_import_fails_remove_btn'),
                    $this->ctrl->getLinkTargetByClass('ilObjTestGUI', 'removeImportFails')
                );
 
                $msgBox = $this->ui_factory->messageBox()->failure($message)->withButtons([$button]);
 
                $this->populateMessage($this->ui_renderer->render($msgBox));
            } elseif ($this->getTestOBJ()->isSkillServiceToBeConsidered()) {
                if ($this->hasFixedQuestionSetSkillAssignsLowerThanBarrier()) {
                    $this->addInfoMessage($this->getSkillAssignBarrierInfo());
                }
            }
        }
    }
 
    protected function populateMessage($message): void
    {
        $this->main_tpl->setCurrentBlock('mess');
        $this->main_tpl->setVariable('MESSAGE', $message);
        $this->main_tpl->parseCurrentBlock();
    }
 
    public function sendMessages(): void
    {
        $info_messages = $this->getInfoMessages();
        if ($info_messages !== []) {
            $this->main_tpl->setOnScreenMessage('info', array_pop($info_messages));
        }
 
        $failure_messages = $this->getFailureMessages();
        if ($failure_messages !== []) {
            $this->main_tpl->setOnScreenMessage('failure', array_pop($failure_messages));
        }
    }
}