ilTestRandomQuestionSetGeneralConfigFormGUI Class Reference

Inheritance diagram for ilTestRandomQuestionSetGeneralConfigFormGUI:

Collaboration diagram for ilTestRandomQuestionSetGeneralConfigFormGUI:

Public Member Functions
	__construct (private ilTestRandomQuestionSetConfigGUI $questionSetConfigGUI, private ilTestRandomQuestionSetConfig $questionSetConfig)
	isEditModeEnabled ()
	setEditModeEnabled (bool $edit_mode_enabled)
	build ()
	save (AdditionalInformationGenerator $additional_info)
Public Member Functions inherited from ilPropertyFormGUI
	__construct ()
	executeCommand ()
	setTableWidth (string $a_width)
	getTableWidth ()
	setMode (string $a_mode)
	getMode ()
	setTitle (string $a_title)
	getTitle ()
	setTitleIcon (string $a_titleicon)
	getTitleIcon ()
	setDescription (string $a_val)
	getDescription ()
	setTopAnchor (string $a_val)
	getTopAnchor ()
	setShowTopButtons (bool $a_val)
	getShowTopButtons ()
	setForceTopButtons (bool $a_val)
	getForceTopButtons ()
	addItem ($a_item)
	removeItemByPostVar (string $a_post_var, bool $a_remove_unused_headers=false)
	getItemByPostVar (string $a_post_var)
	setItems (array $a_items)
	getItems ()
	getInputItemsRecursive ()
	returns a flat array of all input items including the possibly existing subitems recursively More...
	setDisableStandardMessage (bool $a_val)
	getDisableStandardMessage ()
	getHideLabels ()
	setHideLabels (bool $a_value=true)
	setValuesByArray (array $a_values, bool $a_restrict_to_value_keys=false)
	setValuesByPost ()
	checkInput ()
	getInput (string $a_post_var, bool $ensureValidation=true)
	Returns the input of an item, if item provides getInput method and as fallback the value of the HTTP-POST variable, identified by the passed postvar. More...
	addCommandButton (string $a_cmd, string $a_text, string $a_id="")
	getCommandButtons ()
	clearCommandButtons ()
	getContent ()
	insertItem ( $item, bool $a_sub_item=false)
	addAsyncOnloadCode (string $code)
	getHTML ()
	getHTMLAsync ()
	getFileUpload (string $a_field, ?string $a_index=null, ?string $a_sub_index=null)
	Get file upload data. More...
	hasFileUpload (string $a_field, ?string $a_index=null, ?string $a_sub_index=null)
	moveFileUpload (string $a_target_directory, string $a_field, ?string $a_target_name=null, ?string $a_index=null, ?string $a_sub_index=null)
	Move upload to target directory. More...
Public Member Functions inherited from ilFormGUI
	setFormAction (string $a_formaction)
	getFormAction ()
	setTarget (string $a_target)
	getTarget ()
	setMultipart (bool $a_multipart)
	getMultipart ()
	setId (string $a_id)
	getId ()
	setName (string $a_name)
	getName ()
	setKeepOpen (bool $a_keepopen)
	getKeepOpen ()
	setOpenTag (bool $a_open)
	getOpenTag ()
	setCloseTag (bool $a_val)
	getCloseTag ()
	setPreventDoubleSubmission (bool $a_val)
	getPreventDoubleSubmission ()
	getHTML ()
	getContent ()

Protected Attributes
bool	$edit_mode_enabled = true
Protected Attributes inherited from ilPropertyFormGUI
bool	$required_text = false
ilLanguage	$lng
ilCtrl	$ctrl
ilTemplate	$tpl
ilObjUser	$user = null
ilSetting	$settings = null
string	$mode = "std"
bool	$check_input_called = false
bool	$disable_standard_message = false
string	$top_anchor = "il_form_top"
string	$title = ''
string	$titleicon = ""
string	$description = ""
string	$tbl_width = ""
bool	$show_top_buttons = true
bool	$hide_labels = false
bool	$force_top_buttons = false
HTTP Services	$http
Refinery Factory	$refinery = null
ilGlobalTemplateInterface	$global_tpl = null
	$onload_code = []
Protected Attributes inherited from ilFormGUI
string	$formaction = ""
bool	$multipart = false
bool	$keepopen = false
bool	$opentag = true
string	$id = ''
string	$name = ''
string	$target = ''
bool	$prevent_double_submission = false

Private Member Functions
	fetchValidQuestionAmountConfigModeWithFallbackModePerTest (ilTestRandomQuestionSetConfig $config)

