ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour Class Reference

Inheritance diagram for ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour:

Collaboration diagram for ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour:

Public Member Functions
	__construct (int $test_id, protected int $question_title_output_mode, protected bool $autosave_enabled, protected int $autosave_interval, protected bool $shuffle_questions, protected bool $question_hints_enabled, protected bool $instant_feedback_points_enabled, protected bool $instant_feedback_generic_enabled, protected bool $instant_feedback_specific_enabled, protected bool $instant_feedback_solution_enabled, protected bool $force_instant_feedback_on_next_question, protected bool $lock_answer_on_instant_feedback, protected bool $lock_answer_on_next_question)
	toForm (\ilLanguage $lng, FieldFactory $f, Refinery $refinery, ?array $environment=null)
	toStorage ()
	toLog (AdditionalInformationGenerator $additional_info)
	getQuestionTitleOutputMode ()
	withQuestionTitleOutputMode (int $question_title_output_mode)
	getAutosaveEnabled ()
	withAutosaveEnabled (bool $autosave_enabled)
	getAutosaveInterval ()
	withAutosaveInterval (int $autosave_interval)
	getShuffleQuestions ()
	withShuffleQuestions (bool $shuffle_questions)
	getQuestionHintsEnabled ()
	withQuestionHintsEnabled (bool $question_hints_enabled)
	getInstantFeedbackPointsEnabled ()
	withInstantFeedbackPointsEnabled (bool $instant_feedback_points_enabled)
	getInstantFeedbackGenericEnabled ()
	withInstantFeedbackGenericEnabled (bool $instant_feedback_generic_enabled)
	getInstantFeedbackSpecificEnabled ()
	withInstantFeedbackSpecificEnabled (bool $instant_feedback_specific_enabled)
	getInstantFeedbackSolutionEnabled ()
	withInstantFeedbackSolutionEnabled (bool $instant_feedback_solution_enabled)
	getForceInstantFeedbackOnNextQuestion ()
	withForceInstantFeedbackOnNextQuestion (bool $force_instant_feedback_on_next_question)
	getLockAnswerOnInstantFeedbackEnabled ()
	withLockAnswerOnInstantFeedbackEnabled (bool $lock_answer_on_instant_feedback)
	getLockAnswerOnNextQuestionEnabled ()
	withLockAnswerOnNextQuestionEnabled (bool $lock_answer_on_next_question)
Public Member Functions inherited from ILIAS\Test\Settings\TestSettings
	__construct (int $test_id)
	getTestId ()
	withTestId (int $test_id)
	toForm (\ilLanguage $lng, FieldFactory $f, Refinery $refinery, ?array $environment=null)
	toStorage ()
	toLog (AdditionalInformationGenerator $additional_info)

Data Fields
const	ANSWER_FIXATION_NONE = 'none'
const	ANSWER_FIXATION_ON_INSTANT_FEEDBACK = 'instant_feedback'
const	ANSWER_FIXATION_ON_FOLLOWUP_QUESTION = 'followup_question'
const	ANSWER_FIXATION_ON_IFB_OR_FUQST = 'ifb_or_fuqst'

Private Member Functions
	getInputAutosave (\ilLanguage $lng, FieldFactory $f, Refinery $refinery)
	getInputInstantFeedback (\ilLanguage $lng, FieldFactory $f, Refinery $refinery, array $environment)
	getSubInputInstantFeedback (\ilLanguage $lng, FieldFactory $f)
	getInputLockAnswers (\ilLanguage $lng, FieldFactory $f, Refinery $refinery, array $environment)
	getTransformationLockAnswers (Refinery $refinery)
	getShuffleAndLockAnswersConstraint (\ilLanguage $lng, Refinery $refinery)
	isAnyInstantFeedbackOptionEnabled ()
	getAnswerFixationSettingsAsFormValue ()

Private Attributes
const	DEFAULT_AUTOSAVE_INTERVAL = 30000

Additional Inherited Members
Protected Attributes inherited from ILIAS\Test\Settings\TestSettings
int	$test_id

Detailed Description

Definition at line 33 of file SettingsQuestionBehaviour.php.

Constructor & Destructor Documentation

__construct()

ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour::__construct	(	int	$test_id,
		protected int	$question_title_output_mode,
		protected bool	$autosave_enabled,
		protected int	$autosave_interval,
		protected bool	$shuffle_questions,
		protected bool	$question_hints_enabled,
		protected bool	$instant_feedback_points_enabled,
		protected bool	$instant_feedback_generic_enabled,
		protected bool	$instant_feedback_specific_enabled,
		protected bool	$instant_feedback_solution_enabled,
		protected bool	$force_instant_feedback_on_next_question,
		protected bool	$lock_answer_on_instant_feedback,
		protected bool	$lock_answer_on_next_question
	)

Definition at line 42 of file SettingsQuestionBehaviour.php.

