class.ilTestExpressPageObjectGUI.php

Go to the documentation of this file.

<?php

class ilTestExpressPageObjectGUI extends ilAssQuestionPageGUI
{
    public $test_object;

    public function nextQuestion()
    {
        $obj = new ilObjTest($this->testrequest->getRefId());
        $questions = array_keys($obj->getQuestionTitlesAndIndexes());

        $pos = array_search($this->testrequest->raw('q_id'), $questions);

        if ($pos !== false) {
            $next = $questions[$pos + 1];
        } else {
            $next = $questions[0];
        }

        $this->ctrl->setParameter($this, 'q_id', $next);
        $link = $this->ctrl->getLinkTarget($this, 'edit', '', '', false);

        ilUtil::redirect($link);
    }

    public function prevQuestion()
    {
        $obj = new ilObjTest($this->testrequest->getRefId());
        $questions = array_keys($obj->getQuestionTitlesAndIndexes());

        $pos = array_search($this->testrequest->raw('q_id'), $questions);

        if ($pos !== false) {
            $next = $questions[$pos - 1];
        } else {
            $next = $questions[0];
        }

        $this->ctrl->setParameter($this, 'q_id', $next);
        $link = $this->ctrl->getLinkTarget($this, 'edit', '', '', false);

        ilUtil::redirect($link);
    }

    public function __construct($a_id = 0, $a_old_nr = 0)
    {
        parent::__construct($a_id, $a_old_nr);
    }

