class.ilTestRandomQuestionSetGeneralConfigFormGUI.php

Go to the documentation of this file.

<?php

declare(strict_types=1);

use ILIAS\Test\Logging\AdditionalInformationGenerator;

class ilTestRandomQuestionSetGeneralConfigFormGUI extends ilPropertyFormGUI
{
    protected bool $edit_mode_enabled = true;

    public function __construct(
        private ilTestRandomQuestionSetConfigGUI $questionSetConfigGUI,
        private ilTestRandomQuestionSetConfig $questionSetConfig
    ) {
        parent::__construct();
        $this->lng->loadLanguageModule('form');
    }

    public function isEditModeEnabled(): bool
    {
        return $this->edit_mode_enabled;
    }

    public function setEditModeEnabled(bool $edit_mode_enabled): void
    {
        $this->edit_mode_enabled = $edit_mode_enabled;
    }

    public function build(): void
    {
        $this->setFormAction($this->ctrl->getFormAction($this->questionSetConfigGUI));

        $this->setTitle($this->lng->txt('tst_rnd_quest_set_cfg_general_form'));
        $this->setId('tstRndQuestSetCfgGeneralForm');

        $this->addCommandButton(
            ilTestRandomQuestionSetConfigGUI::CMD_SAVE_GENERAL_CONFIG_FORM,
            $this->lng->txt('save')
        );

        $requirePoolsQuestionsHomoScored = new ilCheckboxInputGUI(
            $this->lng->txt('tst_inp_all_quest_points_equal_per_pool'),
            'quest_points_equal_per_pool'
        );

        $requirePoolsQuestionsHomoScored->setInfo(
            $this->lng->txt('tst_inp_all_quest_points_equal_per_pool_desc')
        );

        $requirePoolsQuestionsHomoScored->setChecked(
            (bool)
            $this->questionSetConfig->arePoolsWithHomogeneousScoredQuestionsRequired()
        );

        $this->addItem($requirePoolsQuestionsHomoScored);

        // question amount config mode (per test / per pool)

        $questionAmountConfigMode = new ilRadioGroupInputGUI(
            $this->lng->txt('tst_inp_quest_amount_cfg_mode'),
            'quest_amount_cfg_mode'
        );

        $questionAmountConfigMode->setValue($this->fetchValidQuestionAmountConfigModeWithFallbackModePerTest(
            $this->questionSetConfig
        ));

        $questionAmountConfigModePerTest = new ilRadioOption(
            $this->lng->txt('tst_inp_quest_amount_cfg_mode_test'),
            ilTestRandomQuestionSetConfig::QUESTION_AMOUNT_CONFIG_MODE_PER_TEST
        );

        $questionAmountConfigMode->addOption($questionAmountConfigModePerTest);

        $questionAmountConfigModePerPool = new ilRadioOption(
            $this->lng->txt('tst_inp_quest_amount_cfg_mode_pool'),
            ilTestRandomQuestionSetConfig::QUESTION_AMOUNT_CONFIG_MODE_PER_POOL
        );

        $questionAmountConfigMode->addOption($questionAmountConfigModePerPool);

        $questionAmountConfigMode->setRequired(true);

        $this->addItem($questionAmountConfigMode);

        // question amount per test

        $questionAmountPerTest = new ilNumberInputGUI(
            $this->lng->txt('tst_inp_quest_amount_per_test'),
            'quest_amount_per_test'
        );

        $questionAmountPerTest->setRequired(true);
        $questionAmountPerTest->setMinValue(1);
        $questionAmountPerTest->allowDecimals(false);
        $questionAmountPerTest->setMinvalueShouldBeGreater(false);
        $questionAmountPerTest->setSize(4);

        $questionAmountPerTest->setValue(
            (string) $this->questionSetConfig->getQuestionAmountPerTest()
        );

        $questionAmountConfigModePerTest->addSubItem($questionAmountPerTest);

        if (!$this->isEditModeEnabled()) {
            $requirePoolsQuestionsHomoScored->setDisabled(true);
            $questionAmountConfigMode->setDisabled(true);
            $questionAmountPerTest->setDisabled(true);
        }
    }

    private function fetchValidQuestionAmountConfigModeWithFallbackModePerTest(ilTestRandomQuestionSetConfig $config): ?string
    {
        switch ($config->getQuestionAmountConfigurationMode()) {
            case ilTestRandomQuestionSetConfig::QUESTION_AMOUNT_CONFIG_MODE_PER_TEST:
            case ilTestRandomQuestionSetConfig::QUESTION_AMOUNT_CONFIG_MODE_PER_POOL:

                return $config->getQuestionAmountConfigurationMode();
        }

        return ilTestRandomQuestionSetConfig::QUESTION_AMOUNT_CONFIG_MODE_PER_TEST;
    }

    public function save(AdditionalInformationGenerator $additional_info): array
    {
        $log_array = [];
        $question_equal_per_pool = $this->getItemByPostVar('quest_points_equal_per_pool')->getChecked();
        $this->questionSetConfig->setPoolsWithHomogeneousScoredQuestionsRequired(
            $question_equal_per_pool
        );

        $log_array[AdditionalInformationGenerator::KEY_HOMOGENEOUS_SCORING] = $additional_info
            ->getTrueFalseTagForBool($question_equal_per_pool);

        $question_amount_configuration_mode = $this->getItemByPostVar('quest_amount_cfg_mode')->getValue();
        $this->questionSetConfig->setQuestionAmountConfigurationMode(
            $question_amount_configuration_mode
        );

        $log_array[AdditionalInformationGenerator::KEY_QUESTION_AMOUNT_TYPE] = $this->questionSetConfig->getQuestionAmountPerTest()
            ? $additional_info->getTagForLangVar('tst_inp_quest_amount_cfg_mode_test')
            : $additional_info->getTagForLangVar('tst_inp_quest_amount_cfg_mode_pool');

        $this->questionSetConfig->setQuestionAmountPerTest(null);
        if (!$this->questionSetConfig->getQuestionAmountPerTest()) {
            $question_amount_per_test = (int) $this->getItemByPostVar('quest_amount_per_test')->getValue();
            $this->questionSetConfig->setQuestionAmountPerTest(
                $question_amount_per_test
            );
            $log_array[AdditionalInformationGenerator::KEY_QUESTION_AMOUNT_PER_TEST] = $question_amount_per_test;
        }

        $this->questionSetConfig->saveToDb();
        return $log_array;
    }
}