References ILIAS\GlobalScreen\Provider\__construct().

      {
        parent::__construct($test_id);
    }

Here is the call graph for this function:

Member Function Documentation

getAnswerFixationSettingsAsFormValue()

ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour::getAnswerFixationSettingsAsFormValue ( )

private

Definition at line 572 of file SettingsQuestionBehaviour.php.

References ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getLockAnswerOnInstantFeedbackEnabled(), and ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getLockAnswerOnNextQuestionEnabled().

Referenced by ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getInputLockAnswers().

                                                           : string
    {
        if ($this->getLockAnswerOnInstantFeedbackEnabled()
            && $this->getLockAnswerOnNextQuestionEnabled()) {
            return self::ANSWER_FIXATION_ON_IFB_OR_FUQST;
        }

        if ($this->getLockAnswerOnInstantFeedbackEnabled()) {
            return self::ANSWER_FIXATION_ON_INSTANT_FEEDBACK;
        }

        if ($this->getLockAnswerOnNextQuestionEnabled()) {
            return self::ANSWER_FIXATION_ON_FOLLOWUP_QUESTION;
        }

        return self::ANSWER_FIXATION_NONE;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getAutosaveEnabled()

ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour::getAutosaveEnabled

(

)

Definition at line 432 of file SettingsQuestionBehaviour.php.

Referenced by ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getInputAutosave(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\toLog(), and ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\toStorage().

                                        : bool
    {
        return $this->autosave_enabled;
    }

Here is the caller graph for this function:

getAutosaveInterval()

ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour::getAutosaveInterval

(

)

Definition at line 444 of file SettingsQuestionBehaviour.php.

Referenced by ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getInputAutosave(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\toLog(), and ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\toStorage().

                                         : int
    {
        return $this->autosave_interval;
    }

Here is the caller graph for this function:

getForceInstantFeedbackOnNextQuestion()

ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour::getForceInstantFeedbackOnNextQuestion

(

)

Definition at line 536 of file SettingsQuestionBehaviour.php.

Referenced by ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getInputInstantFeedback(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\toLog(), and ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\toStorage().

                                                           : bool
    {
        return $this->force_instant_feedback_on_next_question;
    }

Here is the caller graph for this function:

getInputAutosave()

ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour::getInputAutosave ( \ilLanguage  $lng, FieldFactory  $f, Refinery  $refinery  )

private

Definition at line 105 of file SettingsQuestionBehaviour.php.

References ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getAutosaveEnabled(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getAutosaveInterval(), null, ilLanguage\txt(), and ILIAS\UI\Implementation\Component\Input\withValue().

Referenced by ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\toForm().

     : OptionalGroup {
        $trafo = $refinery->custom()->transformation(
            static function (?array $vs): array {
                if ($vs === null) {
                    return [
                        'autosave_enabled' => false,
                        'autosave_interval' => self::DEFAULT_AUTOSAVE_INTERVAL
                    ];
                }

                return [
                    'autosave_enabled' => true,
                    'autosave_interval' => $vs['autosave_interval'] * 1000
                ];
            }
        );
        $sub_inputs_autosave['autosave_interval'] = $f->numeric($lng->txt('autosave_ival'), $lng->txt('seconds'))
            ->withRequired(true)
            ->withAdditionalTransformation($refinery->int()->isGreaterThan(0))
            ->withValue(
                $this->getAutosaveInterval() !== 0
                ? $this->getAutosaveInterval() / 1000
                : 30
            );

        $autosave_input = $f->optionalGroup(
            $sub_inputs_autosave,
            $lng->txt('autosave'),
            $lng->txt('autosave_info')
        )->withValue(null)
            ->withAdditionalTransformation($trafo);

        if (!$this->getAutosaveEnabled()) {
            return $autosave_input;
        }

        return $autosave_input->withValue(['autosave_interval' => $this->getAutosaveInterval() / 1000]);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getInputInstantFeedback()

ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour::getInputInstantFeedback ( \ilLanguage  $lng, FieldFactory  $f, Refinery  $refinery, array  $environment  )

private

Definition at line 148 of file SettingsQuestionBehaviour.php.

References ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getForceInstantFeedbackOnNextQuestion(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getInstantFeedbackGenericEnabled(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getInstantFeedbackPointsEnabled(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getInstantFeedbackSolutionEnabled(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getInstantFeedbackSpecificEnabled(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getSubInputInstantFeedback(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\isAnyInstantFeedbackOptionEnabled(), null, ilLanguage\txt(), and ILIAS\UI\Implementation\Component\Input\withValue().

Referenced by ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\toForm().

     : OptionalGroup {
        $constraint = $refinery->custom()->constraint(
            fn(?array $vs) => $vs === null
                || $vs['enabled_feedback_types']['instant_feedback_specific'] === null
                    && $vs['enabled_feedback_types']['instant_feedback_generic'] === null
                    && $vs['enabled_feedback_types']['instant_feedback_points'] === null
                    && $vs['enabled_feedback_types']['instant_feedback_solution'] === null
                    && $vs['feedback_trigger'] === null
                || (
                    $vs['enabled_feedback_types']['instant_feedback_specific'] === true
                    || $vs['enabled_feedback_types']['instant_feedback_generic'] === true
                    || $vs['enabled_feedback_types']['instant_feedback_points'] === true
                    || $vs['enabled_feedback_types']['instant_feedback_solution'] === true
                )
                    && $vs['feedback_trigger'] !== '',
            $lng->txt('select_at_least_one_feedback_type_and_trigger')
        );
        $trafo = $refinery->custom()->transformation(
            static function (?array $vs): array {
                if ($vs === null) {
                    return [
                        'enabled_feedback_types' => [
                            'instant_feedback_specific' => false,
                            'instant_feedback_generic' => false,
                            'instant_feedback_points' => false,
                            'instant_feedback_solution' => false
                        ],
                        'feedback_on_next_question' => false
                    ];
                }

                $vs['feedback_on_next_question'] = $vs['feedback_trigger'] === '1';
                return $vs;
            }
        );

        $instant_feedback = $f->optionalGroup(
            $this->getSubInputInstantFeedback($lng, $f),
            $lng->txt('tst_instant_feedback'),
            $lng->txt('tst_instant_feedback_desc')
        )->withValue(null)
            ->withAdditionalTransformation($constraint)
            ->withAdditionalTransformation($trafo);

        if ($this->isAnyInstantFeedbackOptionEnabled()) {
            $instant_feedback = $instant_feedback->withValue(
                [
                    'enabled_feedback_types' => [
                        'instant_feedback_specific' => (bool) $this->getInstantFeedbackSpecificEnabled(),
                        'instant_feedback_generic' => (bool) $this->getInstantFeedbackGenericEnabled(),
                        'instant_feedback_points' => (bool) $this->getInstantFeedbackPointsEnabled(),
                        'instant_feedback_solution' => (bool) $this->getInstantFeedbackSolutionEnabled()
                    ],
                    'feedback_trigger' => ($this->getForceInstantFeedbackOnNextQuestion() ? '1' : '0')
                ]
            );
        }

        if (!$environment['participant_data_exists']) {
            return $instant_feedback;
        }

        return $instant_feedback->withDisabled(true);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getInputLockAnswers()

ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour::getInputLockAnswers ( \ilLanguage  $lng, FieldFactory  $f, Refinery  $refinery, array  $environment  )

private

Definition at line 261 of file SettingsQuestionBehaviour.php.

References ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getAnswerFixationSettingsAsFormValue(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getTransformationLockAnswers(), ilLanguage\txt(), ILIAS\UI\Implementation\Component\Input\ViewControl\withAdditionalTransformation(), and ILIAS\UI\Implementation\Component\Input\withValue().

Referenced by ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\toForm().

     : Radio {
        $lock_answers = $f->radio(
            $lng->txt('tst_answer_fixation_handling')
        )->withOption(
            self::ANSWER_FIXATION_NONE,
            $lng->txt('tst_answer_fixation_none'),
            $lng->txt('tst_answer_fixation_none_desc')
        )->withOption(
            self::ANSWER_FIXATION_ON_INSTANT_FEEDBACK,
            $lng->txt('tst_answer_fixation_on_instant_feedback'),
            $lng->txt('tst_answer_fixation_on_instant_feedback_desc')
        )->withOption(
            self::ANSWER_FIXATION_ON_FOLLOWUP_QUESTION,
            $lng->txt('tst_answer_fixation_on_followup_question'),
            $lng->txt('tst_answer_fixation_on_followup_question_desc')
        )->withOption(
            self::ANSWER_FIXATION_ON_IFB_OR_FUQST,
            $lng->txt('tst_answer_fixation_on_instantfb_or_followupqst'),
            $lng->txt('tst_answer_fixation_on_instantfb_or_followupqst_desc')
        )->withValue(
            $this->getAnswerFixationSettingsAsFormValue()
        )->withAdditionalTransformation($this->getTransformationLockAnswers($refinery));

        if (!$environment['participant_data_exists']) {
            return $lock_answers;
        }

        return $lock_answers->withDisabled(true);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getInstantFeedbackGenericEnabled()

ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour::getInstantFeedbackGenericEnabled

(

)

Definition at line 492 of file SettingsQuestionBehaviour.php.

Referenced by ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getInputInstantFeedback(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\isAnyInstantFeedbackOptionEnabled(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\toLog(), and ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\toStorage().

                                                      : bool
    {
        return $this->instant_feedback_generic_enabled;
    }

Here is the caller graph for this function:

getInstantFeedbackPointsEnabled()

ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour::getInstantFeedbackPointsEnabled

(

)

Definition at line 480 of file SettingsQuestionBehaviour.php.

Referenced by ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getInputInstantFeedback(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\isAnyInstantFeedbackOptionEnabled(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\toLog(), and ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\toStorage().

                                                     : bool
    {
        return $this->instant_feedback_points_enabled;
    }

Here is the caller graph for this function:

getInstantFeedbackSolutionEnabled()

ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour::getInstantFeedbackSolutionEnabled

(

)

Definition at line 516 of file SettingsQuestionBehaviour.php.

Referenced by ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getInputInstantFeedback(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\isAnyInstantFeedbackOptionEnabled(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\toLog(), and ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\toStorage().

                                                       : bool
    {
        return $this->instant_feedback_solution_enabled;
    }

Here is the caller graph for this function:

getInstantFeedbackSpecificEnabled()

ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour::getInstantFeedbackSpecificEnabled

(

)

Definition at line 504 of file SettingsQuestionBehaviour.php.

Referenced by ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getInputInstantFeedback(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\isAnyInstantFeedbackOptionEnabled(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\toLog(), and ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\toStorage().

                                                       : bool
    {
        return $this->instant_feedback_specific_enabled;
    }

Here is the caller graph for this function:

getLockAnswerOnInstantFeedbackEnabled()

ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour::getLockAnswerOnInstantFeedbackEnabled

(

)

Definition at line 548 of file SettingsQuestionBehaviour.php.

Referenced by ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getAnswerFixationSettingsAsFormValue(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\toLog(), and ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\toStorage().

                                                           : bool
    {
        return $this->lock_answer_on_instant_feedback;
    }

Here is the caller graph for this function:

getLockAnswerOnNextQuestionEnabled()

ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour::getLockAnswerOnNextQuestionEnabled

(

)

Definition at line 560 of file SettingsQuestionBehaviour.php.

Referenced by ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getAnswerFixationSettingsAsFormValue(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\toLog(), and ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\toStorage().

                                                        : bool
    {
        return $this->lock_answer_on_next_question;
    }

Here is the caller graph for this function:

getQuestionHintsEnabled()

ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour::getQuestionHintsEnabled

(

)

Definition at line 468 of file SettingsQuestionBehaviour.php.

Referenced by ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\toForm(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\toLog(), and ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\toStorage().

                                             : bool
    {
        return $this->question_hints_enabled;
    }

Here is the caller graph for this function:

getQuestionTitleOutputMode()

ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour::getQuestionTitleOutputMode

(

)

Definition at line 420 of file SettingsQuestionBehaviour.php.

Referenced by ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\toForm(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\toLog(), and ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\toStorage().

                                                : int
    {
        return $this->question_title_output_mode;
    }

Here is the caller graph for this function:

getShuffleAndLockAnswersConstraint()

ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour::getShuffleAndLockAnswersConstraint ( \ilLanguage  $lng, Refinery  $refinery  )

private

Definition at line 328 of file SettingsQuestionBehaviour.php.

References ilLanguage\txt().

Referenced by ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\toForm().

     : Constraint {
        return $refinery->custom()->constraint(
            function ($vs): bool {
                if ($vs['shuffle_questions'] === true
                    && $vs['lock_answers']['lock_answer_on_next_question']) {
                    return false;
                }
                return true;
            },
            $lng->txt('tst_settings_conflict_shuffle_and_lock'),
        );
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getShuffleQuestions()

ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour::getShuffleQuestions

(

)

Definition at line 456 of file SettingsQuestionBehaviour.php.

Referenced by ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\toForm(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\toLog(), and ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\toStorage().

                                         : bool
    {
        return $this->shuffle_questions;
    }

Here is the caller graph for this function:

getSubInputInstantFeedback()

ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour::getSubInputInstantFeedback ( \ilLanguage  $lng, FieldFactory  $f  )

private

Definition at line 218 of file SettingsQuestionBehaviour.php.

References ilLanguage\txt().

Referenced by ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getInputInstantFeedback().

     : array {
        $feedback_options = [
            'instant_feedback_points' => $f->checkbox(
                $lng->txt('tst_instant_feedback_results'),
                $lng->txt('tst_instant_feedback_results_desc')
            ),
            'instant_feedback_generic' => $f->checkbox(
                $lng->txt('tst_instant_feedback_answer_generic'),
                $lng->txt('tst_instant_feedback_answer_generic_desc')
            ),
            'instant_feedback_specific' => $f->checkbox(
                $lng->txt('tst_instant_feedback_answer_specific'),
                $lng->txt('tst_instant_feedback_answer_specific_desc')
            ),
            'instant_feedback_solution' => $f->checkbox(
                $lng->txt('tst_instant_feedback_solution'),
                $lng->txt('tst_instant_feedback_solution_desc')
            )
        ];

        $sub_inputs_feedback['enabled_feedback_types'] = $f->group(
            $feedback_options,
            $lng->txt('tst_instant_feedback_contents')
        );

        $sub_inputs_feedback['feedback_trigger'] = $f->radio(
            $lng->txt('tst_instant_feedback_trigger')
        )->withOption(
            '0',
            $lng->txt('tst_instant_feedback_trigger_manual'),
            $lng->txt('tst_instant_feedback_trigger_manual_desc')
        )->withOption(
            '1',
            $lng->txt('tst_instant_feedback_trigger_forced'),
            $lng->txt('tst_instant_feedback_trigger_forced_desc')
        )->withRequired(true);

        return $sub_inputs_feedback;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getTransformationLockAnswers()

ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour::getTransformationLockAnswers ( Refinery  $refinery )

private

Definition at line 296 of file SettingsQuestionBehaviour.php.

References null.

Referenced by ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getInputLockAnswers().

                                                                     : Transformation
    {
        return $refinery->custom()->transformation(
            static function (?string $v): array {
                if ($v === null || $v === self::ANSWER_FIXATION_NONE) {
                    return [
                        'lock_answer_on_instant_feedback' => false,
                        'lock_answer_on_next_question' => false
                    ];
                }

                if ($v === self::ANSWER_FIXATION_ON_INSTANT_FEEDBACK) {
                    return [
                        'lock_answer_on_instant_feedback' => true,
                        'lock_answer_on_next_question' => false
                    ];
                }
                if ($v === self::ANSWER_FIXATION_ON_FOLLOWUP_QUESTION) {
                    return [
                        'lock_answer_on_instant_feedback' => false,
                        'lock_answer_on_next_question' => true
                    ];
                }

                return [
                    'lock_answer_on_instant_feedback' => true,
                    'lock_answer_on_next_question' => true
                ];
            }
        );
    }

Here is the caller graph for this function:

isAnyInstantFeedbackOptionEnabled()

ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour::isAnyInstantFeedbackOptionEnabled ( )

private

Definition at line 528 of file SettingsQuestionBehaviour.php.

References ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getInstantFeedbackGenericEnabled(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getInstantFeedbackPointsEnabled(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getInstantFeedbackSolutionEnabled(), and ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getInstantFeedbackSpecificEnabled().

Referenced by ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getInputInstantFeedback(), and ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\toLog().

                                                        : bool
    {
        return $this->getInstantFeedbackPointsEnabled()
            || $this->getInstantFeedbackGenericEnabled()
            || $this->getInstantFeedbackSpecificEnabled()
            || $this->getInstantFeedbackSolutionEnabled();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

toForm()

ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour::toForm	(	\ilLanguage	$lng,
		FieldFactory	$f,
		Refinery	$refinery,
		?array	$environment = null
	)

Returns

array<ILIAS>

Definition at line 64 of file SettingsQuestionBehaviour.php.

References ILIAS\UI\Implementation\Component\Input\$inputs, ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getInputAutosave(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getInputInstantFeedback(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getInputLockAnswers(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getQuestionHintsEnabled(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getQuestionTitleOutputMode(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getShuffleAndLockAnswersConstraint(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getShuffleQuestions(), ilLanguage\txt(), ILIAS\UI\Implementation\Component\Input\ViewControl\withAdditionalTransformation(), and ILIAS\UI\Implementation\Component\Input\withValue().

     : FormInput {
        $inputs['title_output'] = $f->radio($lng->txt('tst_title_output'))
            ->withOption('0', $lng->txt('tst_title_output_full'))
            ->withOption('1', $lng->txt('tst_title_output_hide_points'))
            ->withOption('3', $lng->txt('tst_title_output_only_points'))
            ->withOption('2', $lng->txt('tst_title_output_no_title'))
            ->withValue($this->getQuestionTitleOutputMode())
            ->withAdditionalTransformation($refinery->kindlyTo()->int())
        ;

        $inputs['autosave'] = $this->getInputAutosave($lng, $f, $refinery);

        $inputs['shuffle_questions'] = $f->checkbox(
            $lng->txt('tst_shuffle_questions'),
            $lng->txt('tst_shuffle_questions_description')
        )->withValue($this->getShuffleQuestions());

        $inputs['offer_hints'] = $f->checkbox(
            $lng->txt('tst_setting_offer_hints_label'),
            $lng->txt('tst_setting_offer_hints_info')
        )->withValue($this->getQuestionHintsEnabled());

        if ($environment['participant_data_exists']) {
            $inputs['shuffle_questions'] = $inputs['shuffle_questions']->withDisabled(true);
            $inputs['offer_hints'] = $inputs['offer_hints']->withDisabled(true);
        }

        $inputs['instant_feedback'] = $this->getInputInstantFeedback($lng, $f, $refinery, $environment);
        $inputs['lock_answers'] = $this->getInputLockAnswers($lng, $f, $refinery, $environment);

        $section = $f->section($inputs, $lng->txt('tst_presentation_properties'))
            ->withAdditionalTransformation($this->getShuffleAndLockAnswersConstraint($lng, $refinery));

        return $section;
    }

Here is the call graph for this function:

toLog()

ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour::toLog

(

AdditionalInformationGenerator

$additional_info

)

Definition at line 362 of file SettingsQuestionBehaviour.php.

References ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getAutosaveEnabled(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getAutosaveInterval(), ILIAS\Test\Logging\AdditionalInformationGenerator\getEnabledDisabledTagForBool(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getForceInstantFeedbackOnNextQuestion(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getInstantFeedbackGenericEnabled(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getInstantFeedbackPointsEnabled(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getInstantFeedbackSolutionEnabled(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getInstantFeedbackSpecificEnabled(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getLockAnswerOnInstantFeedbackEnabled(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getLockAnswerOnNextQuestionEnabled(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getQuestionHintsEnabled(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getQuestionTitleOutputMode(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getShuffleQuestions(), ILIAS\Test\Logging\AdditionalInformationGenerator\getTagForLangVar(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\isAnyInstantFeedbackOptionEnabled(), ILIAS\Test\Logging\AdditionalInformationGenerator\KEY_TEST_AUTOSAVE_ENABLED, ILIAS\Test\Logging\AdditionalInformationGenerator\KEY_TEST_FEEDBACK_ENABLED, ILIAS\Test\Logging\AdditionalInformationGenerator\KEY_TEST_FEEDBACK_SHOW_GENERIC, ILIAS\Test\Logging\AdditionalInformationGenerator\KEY_TEST_FEEDBACK_SHOW_POINTS, ILIAS\Test\Logging\AdditionalInformationGenerator\KEY_TEST_FEEDBACK_SHOW_SOLUTION, ILIAS\Test\Logging\AdditionalInformationGenerator\KEY_TEST_FEEDBACK_SHOW_SPECIFIC, ILIAS\Test\Logging\AdditionalInformationGenerator\KEY_TEST_FEEDBACK_TRIGGER, ILIAS\Test\Logging\AdditionalInformationGenerator\KEY_TEST_HINTS_ENABLED, ILIAS\Test\Logging\AdditionalInformationGenerator\KEY_TEST_LOCK_ANSWERS_MODE, ILIAS\Test\Logging\AdditionalInformationGenerator\KEY_TEST_SHUFFLE_QUESTIONS, and ILIAS\Test\Logging\AdditionalInformationGenerator\KEY_TEST_TITLE_PRESENTATION.

                                                                          : array
    {

        switch ($this->getQuestionTitleOutputMode()) {
            case 0:
                $log_array[AdditionalInformationGenerator::KEY_TEST_TITLE_PRESENTATION] = $additional_info
                    ->getTagForLangVar('tst_title_output_full');
                break;
            case 1:
                $log_array[AdditionalInformationGenerator::KEY_TEST_TITLE_PRESENTATION] = $additional_info
                    ->getTagForLangVar('tst_title_output_hide_points');
                break;
            case 2:
                $log_array[AdditionalInformationGenerator::KEY_TEST_TITLE_PRESENTATION] = $additional_info
                    ->getTagForLangVar('tst_title_output_no_title');
                break;
            case 3:
                $log_array[AdditionalInformationGenerator::KEY_TEST_TITLE_PRESENTATION] = $additional_info
                    ->getTagForLangVar('tst_title_output_only_points');
                break;
        }
        $log_array[AdditionalInformationGenerator::KEY_TEST_AUTOSAVE_ENABLED] = $this->getAutosaveEnabled()
            ? $this->getAutosaveInterval() / 1000 . ' ' . $additional_info->getTagForLangVar('seconds') : $additional_info->getEnabledDisabledTagForBool(false);
        $log_array[AdditionalInformationGenerator::KEY_TEST_SHUFFLE_QUESTIONS] = $additional_info
            ->getEnabledDisabledTagForBool($this->getShuffleQuestions());
        $log_array[AdditionalInformationGenerator::KEY_TEST_HINTS_ENABLED] = $additional_info
            ->getEnabledDisabledTagForBool($this->getQuestionHintsEnabled());

        $log_array[AdditionalInformationGenerator::KEY_TEST_FEEDBACK_ENABLED] = $additional_info
                    ->getEnabledDisabledTagForBool($this->isAnyInstantFeedbackOptionEnabled());
        if ($this->isAnyInstantFeedbackOptionEnabled()) {
            $log_array[AdditionalInformationGenerator::KEY_TEST_FEEDBACK_SHOW_POINTS] = $additional_info
                ->getEnabledDisabledTagForBool($this->getInstantFeedbackPointsEnabled());
            $log_array[AdditionalInformationGenerator::KEY_TEST_FEEDBACK_SHOW_GENERIC] = $additional_info
                ->getEnabledDisabledTagForBool($this->getInstantFeedbackGenericEnabled());
            $log_array[AdditionalInformationGenerator::KEY_TEST_FEEDBACK_SHOW_SPECIFIC] = $additional_info
                ->getEnabledDisabledTagForBool($this->getInstantFeedbackSpecificEnabled());
            $log_array[AdditionalInformationGenerator::KEY_TEST_FEEDBACK_SHOW_SOLUTION] = $additional_info
                ->getEnabledDisabledTagForBool($this->getInstantFeedbackSolutionEnabled());
            $log_array[AdditionalInformationGenerator::KEY_TEST_FEEDBACK_TRIGGER] = $this->getForceInstantFeedbackOnNextQuestion()
                ? $additional_info->getTagForLangVar('tst_instant_feedback_trigger_forced')
                : $additional_info->getTagForLangVar('tst_instant_feedback_trigger_manual');
        }

        $lock_answers = $additional_info->getTagForLangVar('tst_answer_fixation_none');
        if ($this->getLockAnswerOnInstantFeedbackEnabled()
            && $this->getLockAnswerOnNextQuestionEnabled()) {
            $lock_answers = $additional_info->getTagForLangVar('tst_answer_fixation_on_instantfb_or_followupqst');
        } elseif ($this->getLockAnswerOnInstantFeedbackEnabled()) {
            $lock_answers = $additional_info->getTagForLangVar('tst_answer_fixation_on_instant_feedback');
        } elseif ($this->getLockAnswerOnNextQuestionEnabled()) {
            $lock_answers = $additional_info->getTagForLangVar('tst_answer_fixation_on_followup_question');
        }
        $log_array[AdditionalInformationGenerator::KEY_TEST_LOCK_ANSWERS_MODE] = $lock_answers;

        return $log_array;
    }

Here is the call graph for this function:

toStorage()

ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour::toStorage

(

)

Definition at line 344 of file SettingsQuestionBehaviour.php.

References ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getAutosaveEnabled(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getAutosaveInterval(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getForceInstantFeedbackOnNextQuestion(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getInstantFeedbackGenericEnabled(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getInstantFeedbackPointsEnabled(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getInstantFeedbackSolutionEnabled(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getInstantFeedbackSpecificEnabled(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getLockAnswerOnInstantFeedbackEnabled(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getLockAnswerOnNextQuestionEnabled(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getQuestionHintsEnabled(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getQuestionTitleOutputMode(), ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour\getShuffleQuestions(), and ILIAS\Repository\int().

                               : array
    {
        return [
            'title_output' => ['integer', $this->getQuestionTitleOutputMode()],
            'autosave' => ['integer', (int) $this->getAutosaveEnabled()],
            'autosave_ival' => ['integer', $this->getAutosaveInterval()],
            'shuffle_questions' => ['integer', (int) $this->getShuffleQuestions()],
            'offer_question_hints' => ['integer', (int) $this->getQuestionHintsEnabled()],
            'answer_feedback_points' => ['integer', (int) $this->getInstantFeedbackPointsEnabled()],
            'answer_feedback' => ['integer', (int) $this->getInstantFeedbackGenericEnabled()],
            'specific_feedback' => ['integer', (int) $this->getInstantFeedbackSpecificEnabled()],
            'instant_verification' => ['integer', (int) $this->getInstantFeedbackSolutionEnabled()],
            'force_inst_fb' => ['integer', (int) $this->getForceInstantFeedbackOnNextQuestion()],
            'inst_fb_answer_fixation' => ['integer', (int) $this->getLockAnswerOnInstantFeedbackEnabled()],
            'follow_qst_answer_fixation' => ['integer', (int) $this->getLockAnswerOnNextQuestionEnabled()]
        ];
    }

Here is the call graph for this function:

withAutosaveEnabled()

ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour::withAutosaveEnabled

(

bool

$autosave_enabled

)

Definition at line 437 of file SettingsQuestionBehaviour.php.

                                                               : self
    {
        $clone = clone $this;
        $clone->autosave_enabled = $autosave_enabled;
        return $clone;
    }

withAutosaveInterval()

ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour::withAutosaveInterval

(

int

$autosave_interval

)

Definition at line 449 of file SettingsQuestionBehaviour.php.

                                                                : self
    {
        $clone = clone $this;
        $clone->autosave_interval = $autosave_interval;
        return $clone;
    }

withForceInstantFeedbackOnNextQuestion()

ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour::withForceInstantFeedbackOnNextQuestion

(

bool

$force_instant_feedback_on_next_question

)

Definition at line 541 of file SettingsQuestionBehaviour.php.

                                                                                                         : self
    {
        $clone = clone $this;
        $clone->force_instant_feedback_on_next_question = $force_instant_feedback_on_next_question;
        return $clone;
    }

withInstantFeedbackGenericEnabled()

ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour::withInstantFeedbackGenericEnabled

(

bool

$instant_feedback_generic_enabled

)

Definition at line 497 of file SettingsQuestionBehaviour.php.

                                                                                             : self
    {
        $clone = clone $this;
        $clone->instant_feedback_generic_enabled = $instant_feedback_generic_enabled;
        return $clone;
    }

withInstantFeedbackPointsEnabled()

ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour::withInstantFeedbackPointsEnabled

(

bool

$instant_feedback_points_enabled

)

Definition at line 485 of file SettingsQuestionBehaviour.php.

                                                                                           : self
    {
        $clone = clone $this;
        $clone->instant_feedback_points_enabled = $instant_feedback_points_enabled;
        return $clone;
    }

withInstantFeedbackSolutionEnabled()

ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour::withInstantFeedbackSolutionEnabled

(

bool

$instant_feedback_solution_enabled

)

Definition at line 521 of file SettingsQuestionBehaviour.php.

                                                                                               : self
    {
        $clone = clone $this;
        $clone->instant_feedback_solution_enabled = $instant_feedback_solution_enabled;
        return $clone;
    }

withInstantFeedbackSpecificEnabled()

ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour::withInstantFeedbackSpecificEnabled

(

bool

$instant_feedback_specific_enabled

)

Definition at line 509 of file SettingsQuestionBehaviour.php.

                                                                                               : self
    {
        $clone = clone $this;
        $clone->instant_feedback_specific_enabled = $instant_feedback_specific_enabled;
        return $clone;
    }

withLockAnswerOnInstantFeedbackEnabled()

ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour::withLockAnswerOnInstantFeedbackEnabled

(

bool

$lock_answer_on_instant_feedback

)

Definition at line 553 of file SettingsQuestionBehaviour.php.

                                                                                                 : self
    {
        $clone = clone $this;
        $clone->lock_answer_on_instant_feedback = $lock_answer_on_instant_feedback;
        return $clone;
    }

withLockAnswerOnNextQuestionEnabled()

ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour::withLockAnswerOnNextQuestionEnabled

(

bool

$lock_answer_on_next_question

)

Definition at line 565 of file SettingsQuestionBehaviour.php.

                                                                                           : self
    {
        $clone = clone $this;
        $clone->lock_answer_on_next_question = $lock_answer_on_next_question;
        return $clone;
    }

withQuestionHintsEnabled()

ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour::withQuestionHintsEnabled

(

bool

$question_hints_enabled

)

Definition at line 473 of file SettingsQuestionBehaviour.php.

                                                                          : self
    {
        $clone = clone $this;
        $clone->question_hints_enabled = $question_hints_enabled;
        return $clone;
    }

withQuestionTitleOutputMode()

ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour::withQuestionTitleOutputMode

(

int

$question_title_output_mode

)

Definition at line 425 of file SettingsQuestionBehaviour.php.

Referenced by ILIAS\Test\Settings\MainSettings\SettingsMainGUI\getQuestionBehaviourSettingsForStorage().

                                                                                : self
    {
        $clone = clone $this;
        $clone->question_title_output_mode = $question_title_output_mode;
        return $clone;
    }

Here is the caller graph for this function:

withShuffleQuestions()

ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour::withShuffleQuestions

(

bool

$shuffle_questions

)

Definition at line 461 of file SettingsQuestionBehaviour.php.

                                                                 : self
    {
        $clone = clone $this;
        $clone->shuffle_questions = $shuffle_questions;
        return $clone;
    }

Field Documentation

ANSWER_FIXATION_NONE

const ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour::ANSWER_FIXATION_NONE = 'none'

Definition at line 37 of file SettingsQuestionBehaviour.php.

ANSWER_FIXATION_ON_FOLLOWUP_QUESTION

const ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour::ANSWER_FIXATION_ON_FOLLOWUP_QUESTION = 'followup_question'

Definition at line 39 of file SettingsQuestionBehaviour.php.

ANSWER_FIXATION_ON_IFB_OR_FUQST

const ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour::ANSWER_FIXATION_ON_IFB_OR_FUQST = 'ifb_or_fuqst'

Definition at line 40 of file SettingsQuestionBehaviour.php.

ANSWER_FIXATION_ON_INSTANT_FEEDBACK

const ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour::ANSWER_FIXATION_ON_INSTANT_FEEDBACK = 'instant_feedback'

Definition at line 38 of file SettingsQuestionBehaviour.php.

DEFAULT_AUTOSAVE_INTERVAL

const ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour::DEFAULT_AUTOSAVE_INTERVAL = 30000

private

Definition at line 35 of file SettingsQuestionBehaviour.php.

---

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

• components/ILIAS/Test/src/Settings/MainSettings/SettingsQuestionBehaviour.php