    public function executeCommand(): string
    {
        global $DIC; /* @var ILIAS\DI\Container $DIC */
        $ilCtrl = $DIC['ilCtrl'];
        $ilTabs = $DIC['ilTabs'];
        $ilUser = $DIC['ilUser'];
        $lng = $DIC['lng'];

        $next_class = $this->ctrl->getNextClass($this);
        $cmd = $this->ctrl->getCmd();

        switch ($next_class) {
            case 'ilobjquestionpoolgui':

                $nodeParts = explode(':', $this->testrequest->raw('cmdNode'));

                $params = array(
                    'ref_id' => $this->testrequest->getRefId(),
                    'calling_test' => $this->testrequest->getRefId(),
                    'q_id' => $this->testrequest->getQuestionId(),
                    'cmd' => $this->testrequest->raw('cmd'),
                    'cmdClass' => $this->testrequest->raw('cmdClass'),
                    'baseClass' => 'ilObjQuestionPoolGUI',
                    'test_express_mode' => '1'
                );

                ilUtil::redirect(
                    'ilias.php' . ilUtil::appendUrlParameterString(
                        '?' . http_build_query($params, null, '&'),
                        'cmdNode=' . ($nodeParts[count($nodeParts) - 2] . ':' . $nodeParts[count($nodeParts) - 1])
                    )
                );

                break;

            case "ilpageeditorgui":

                if (!$this->getEnableEditing()) {
                    $this->tpl->setOnScreenMessage('failure', $lng->txt("permission_denied"), true);
                    $ilCtrl->redirect($this, "preview");
                }

                $page_editor = new ilPageEditorGUI($this->getPageObject(), $this);
                //$page_editor->setLocator($this->locator);
                $page_editor->setHeader($this->getHeader());
                $page_editor->setPageBackTitle($this->page_back_title);
                $page_editor->setIntLinkReturn($this->int_link_return);

                $this->ctrl->saveParameterByClass('ilpageeditorgui', 'q_mode');

                $ret = $this->ctrl->forwardCommand($page_editor);
                if ($ret != "") {
                    $this->tpl->setContent($ret);
                }
                break;

            case '':
            case 'iltestexpresspageobjectgui':

                include_once 'Modules/TestQuestionPool/classes/class.assQuestionGUI.php';

                if ($cmd == 'view') {
                    $cmd = 'showPage';
                    $ilCtrl->setCmd($cmd);
                }

                $q_gui = assQuestionGUI::_getQuestionGUI('', (int) $this->testrequest->raw('q_id'));

                if ($q_gui->object) {
                    $obj = ilObjectFactory::getInstanceByRefId((int) $this->testrequest->getRefId());
                    $q_gui->object->setObjId($obj->getId());
                }

                $cmds = array(
                    'handleToolbarCommand',
                    'addQuestion',
                    'questions',
                    'insertQuestions',
                    'browseForQuestions',
                    'filterAvailableQuestions',
                    'resetfilterAvailableQuestions'
                );

                if (in_array($cmd, $cmds)) {
                    return $this->$cmd();
                } elseif ($q_gui->object) {
                    $total = $this->test_object->evalTotalPersons();

                    $this->setOutputMode($total == 0 ? ilPageObjectGUI::EDIT : ilPageObjectGUI::PREVIEW);

                    if ($total != 0) {
                        $link = $DIC->ui()->factory()->link()->standard(
                            $DIC->language()->txt("test_has_datasets_warning_page_view_link"),
                            $DIC->ctrl()->getLinkTargetByClass(array('ilTestResultsGUI', 'ilParticipantsTestResultsGUI'))
                        );

                        $message = $DIC->language()->txt("test_has_datasets_warning_page_view");

                        $msgBox = $DIC->ui()->factory()->messageBox()->info($message)->withLinks(array($link));

                        $DIC->ui()->mainTemplate()->setCurrentBlock('mess');
                        $DIC->ui()->mainTemplate()->setVariable(
                            'MESSAGE',
                            $DIC->ui()->renderer()->render($msgBox)
                        );
                        $DIC->ui()->mainTemplate()->parseCurrentBlock();
                    }

                    if ((in_array($cmd, array('view', 'showPage')) || $cmd == 'edit') && $this->test_object->evalTotalPersons()) {
                        return $this->showPage();
                    }

                    return parent::executeCommand();
                }

                break;

            default:
                $type = ilObjQuestionPool::getQuestionTypeByTypeId(ilUtil::stripSlashes((string) $this->testrequest->raw('qtype')));

                if (!$this->testrequest->raw('q_id')) {
                    $q_gui = $this->addPageOfQuestions(preg_replace('/(.*?)gui/i', '$1', $this->testrequest->raw('sel_question_types')));
                    $q_gui->setQuestionTabs();

                    $this->ctrl->forwardCommand($q_gui);
                    break;
                }

                $this->ctrl->setReturn($this, "questions");

                require_once 'Modules/TestQuestionPool/classes/class.assQuestionGUI.php';
                $q_gui = assQuestionGUI::_getQuestionGUI($type, (int) $this->testrequest->raw('q_id'));
                if ($q_gui->object) {
                    $obj = ilObjectFactory::getInstanceByRefId((int) $this->testrequest->getRefId());
                    $q_gui->object->setObjId($obj->getId());
                }

                $this->ctrl->saveParameterByClass('ilpageeditorgui', 'q_id');
                $this->ctrl->saveParameterByClass('ilpageeditorgui', 'q_mode');

                $q_gui->setQuestionTabs();
                $this->ctrl->forwardCommand($q_gui);
                break;
        }
        return '';
    }

    public function addPageOfQuestions($type = ''): assQuestionGUI
    {
        global $DIC;
        $ilCtrl = $DIC['ilCtrl'];

        if (!$type) {
            $qtype = $this->testrequest->raw('qtype');
            $pool = new ilObjQuestionPool();
            $type = ilObjQuestionPool::getQuestionTypeByTypeId($qtype);
        }

        $this->ctrl->setReturn($this, "questions");

        include_once "./Modules/TestQuestionPool/classes/class.assQuestionGUI.php";
        $q_gui = assQuestionGUI::_getQuestionGUI($type);

        $obj = ilObjectFactory::getInstanceByRefId($this->testrequest->getRefId());

        $q_gui->object->setObjId($obj->getId());

        return $q_gui;
    }

