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 $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)

	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, array $environment)

	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	$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 558 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 430 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 442 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 522 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 99 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 142 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, $environment),
             $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 262 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 478 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 466 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 502 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 490 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 534 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 546 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:

◆ getQuestionTitleOutputMode()

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

Definition at line 418 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 329 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 454 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,
		array	$environment
	)

private

Definition at line 212 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')
         );
 
         if (!$environment['participant_data_exists']) {
             $sub_inputs_feedback['feedback_trigger'] = $sub_inputs_feedback['feedback_trigger']
                 ->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 297 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 514 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 63 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\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'),
             $lng->txt('tst_title_output_info')
         )->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());
 
         if ($environment['participant_data_exists']) {
             $inputs['shuffle_questions'] = $inputs['shuffle_questions']->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.

                                                                           : 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_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 345 of file SettingsQuestionBehaviour.php.

                                : array
     {
         return [
             'title_output' => ['integer', $this->getQuestionTitleOutputMode()],
             'autosave' => ['integer', (int) $this->getAutosaveEnabled()],
             'autosave_ival' => ['integer', $this->getAutosaveInterval()],
             'shuffle_questions' => ['integer', (int) $this->getShuffleQuestions()],
             '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 435 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 447 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 527 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 483 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 471 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 507 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 495 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 539 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 551 of file SettingsQuestionBehaviour.php.

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

◆ withQuestionTitleOutputMode()

ILIAS\Test\Settings\MainSettings\SettingsQuestionBehaviour::withQuestionTitleOutputMode ( int $question_title_output_mode )

Definition at line 423 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 459 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

Public Member Functions

Data Fields

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ getAnswerFixationSettingsAsFormValue()

◆ getAutosaveEnabled()

◆ getAutosaveInterval()

◆ getForceInstantFeedbackOnNextQuestion()

◆ getInputAutosave()

◆ getInputInstantFeedback()

◆ getInputLockAnswers()

◆ getInstantFeedbackGenericEnabled()

◆ getInstantFeedbackPointsEnabled()

◆ getInstantFeedbackSolutionEnabled()

◆ getInstantFeedbackSpecificEnabled()

◆ getLockAnswerOnInstantFeedbackEnabled()

◆ getLockAnswerOnNextQuestionEnabled()

◆ getQuestionTitleOutputMode()

◆ getShuffleAndLockAnswersConstraint()

◆ getShuffleQuestions()

◆ getSubInputInstantFeedback()

◆ getTransformationLockAnswers()

◆ isAnyInstantFeedbackOptionEnabled()

◆ toForm()

◆ toLog()

◆ toStorage()

◆ withAutosaveEnabled()

◆ withAutosaveInterval()

◆ withForceInstantFeedbackOnNextQuestion()

◆ withInstantFeedbackGenericEnabled()

◆ withInstantFeedbackPointsEnabled()

◆ withInstantFeedbackSolutionEnabled()

◆ withInstantFeedbackSpecificEnabled()

◆ withLockAnswerOnInstantFeedbackEnabled()

◆ withLockAnswerOnNextQuestionEnabled()

◆ withQuestionTitleOutputMode()

◆ withShuffleQuestions()

Field Documentation

◆ ANSWER_FIXATION_NONE

◆ ANSWER_FIXATION_ON_FOLLOWUP_QUESTION

◆ ANSWER_FIXATION_ON_IFB_OR_FUQST

◆ ANSWER_FIXATION_ON_INSTANT_FEEDBACK

◆ DEFAULT_AUTOSAVE_INTERVAL