Additional Inherited Members
Protected Member Functions inherited from ilPropertyFormGUI
	getRequestedPostVar ()
	getFileHash ()
	hideRequired (string $a_type)
	appendOnloadCode (string $html)
	rebuildUploadedFiles ()
	checkForRequiredField ()

Detailed Description

Definition at line 33 of file class.ilTestRandomQuestionSetGeneralConfigFormGUI.php.

Constructor & Destructor Documentation

__construct()

ilTestRandomQuestionSetGeneralConfigFormGUI::__construct	(	private ilTestRandomQuestionSetConfigGUI	$questionSetConfigGUI,
		private ilTestRandomQuestionSetConfig	$questionSetConfig
	)

Definition at line 37 of file class.ilTestRandomQuestionSetGeneralConfigFormGUI.php.

References ILIAS\GlobalScreen\Provider\__construct(), and ILIAS\Repository\lng().

      {
        parent::__construct();
        $this->lng->loadLanguageModule('form');
    }

Here is the call graph for this function:

Member Function Documentation

build()

ilTestRandomQuestionSetGeneralConfigFormGUI::build

(

)

Definition at line 55 of file class.ilTestRandomQuestionSetGeneralConfigFormGUI.php.

References ilPropertyFormGUI\addCommandButton(), ilPropertyFormGUI\addItem(), ilTestRandomQuestionSetConfigGUI\CMD_SAVE_GENERAL_CONFIG_FORM, ILIAS\Repository\ctrl(), fetchValidQuestionAmountConfigModeWithFallbackModePerTest(), isEditModeEnabled(), ILIAS\Repository\lng(), ilTestRandomQuestionSetConfig\QUESTION_AMOUNT_CONFIG_MODE_PER_POOL, ilTestRandomQuestionSetConfig\QUESTION_AMOUNT_CONFIG_MODE_PER_TEST, ilFormGUI\setFormAction(), ilFormGUI\setId(), ilFormPropertyGUI\setRequired(), ilPropertyFormGUI\setTitle(), and ilRadioGroupInputGUI\setValue().

                           : 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);
        }
    }

Here is the call graph for this function:

fetchValidQuestionAmountConfigModeWithFallbackModePerTest()

ilTestRandomQuestionSetGeneralConfigFormGUI::fetchValidQuestionAmountConfigModeWithFallbackModePerTest ( ilTestRandomQuestionSetConfig  $config )

private

Definition at line 138 of file class.ilTestRandomQuestionSetGeneralConfigFormGUI.php.

References ilTestRandomQuestionSetConfig\getQuestionAmountConfigurationMode(), ilTestRandomQuestionSetConfig\QUESTION_AMOUNT_CONFIG_MODE_PER_POOL, and ilTestRandomQuestionSetConfig\QUESTION_AMOUNT_CONFIG_MODE_PER_TEST.

Referenced by build().

                                                                                                                     : ?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;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

isEditModeEnabled()

ilTestRandomQuestionSetGeneralConfigFormGUI::isEditModeEnabled

(

)

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

References $edit_mode_enabled.

Referenced by build().

                                       : bool
    {
        return $this->edit_mode_enabled;
    }

Here is the caller graph for this function:

save()

ilTestRandomQuestionSetGeneralConfigFormGUI::save

(

AdditionalInformationGenerator

$additional_info

)

Definition at line 150 of file class.ilTestRandomQuestionSetGeneralConfigFormGUI.php.

References ilPropertyFormGUI\getItemByPostVar(), ILIAS\Test\Logging\AdditionalInformationGenerator\getTagForLangVar(), ILIAS\Test\Logging\AdditionalInformationGenerator\getTrueFalseTagForBool(), ILIAS\Repository\int(), and null.

                                                                         : 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;
    }

Here is the call graph for this function:

setEditModeEnabled()

ilTestRandomQuestionSetGeneralConfigFormGUI::setEditModeEnabled

(

bool

$edit_mode_enabled

)

Definition at line 50 of file class.ilTestRandomQuestionSetGeneralConfigFormGUI.php.

References $edit_mode_enabled.

                                                               : void
    {
        $this->edit_mode_enabled = $edit_mode_enabled;
    }

Field Documentation

$edit_mode_enabled

bool ilTestRandomQuestionSetGeneralConfigFormGUI::$edit_mode_enabled = true

protected

Definition at line 35 of file class.ilTestRandomQuestionSetGeneralConfigFormGUI.php.

Referenced by isEditModeEnabled(), and setEditModeEnabled().

---

The documentation for this class was generated from the following file:

• components/ILIAS/Test/classes/Forms/class.ilTestRandomQuestionSetGeneralConfigFormGUI.php