    public function handleToolbarCommand()
    {
        global $DIC;
        $ilCtrl = $DIC['ilCtrl'];

        include_once "./Modules/TestQuestionPool/classes/class.assQuestionGUI.php";

        if ($this->testrequest->raw('qtype')) {
            include_once 'Modules/TestQuestionPool/classes/class.ilObjQuestionPool.php';
            $questionType = ilObjQuestionPool::getQuestionTypeByTypeId($this->testrequest->raw('qtype'));
        } elseif ($this->testrequest->raw('sel_question_types')) {
            $questionType = $this->testrequest->raw('sel_question_types');
        }

        include_once 'Modules/Test/classes/class.ilObjAssessmentFolder.php';
        if (ilObjAssessmentFolder::isAdditionalQuestionContentEditingModePageObjectEnabled()) {
            $addContEditMode = $this->testrequest->raw('add_quest_cont_edit_mode');
        } else {
            $addContEditMode = assQuestion::ADDITIONAL_CONTENT_EDITING_MODE_RTE;
        }

        $q_gui = assQuestionGUI::_getQuestionGUI($questionType);

        $q_gui->object->setObjId(ilObject::_lookupObjectId($this->testrequest->getRefId()));
        $q_gui->object->setAdditionalContentEditingMode($addContEditMode);

        $q_gui->object->createNewQuestion();

        $previousQuestionId = $this->testrequest->raw('position');

        switch ($this->testrequest->raw('usage')) {
            case 3: // existing pool

                $ilCtrl->setParameterByClass('ilobjtestgui', 'sel_qpl', $this->testrequest->raw('sel_qpl'));
                $ilCtrl->setParameterByClass('ilobjtestgui', 'sel_question_types', $questionType);
                $ilCtrl->setParameterByClass('ilobjtestgui', 'q_id', $q_gui->object->getId());
                $ilCtrl->setParameterByClass('ilobjtestgui', 'prev_qid', $previousQuestionId);

                if ($this->testrequest->raw('test_express_mode')) {
                    $ilCtrl->setParameterByClass('ilobjtestgui', 'test_express_mode', 1);
                }

                if ($this->testrequest->isset('add_quest_cont_edit_mode')) {
                    $ilCtrl->setParameterByClass(
                        'ilobjtestgui',
                        'add_quest_cont_edit_mode',
                        $this->testrequest->raw('add_quest_cont_edit_mode')
                    );
                }

                $ilCtrl->setParameterByClass('ilobjtestgui', 'usage', 3);
                $ilCtrl->setParameterByClass('ilobjtestgui', 'calling_test', $this->test_object->getId());

                $link = $ilCtrl->getLinkTargetByClass('ilobjtestgui', 'executeCreateQuestion', false, false, false);

                ilUtil::redirect($link);

                break;

            case 2: // new pool

                $ilCtrl->setParameterByClass('ilobjtestgui', 'txt_qpl', $this->testrequest->raw('txt_qpl'));
                $ilCtrl->setParameterByClass('ilobjtestgui', 'sel_question_types', $questionType);
                $ilCtrl->setParameterByClass('ilobjtestgui', 'q_id', $q_gui->object->getId());
                $ilCtrl->setParameterByClass('ilobjtestgui', 'prev_qid', $previousQuestionId);

                if ($this->testrequest->raw('test_express_mode')) {
                    $ilCtrl->setParameterByClass('ilobjtestgui', 'test_express_mode', 1);
                }

                if ($this->testrequest->isset('add_quest_cont_edit_mode')) {
                    $ilCtrl->setParameterByClass(
                        'ilobjtestgui',
                        'add_quest_cont_edit_mode',
                        $this->testrequest->raw('add_quest_cont_edit_mode')
                    );
                }

                $ilCtrl->setParameterByClass('ilobjtestgui', 'usage', 2);
                $ilCtrl->setParameterByClass('ilobjtestgui', 'calling_test', $this->test_object->getId());

                $link = $ilCtrl->getLinkTargetByClass('ilobjtestgui', 'executeCreateQuestion', false, false, false);
                ilUtil::redirect($link);

                break;

            case 1: // no pool
            default:

                $this->redirectToQuestionEditPage($questionType, $q_gui->object->getId(), $previousQuestionId);

                break;
        }
    }

    public function addQuestion(): string
    {
        global $DIC;
        $lng = $DIC['lng'];
        $ilCtrl = $DIC['ilCtrl'];
        $tpl = $DIC['tpl'];
        global $DIC; /* @var \ILIAS\DI\Container $DIC */
        $ilHelp = $DIC['ilHelp']; /* @var ilHelpGUI $ilHelp */

        $subScreenId = array('createQuestion');

        include_once "Services/Form/classes/class.ilPropertyFormGUI.php";

        $ilCtrl->setParameter($this, 'qtype', $this->testrequest->raw('qtype'));

        $form = new ilPropertyFormGUI();

        $ilCtrl->setParameter($this, 'test_express_mode', 1);

        $form->setFormAction($ilCtrl->getFormAction($this, "handleToolbarCommand"));
        $form->setTitle($lng->txt("ass_create_question"));
        include_once 'Modules/TestQuestionPool/classes/class.ilObjQuestionPool.php';

        $pool = new ilObjQuestionPool();
        $questionTypes = $pool->getQuestionTypes(false, true, false);
        $options = array();

        // question type
        foreach ($questionTypes as $label => $data) {
            $options[$data['question_type_id']] = $label;
        }

        include_once("./Services/Form/classes/class.ilSelectInputGUI.php");
        $si = new ilSelectInputGUI($lng->txt("question_type"), "qtype");
        $si->setOptions($options);
        $form->addItem($si, true);

        // position
        $questions = $this->test_object->getQuestionTitlesAndIndexes();
        if ($questions) {
            $si = new ilSelectInputGUI($lng->txt("position"), "position");
            $options = array('0' => $lng->txt('first'));
            foreach ($questions as $key => $title) {
                $options[$key] = $lng->txt('behind') . ' ' . $title . ' [' . $this->lng->txt('question_id_short') . ': ' . $key . ']';
            }
            $si->setOptions($options);
            $si->setValue($this->testrequest->raw('q_id'));
            $form->addItem($si, true);
        }

        // content editing mode
        if (ilObjAssessmentFolder::isAdditionalQuestionContentEditingModePageObjectEnabled()) {
            $subScreenId[] = 'editMode';

            $ri = new ilRadioGroupInputGUI($lng->txt("tst_add_quest_cont_edit_mode"), "add_quest_cont_edit_mode");

            $option_ipe = new ilRadioOption(
                $lng->txt('tst_add_quest_cont_edit_mode_IPE'),
                assQuestion::ADDITIONAL_CONTENT_EDITING_MODE_IPE
            );
            $option_ipe->setInfo($lng->txt('tst_add_quest_cont_edit_mode_IPE_info'));
            $ri->addOption($option_ipe);

            $option_rte = new ilRadioOption(
                $lng->txt('tst_add_quest_cont_edit_mode_RTE'),
                assQuestion::ADDITIONAL_CONTENT_EDITING_MODE_RTE
            );
            $option_rte->setInfo($lng->txt('tst_add_quest_cont_edit_mode_RTE_info'));
            $ri->addOption($option_rte);

            $ri->setValue(assQuestion::ADDITIONAL_CONTENT_EDITING_MODE_IPE);

            $form->addItem($ri, true);
        } else {
            $hi = new ilHiddenInputGUI("question_content_editing_type");
            $hi->setValue(assQuestion::ADDITIONAL_CONTENT_EDITING_MODE_RTE);
            $form->addItem($hi, true);
        }

        $subScreenId[] = 'poolSelect';

        // use pool
        $usage = new ilRadioGroupInputGUI($this->lng->txt("assessment_pool_selection"), "usage");
        $usage->setRequired(true);
        $no_pool = new ilRadioOption($this->lng->txt("assessment_no_pool"), 1);
        $usage->addOption($no_pool);
        $existing_pool = new ilRadioOption($this->lng->txt("assessment_existing_pool"), 3);
        $usage->addOption($existing_pool);
        $new_pool = new ilRadioOption($this->lng->txt("assessment_new_pool"), 2);
        $usage->addOption($new_pool);
        $form->addItem($usage);

        $usage->setValue(1);

        $questionpools = ilObjQuestionPool::_getAvailableQuestionpools(false, false, true, false, false, "write");
        $pools_data = array();
        foreach ($questionpools as $key => $p) {
            $pools_data[$key] = $p['title'];
        }
        $pools = new ilSelectInputGUI($this->lng->txt("select_questionpool"), "sel_qpl");
        $pools->setOptions($pools_data);
        $existing_pool->addSubItem($pools);

        $name = new ilTextInputGUI($this->lng->txt("name"), "txt_qpl");
        $name->setSize(50);
        $name->setMaxLength(50);
        $new_pool->addSubItem($name);

        $form->addCommandButton("handleToolbarCommand", $lng->txt("create"));
        $form->addCommandButton("questions", $lng->txt("cancel"));

        $ilHelp->setSubScreenId(implode('_', $subScreenId));

        return $form->getHTML();
    }

    public function questions()
    {
        global $DIC;
        $ilCtrl = $DIC['ilCtrl'];

        $ilCtrl->saveParameterByClass('ilobjtestgui', 'q_id');

        $ilCtrl->redirectByClass('ilobjtestgui', 'showPage');
    }

    private function redirectToQuestionEditPage($questionType, $qid, $prev_qid)
    {
        $cmdClass = $questionType . 'GUI';

        $this->ctrl->setParameterByClass($cmdClass, 'ref_id', $this->testrequest->getRefId());
        $this->ctrl->setParameterByClass($cmdClass, 'sel_question_types', $questionType);
        $this->ctrl->setParameterByClass($cmdClass, 'test_ref_id', $this->testrequest->getRefId());
        $this->ctrl->setParameterByClass($cmdClass, 'calling_test', $this->testrequest->getRefId());
        $this->ctrl->setParameterByClass($cmdClass, 'q_id', $qid);
        $this->ctrl->setParameterByClass($cmdClass, 'prev_qid', $prev_qid);

        if ($this->testrequest->raw('test_express_mode')) {
            $this->ctrl->setParameterByClass($cmdClass, 'test_express_mode', 1);
        }

        $this->ctrl->redirectByClass(
            array('ilRepositoryGUI', 'ilObjTestGUI', $questionType . "GUI"),
            'editQuestion'
        );
    }

    private function redirectToQuestionPoolSelectionPage($questionType, $qid, $prev_qid)
    {
        $this->ctrl->setParameterByClass('ilObjTestGUI', 'ref_id', $this->testrequest->getRefId());
        $this->ctrl->setParameterByClass('ilObjTestGUI', 'q_id', $qid);
        $this->ctrl->setParameterByClass('ilObjTestGUI', 'sel_question_types', $questionType);
        $this->ctrl->setParameterByClass('ilObjTestGUI', 'prev_qid', $prev_qid);
        $redir = $this->ctrl->getLinkTargetByClass('ilObjTestGUI', 'createQuestion', '', false, false);

        ilUtil::redirect($redir);
    }

    public function insertQuestions()
    {
        $selected_array = (is_array($_POST['q_id'])) ? $_POST['q_id'] : array();
        if (!count($selected_array)) {
            $this->tpl->setOnScreenMessage('info', $this->lng->txt("tst_insert_missing_question"), true);
            $this->ctrl->redirect($this, "browseForQuestions");
        } else {
            include_once "./Modules/TestQuestionPool/classes/class.assQuestion.php";
            $manscoring = false;

            global $DIC;
            $tree = $DIC['tree'];
            $ilDB = $DIC['ilDB'];
            $component_repository = $DIC['component.repository'];

            $testQuestionSetConfigFactory = new ilTestQuestionSetConfigFactory($tree, $ilDB, $component_repository, $this->test_object);
            $testQuestionSetConfig = $testQuestionSetConfigFactory->getQuestionSetConfig();

            foreach ($selected_array as $key => $value) {
                $last_question_id = $this->test_object->insertQuestion($testQuestionSetConfig, $value);

                if (!$manscoring) {
                    $manscoring = $manscoring | assQuestion::_needsManualScoring($value);
                }
            }
            $this->test_object->saveCompleteStatus($testQuestionSetConfig);
            if ($manscoring) {
                $this->tpl->setOnScreenMessage('info', $this->lng->txt("manscoring_hint"), true);
            } else {
                $this->tpl->setOnScreenMessage('success', $this->lng->txt("tst_questions_inserted"), true);
            }

            $this->ctrl->setParameter($this, 'q_id', $last_question_id);
            $this->ctrl->redirect($this, "showPage");
            return;
        }
    }
}