ilObjTestSettingsMainGUI: ilPropertyFormGUI ilObjTestSettingsMainGUI: ilConfirmationGUI ilObjTestSettingsMainGUI: ilTestSettingsChangeConfirmationGUI More...

Inheritance diagram for ilObjTestSettingsMainGUI:

Collaboration diagram for ilObjTestSettingsMainGUI:

Public Member Functions
	executeCommand ()
	Command Execution. More...

Public Member Functions inherited from ilTestSettingsGUI
	__construct (protected ilObjTest $test_object)

Data Fields
const	CMD_SHOW_FORM = 'showForm'
	command constants More...

const	CMD_SAVE_FORM = 'saveForm'

const	CMD_CONFIRMED_SAVE_FORM = 'confirmedSaveForm'

const	CMD_SHOW_RESET_TPL_CONFIRM = 'showResetTemplateConfirmation'

const	CMD_CONFIRMED_RESET_TPL = 'confirmedResetTemplate'

Protected Member Functions
	getPresentationSettingsSection ()

	savePresentationSettingsSection (array $section)

	getAdditionalFunctionalitySettingsSections (array $environment)

	getOrganisationalUnitsActivationInput ()

	saveAdditionalFunctionalitySettingsSection (array $sections)

	saveOrganisationalUnitsActivation (bool $activation)

	getAdditionalFunctionalitySettingsForStorage (array $section)

Protected Member Functions inherited from ilTestSettingsGUI
	formPropertyExists (ilPropertyFormGUI $form, $propertyId)

Protected Attributes
ilTabsGUI	$tabs

ilToolbarGUI	$toolbar

UIServices	$ui

ilGlobalTemplateInterface	$tpl

ilObjTestMainSettings	$main_settings

MainSettingsRepository	$main_settings_repository

Refinery	$refinery

ServerRequestInterface	$request

ilObjectDataCache	$object_data_cache

ilSetting	$settings

Private Member Functions
	showOldIntroduction ()

	showOldConcludingRemarks ()

	showForm (StandardForm $form=null, InterruptiveModal $modal=null)

	confirmedSaveForm ()

	saveForm ()

	finalizeSave (array $data)

	buildForm ()

	getFormConstraints ()

	populateConfirmationModal (string $current_question_set_type, string $new_question_set_type)

	performSaveForm (array $data)

	removeAllParticipantsIfRequired ()

	getGeneralSettingsSection (array $environment)

	getGeneralSettingsForStorage (array $section)

	getAvailabilitySettingsSection ()

	getIsOnlineSettingInput ()

	getTimebasedAvailabilityInputs ()

	getTransformationForActivationLimitedOptionalGroup ()

	getValueForActivationLimitedOptionalGroup ()

	saveAvailabilitySettingsSection (array $section)

	getIntroductionSettingsForStorage (array $section)

	getAccessSettingsForStorage (array $section)

	getTestBehaviourSettingsForStorage (array $section)

	getQuestionBehaviourSettingsForStorage (array $section)

	getParticipantsFunctionalitySettingsForStorage (array $section)

	getFinishingSettingsForStorage (array $section)

Private Attributes
const	GENERAL_SETTINGS_SECTION_LABEL = 'general_settings'

const	AVAILABILITY_SETTINGS_SECTION_LABEL = 'availability settings'

const	PRESENTATION_SETTINGS_SECTION_LABEL = 'presentation_settings'

const	INTRODUCTION_SETTINGS_SECTION_LABEL = 'introduction_settings'

const	ACCESS_SETTINGS_LABEL = 'access_settings'

const	TEST_BEHAVIOUR_SETTINGS_LABEL = 'test_behaviour_settings'

const	QUESTION_BEHAVIOUR_SETTINGS_LABEL = 'question_behaviour_settings'

const	PARTICIPANTS_FUNCTIONALITY_SETTINGS_LABEL = 'participants_functionality_settings'

const	FINISH_TEST_SETTINGS_LABEL = 'finish_test_settings'

const	ECS_FUNCTIONALITY_SETTINGS_LABEL = 'ecs_settings'

const	ADDITIONAL_FUNCTIONALITY_SETTINGS_LABEL = 'additional_functionality_settings'

ilTestQuestionSetConfigFactory	$testQuestionSetConfigFactory

Detailed Description

ilObjTestSettingsMainGUI: ilPropertyFormGUI ilObjTestSettingsMainGUI: ilConfirmationGUI ilObjTestSettingsMainGUI: ilTestSettingsChangeConfirmationGUI

Definition at line 42 of file class.ilObjTestSettingsMainGUI.php.

Member Function Documentation

◆ buildForm()

ilObjTestSettingsMainGUI::buildForm ( )

private

Definition at line 247 of file class.ilObjTestSettingsMainGUI.php.

References ILIAS\UI\Implementation\Component\Input\$inputs, $lng, $refinery, ILIAS\Repository\ctrl(), getAdditionalFunctionalitySettingsSections(), getAvailabilitySettingsSection(), getFormConstraints(), getGeneralSettingsSection(), getPresentationSettingsSection(), ILIAS\Repository\ui(), and ILIAS\UI\Implementation\Component\Input\ViewControl\withAdditionalTransformation().

Referenced by confirmedSaveForm(), saveForm(), and showForm().

                                 : StandardForm
     {
         $lng = $this->lng;
         $input_factory = $this->ui->factory()->input();
         $refinery = $this->refinery;
 
         $data_factory = new DataFactory();
         $user_format = $this->activeUser->getDateFormat();
 
         $environment['participant_data_exists'] = $this->test_object->participantDataExist();
         $environment['user_date_format'] = $data_factory->dateFormat()->withTime24($user_format);
         $environment['user_time_zone'] = $this->activeUser->getTimeZone();
 
         $main_inputs = [
             self::GENERAL_SETTINGS_SECTION_LABEL => $this->getGeneralSettingsSection($environment),
             self::AVAILABILITY_SETTINGS_SECTION_LABEL => $this->getAvailabilitySettingsSection(),
             self::PRESENTATION_SETTINGS_SECTION_LABEL => $this->getPresentationSettingsSection(),
             self::INTRODUCTION_SETTINGS_SECTION_LABEL => $this->main_settings->getIntroductionSettings()
                 ->toForm($lng, $input_factory->field(), $refinery),
             self::ACCESS_SETTINGS_LABEL => $this->main_settings->getAccessSettings()
                 ->toForm($lng, $input_factory->field(), $refinery, $environment),
             self::TEST_BEHAVIOUR_SETTINGS_LABEL => $this->main_settings->getTestBehaviourSettings()
                 ->toForm($lng, $input_factory->field(), $refinery, $environment),
             self::QUESTION_BEHAVIOUR_SETTINGS_LABEL => $this->main_settings->getQuestionBehaviourSettings()
                 ->toForm($lng, $input_factory->field(), $refinery, $environment),
             self::PARTICIPANTS_FUNCTIONALITY_SETTINGS_LABEL => $this->main_settings->getParticipantFunctionalitySettings()
                 ->toForm($lng, $input_factory->field(), $refinery, $environment),
             self::FINISH_TEST_SETTINGS_LABEL => $this->main_settings->getFinishingSettings()
                 ->toForm($lng, $input_factory->field(), $refinery)
         ];
 
         $inputs = array_merge($main_inputs, $this->getAdditionalFunctionalitySettingsSections($environment));
 
         return $input_factory->container()->form()->standard(
             $this->ctrl->getFormActionByClass(self::class, self::CMD_SAVE_FORM),
             $inputs
         )->withAdditionalTransformation($this->getFormConstraints());
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ confirmedSaveForm()

ilObjTestSettingsMainGUI::confirmedSaveForm ( )

private

Definition at line 198 of file class.ilObjTestSettingsMainGUI.php.

References $data, buildForm(), finalizeSave(), and showForm().

                                         : void
     {
         $form = $this->buildForm()->withRequest($this->request);
         $data = $form->getData();
         if ($data === null) {
             $this->showForm($form);
             return;
         }
 
         $data[self::AVAILABILITY_SETTINGS_SECTION_LABEL]['is_online'] =
             $this->test_object->getObjectProperties()->getPropertyIsOnline()->withOffline();
         $this->testQuestionSetConfigFactory->getQuestionSetConfig()->removeQuestionSetRelatedData();
 
         $this->finalizeSave($data);
     }

Here is the call graph for this function:

◆ executeCommand()

ilObjTestSettingsMainGUI::executeCommand ( )

Command Execution.

Definition at line 122 of file class.ilObjTestSettingsMainGUI.php.

References ILIAS\Repository\access(), ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), ilTestTabsManager\SUBTAB_ID_GENERAL_SETTINGS, ilTestTabsManager\TAB_ID_SETTINGS, and ILIAS\Repository\tabs().

     {
         if (!$this->access->checkAccess('write', '', $this->test_gui->getRefId())) {
             $this->tpl->setOnScreenMessage('info', $this->lng->txt('cannot_edit_test'), true);
             $this->ctrl->redirect($this->test_gui, 'infoScreen');
         }
 
         $cmd = $this->ctrl->getCmd(self::CMD_SHOW_FORM);
         $this->$cmd();
 
         $this->object_data_cache->deleteCachedEntry($this->test_object->getId());
         $this->test_gui->prepareOutput();
         $this->tabs->activateTab(ilTestTabsManager::TAB_ID_SETTINGS);
         $this->tabs->activateSubTab(ilTestTabsManager::SUBTAB_ID_GENERAL_SETTINGS);
     }

Here is the call graph for this function:

◆ finalizeSave()

ilObjTestSettingsMainGUI::finalizeSave ( array $data )

private

Definition at line 238 of file class.ilObjTestSettingsMainGUI.php.

References ILIAS\Repository\lng(), performSaveForm(), removeAllParticipantsIfRequired(), and showForm().

Referenced by confirmedSaveForm(), and saveForm().

                                               : void
     {
         $this->performSaveForm($data);
         $this->removeAllParticipantsIfRequired();
 
         $this->tpl->setOnScreenMessage('success', $this->lng->txt('msg_obj_modified'), true);
         $this->showForm();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getAccessSettingsForStorage()

ilObjTestSettingsMainGUI::getAccessSettingsForStorage ( array $section )

private

Definition at line 592 of file class.ilObjTestSettingsMainGUI.php.

References ilObjTestSettingsAccess\withStartTimeEnabled().

Referenced by performSaveForm().

                                                                 : ilObjTestSettingsAccess
     {
         $access_settings = $this->main_settings->getAccessSettings()
             ->withStartTimeEnabled($section['access_window']['start_time_enabled'])
             ->withStartTime($section['access_window']['start_time'])
             ->withEndTimeEnabled($section['access_window']['end_time_enabled'])
             ->withEndTime($section['access_window']['end_time'])
             ->withPasswordEnabled($section['test_password']['password_enabled'])
             ->withPassword($section['test_password']['password_value'])
             ->withFixedParticipants($section['fixed_participants_enabled']);
 
         if ($this->test_object->participantDataExist()) {
             return $access_settings;
         }
 
         return $access_settings->withStartTimeEnabled($section['access_window']['start_time_enabled'])
             ->withStartTime($section['access_window']['start_time']);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getAdditionalFunctionalitySettingsForStorage()

ilObjTestSettingsMainGUI::getAdditionalFunctionalitySettingsForStorage ( array $section )

protected

Definition at line 767 of file class.ilObjTestSettingsMainGUI.php.

References ilObjTestSettingsAdditional\withHideInfoTab().

Referenced by performSaveForm().

                                                                                    : ilObjTestSettingsAdditional
     {
         $additional_settings = $this->main_settings->getAdditionalSettings()->withHideInfoTab($section['hide_info_tab']);
 
         if ($this->test_object->participantDataExist()) {
             return $additional_settings;
         }
 
         if (!(new ilSkillManagementSettings())->isActivated()) {
             return $additional_settings->withSkillsServiceEnabled(false);
         }
 
         return $additional_settings->withSkillsServiceEnabled($section['skills_service_activation']);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getAdditionalFunctionalitySettingsSections()

ilObjTestSettingsMainGUI::getAdditionalFunctionalitySettingsSections ( array $environment )

protected

Definition at line 679 of file class.ilObjTestSettingsMainGUI.php.

References ILIAS\UI\Implementation\Component\Input\$inputs, $refinery, getOrganisationalUnitsActivationInput(), ILIAS\Repository\lng(), and ILIAS\Repository\ui().

Referenced by buildForm().

                                                                                      : array
     {
         $sections = [];
 
         $ecs = new ilECSTestSettings($this->test_object);
         $ecs_section = $ecs->getSettingsSection(
             $this->ui->factory()->input()->field(),
             $this->refinery
         );
 
         if ($ecs_section !== null) {
             $sections[self::ECS_FUNCTIONALITY_SETTINGS_LABEL] = $ecs_section;
         }
 
         $inputs['organisational_units_activation'] = $this->getOrganisationalUnitsActivationInput();
 
         $inputs += $this->main_settings->getAdditionalSettings()->toForm(
             $this->lng,
             $this->ui->factory()->input()->field(),
             $this->refinery,
             $environment
         );
 
         $inputs = array_filter($inputs, fn($v) => $v !== null);
 
         if (count($inputs) > 0) {
             $sections[self::ADDITIONAL_FUNCTIONALITY_SETTINGS_LABEL] = $this->ui->factory()->input()->field()
                 ->section($inputs, $this->lng->txt('obj_features'));
         }
 
         return $sections;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getAvailabilitySettingsSection()

ilObjTestSettingsMainGUI::getAvailabilitySettingsSection ( )

private

Definition at line 426 of file class.ilObjTestSettingsMainGUI.php.

References ILIAS\UI\Implementation\Component\Input\$inputs, getIsOnlineSettingInput(), getTimebasedAvailabilityInputs(), ILIAS\Repository\lng(), and ILIAS\Repository\ui().

Referenced by buildForm().

                                                      : Section
     {
         $input_factory = $this->ui->factory()->input();
 
         $inputs['is_online'] = $this->getIsOnlineSettingInput();
         $inputs['timebased_availability'] = $this->getTimebasedAvailabilityInputs();
 
         return $input_factory->field()->section(
             $inputs,
             $this->lng->txt('rep_activation_availability')
         );
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getFinishingSettingsForStorage()

ilObjTestSettingsMainGUI::getFinishingSettingsForStorage ( array $section )

private

Definition at line 666 of file class.ilObjTestSettingsMainGUI.php.

References ilObjTestSettingsFinishing\withShowAnswerOverview().

Referenced by performSaveForm().

                                                                    : ilObjTestSettingsFinishing
     {
         $redirect_after_finish = $section['redirect_after_finish'];
         $finish_notification = $section['finish_notification'];
         return $this->main_settings->getFinishingSettings()
             ->withShowAnswerOverview($section['show_answer_overview'])
             ->withConcludingRemarksEnabled($section['show_concluding_remarks'])
             ->withRedirectionMode($redirect_after_finish['redirect_mode'])
             ->withRedirectionUrl($redirect_after_finish['redirect_url'])
             ->withMailNotificationContentType($finish_notification['notification_content_type'])
             ->withAlwaysSendMailNotification($finish_notification['always_notify']);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getFormConstraints()

ilObjTestSettingsMainGUI::getFormConstraints ( )

private

Definition at line 286 of file class.ilObjTestSettingsMainGUI.php.

References ILIAS\Repository\lng(), and ILIAS\Repository\refinery().

Referenced by buildForm().

                                          : Constraint
     {
         return $this->refinery->custom()->constraint(
             function (array $vs): bool {
                 if ($vs[self::PARTICIPANTS_FUNCTIONALITY_SETTINGS_LABEL]['postponed_questions_behaviour'] === true
                     && $vs[self::QUESTION_BEHAVIOUR_SETTINGS_LABEL]['lock_answers']['lock_answer_on_next_question']) {
                     return false;
                 }
                 return true;
             },
             $this->lng->txt('tst_settings_conflict_postpone_and_lock')
         );
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getGeneralSettingsForStorage()

ilObjTestSettingsMainGUI::getGeneralSettingsForStorage ( array $section )

private

Parameters

ilPropertyFormGUI $form

Definition at line 415 of file class.ilObjTestSettingsMainGUI.php.

References ilObjTestSettingsGeneral\withQuestionSetType().

Referenced by performSaveForm().

                                                                  : ilObjTestSettingsGeneral
     {
         if ($this->test_object->participantDataExist()) {
             return $this->main_settings->getGeneralSettings();
         }
 
         return $this->main_settings->getGeneralSettings()
             ->withQuestionSetType($section['question_set_type'])
             ->withAnonymity($section['anonymity']);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getGeneralSettingsSection()

ilObjTestSettingsMainGUI::getGeneralSettingsSection ( array $environment )

private

Definition at line 397 of file class.ilObjTestSettingsMainGUI.php.

References ILIAS\UI\Implementation\Component\Input\$inputs, ILIAS\Repository\lng(), ILIAS\Repository\refinery(), and ILIAS\Repository\ui().

Referenced by buildForm().

                                                                   : Section
     {
         $field_factory = $this->ui->factory()->input()->field();
 
         $inputs['title_and_description'] = $this->test_object->getObjectProperties()->getPropertyTitleAndDescription()
             ->toForm($this->lng, $field_factory, $this->refinery);
         $inputs += $this->main_settings->getGeneralSettings()
             ->toForm($this->lng, $field_factory, $this->refinery, $environment);
 
         return $field_factory->section(
             $inputs,
             $this->lng->txt('tst_general_properties')
         );
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getIntroductionSettingsForStorage()

ilObjTestSettingsMainGUI::getIntroductionSettingsForStorage ( array $section )

private

Definition at line 585 of file class.ilObjTestSettingsMainGUI.php.

References ilObjTestSettingsIntroduction\withIntroductionEnabled().

Referenced by performSaveForm().

                                                                       : ilObjTestSettingsIntroduction
     {
         return $this->main_settings->getIntroductionSettings()
             ->withIntroductionEnabled($section['introduction_enabled'])
             ->withExamConditionsCheckboxEnabled($section['conditions_checkbox_enabled']);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getIsOnlineSettingInput()

ilObjTestSettingsMainGUI::getIsOnlineSettingInput ( )

private

Definition at line 439 of file class.ilObjTestSettingsMainGUI.php.

References ilObject\_getAllReferences(), ILIAS\Repository\lng(), ILIAS\Repository\refinery(), and ILIAS\Repository\ui().

Referenced by getAvailabilitySettingsSection().

                                               : Checkbox
     {
         $field_factory = $this->ui->factory()->input()->field();
 
         $question_set_config_complete = $this->test_object->isComplete(
             $this->testQuestionSetConfigFactory->getQuestionSetConfig()
         );
 
         $is_online = $this->test_object->getObjectProperties()->getPropertyIsOnline()
             ->toForm($this->lng, $field_factory, $this->refinery);
 
         if (sizeof(ilObject::_getAllReferences($this->test_object->getId())) > 1) {
             $is_online = $is_online->withByline(
                 $is_online->getByline() . ' ' . $this->lng->txt('rep_activation_online_object_info')
             );
         }
 
         if (!$question_set_config_complete) {
             $is_online = $is_online
                 ->withByline($this->lng->txt('cannot_switch_to_online_no_questions_andor_no_mark_steps'))
                 ->withDisabled(true);
         }
 
         return $is_online;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getOrganisationalUnitsActivationInput()

ilObjTestSettingsMainGUI::getOrganisationalUnitsActivationInput ( )

protected

Definition at line 712 of file class.ilObjTestSettingsMainGUI.php.

References ilOrgUnitObjectTypePositionSetting\DEFAULT_ON, ilOrgUnitGlobalSettings\getInstance(), ILIAS\Repository\lng(), ILIAS\Repository\ui(), and ILIAS\UI\Implementation\Component\Input\withValue().

Referenced by getAdditionalFunctionalitySettingsSections().

                                                               : ?Checkbox
     {
         $position_settings = ilOrgUnitGlobalSettings::getInstance()->getObjectPositionSettingsByType(
             $this->test_object->getType()
         );
         if (!$position_settings->isActive()) {
             return null;
         }
 
         $enable_organisational_units_access = $this->ui->factory()->input()->field()
             ->checkbox(
                 $this->lng->txt('obj_orgunit_positions'),
                 $this->lng->txt('obj_orgunit_positions_info')
             )->withValue(
                 (new \ilOrgUnitObjectPositionSetting($this->test_object->getId()))->isActive()
                     ?? $position_settings->getActivationDefault() === \ilOrgUnitObjectTypePositionSetting::DEFAULT_ON
             );
         if (!$position_settings->isChangeableForObject()) {
             return $enable_organisational_units_access->withDisabled(true);
         }
         return $enable_organisational_units_access;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getParticipantsFunctionalitySettingsForStorage()

ilObjTestSettingsMainGUI::getParticipantsFunctionalitySettingsForStorage ( array $section )

private

Definition at line 655 of file class.ilObjTestSettingsMainGUI.php.

References ilObjTestSettingsParticipantFunctionality\withUsePreviousAnswerAllowed().

Referenced by performSaveForm().

                                                                                    : ilObjTestSettingsParticipantFunctionality
     {
         return $this->main_settings->getParticipantFunctionalitySettings()
             ->withUsePreviousAnswerAllowed($section['use_previous_answers'])
             ->withSuspendTestAllowed($section['allow_suspend_test'])
             ->withPostponedQuestionsMoveToEnd($section['postponed_questions_behaviour'])
             ->withUsrPassOverviewMode($section['usr_pass_overview'])
             ->withQuestionMarkingEnabled($section['enable_question_marking'])
             ->withQuestionListEnabled($section['enable_question_list']);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getPresentationSettingsSection()

ilObjTestSettingsMainGUI::getPresentationSettingsSection ( )

protected

Definition at line 558 of file class.ilObjTestSettingsMainGUI.php.

References ILIAS\UI\Implementation\Component\Input\$inputs, $refinery, ILIAS\Repository\lng(), and ILIAS\Repository\ui().

Referenced by buildForm().

                                                        : Section
     {
         $input_factory = $this->ui->factory()->input();
 
         $custom_icon_input = $this->test_object->getObjectProperties()->getPropertyIcon()
             ->toForm($this->lng, $input_factory->field(), $this->refinery);
 
         if ($custom_icon_input !== null) {
             $inputs['custom_icon'] = $custom_icon_input;
         }
         $inputs['tile_image'] = $this->test_object->getObjectProperties()->getPropertyTileImage()
             ->toForm($this->lng, $input_factory->field(), $this->refinery);
 
         return $input_factory->field()->section(
             $inputs,
             $this->lng->txt('tst_presentation_settings_section')
         );
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getQuestionBehaviourSettingsForStorage()

ilObjTestSettingsMainGUI::getQuestionBehaviourSettingsForStorage ( array $section )

private

Definition at line 630 of file class.ilObjTestSettingsMainGUI.php.

References ilObjTestSettingsQuestionBehaviour\withQuestionTitleOutputMode().

Referenced by performSaveForm().

                                                                            : ilObjTestSettingsQuestionBehaviour
     {
         $question_behaviour_settings = $this->main_settings->getQuestionBehaviourSettings()
             ->withQuestionTitleOutputMode($section['title_output'])
             ->withAutosaveEnabled($section['autosave']['autosave_enabled'])
             ->withAutosaveInterval($section['autosave']['autosave_interval'])
             ->withShuffleQuestions($section['shuffle_questions']);
 
         if ($this->test_object->participantDataExist()) {
             return $question_behaviour_settings;
         }
 
         return $question_behaviour_settings
             ->withQuestionHintsEnabled($section['offer_hints'])
             ->withInstantFeedbackPointsEnabled($section['instant_feedback']['enabled_feedback_types']['instant_feedback_points'])
             ->withInstantFeedbackGenericEnabled($section['instant_feedback']['enabled_feedback_types']['instant_feedback_generic'])
             ->withInstantFeedbackSpecificEnabled($section['instant_feedback']['enabled_feedback_types']['instant_feedback_specific'])
             ->withInstantFeedbackSolutionEnabled($section['instant_feedback']['enabled_feedback_types']['instant_feedback_solution'])
             ->withForceInstantFeedbackOnNextQuestion($section['instant_feedback']['feedback_on_next_question'])
             ->withLockAnswerOnInstantFeedbackEnabled($section['lock_answers']['lock_answer_on_instant_feedback'])
             ->withLockAnswerOnNextQuestionEnabled($section['lock_answers']['lock_answer_on_next_question'])
             ->withCompulsoryQuestionsEnabled($section['enable_compulsory_questions']);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getTestBehaviourSettingsForStorage()

ilObjTestSettingsMainGUI::getTestBehaviourSettingsForStorage ( array $section )

private

Definition at line 611 of file class.ilObjTestSettingsMainGUI.php.

References ilObjTestSettingsTestBehaviour\withKioskMode().

Referenced by performSaveForm().

                                                                        : ilObjTestSettingsTestBehaviour
     {
         $test_behaviour_settings = $this->main_settings->getTestBehaviourSettings()
             ->withKioskMode($section['kiosk_mode'])
             ->withExamIdInTestPassEnabled($section['show_exam_id']);
 
         if ($this->test_object->participantDataExist()) {
             return $test_behaviour_settings;
         }
 
         return $test_behaviour_settings
             ->withNumberOfTries($section['limit_attempts']['number_of_available_attempts'])
             ->withBlockAfterPassedEnabled($section['limit_attempts']['block_after_passed'])
             ->withPassWaiting($section['force_waiting_between_attempts'])
             ->withProcessingTimeEnabled($section['time_limit_for_completion']['processing_time_limit'])
             ->withProcessingTime($section['time_limit_for_completion']['time_limit_for_completion_value'])
             ->withResetProcessingTime($section['time_limit_for_completion']['reset_time_limit_for_completion_by_attempt']);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getTimebasedAvailabilityInputs()

ilObjTestSettingsMainGUI::getTimebasedAvailabilityInputs ( )

private

Definition at line 465 of file class.ilObjTestSettingsMainGUI.php.

References ILIAS\UI\Implementation\Component\Input\$inputs, getTransformationForActivationLimitedOptionalGroup(), getValueForActivationLimitedOptionalGroup(), ILIAS\Repository\lng(), ILIAS\Repository\ui(), and ILIAS\UI\Implementation\Component\Input\ViewControl\withAdditionalTransformation().

Referenced by getAvailabilitySettingsSection().

                                                      : OptionalGroup
     {
         $field_factory = $this->ui->factory()->input()->field();
 
         $trafo = $this->getTransformationForActivationLimitedOptionalGroup();
         $value = $this->getValueForActivationLimitedOptionalGroup();
 
         $data_factory = new DataFactory();
         $user_format = $this->activeUser->getDateFormat();
         $format = $data_factory->dateFormat()->withTime24($user_format);
 
         $inputs['time_span'] = $field_factory->duration($this->lng->txt('rep_time_period'))
             ->withTimezone($this->activeUser->getTimeZone())
             ->withFormat($format)
             ->withUseTime(true)
             ->withRequired(true);
         $inputs['activation_visibility'] = $field_factory->checkbox(
             $this->lng->txt('rep_activation_limited_visibility'),
             $this->lng->txt('tst_activation_limited_visibility_info')
         );
 
         return $field_factory->optionalGroup(
             $inputs,
             $this->lng->txt('rep_time_based_availability')
         )->withAdditionalTransformation($trafo)
             ->withValue($value);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getTransformationForActivationLimitedOptionalGroup()

ilObjTestSettingsMainGUI::getTransformationForActivationLimitedOptionalGroup ( )

private

Definition at line 493 of file class.ilObjTestSettingsMainGUI.php.

References ILIAS\Repository\refinery().

Referenced by getTimebasedAvailabilityInputs().

                                                                          : TransformationInterface
     {
         return $this->refinery->custom()->transformation(
             static function (?array $vs): array {
                 if ($vs === null) {
                     return [
                         'is_activation_limited' => false,
                         'activation_starting_time' => null,
                         'activation_ending_time' => null,
                         'activation_visibility' => false
                     ];
                 }
 
                 $start = $vs['time_span']['start']->getTimestamp();
                 $end = $vs['time_span']['end']->getTimestamp();
 
                 return [
                     'is_activation_limited' => true,
                     'activation_starting_time' => $start,
                     'activation_ending_time' => $end,
                     'activation_visibility' => $vs['activation_visibility']
                 ];
             }
         );
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getValueForActivationLimitedOptionalGroup()

ilObjTestSettingsMainGUI::getValueForActivationLimitedOptionalGroup ( )

private

Definition at line 519 of file class.ilObjTestSettingsMainGUI.php.

Referenced by getTimebasedAvailabilityInputs().

                                                                 : ?array
     {
         $value = null;
         if ($this->test_object->isActivationLimited()) {
             $value = [
                 'time_span' => [
                     DateTimeImmutable::createFromFormat(
                         'U',
                         (string) $this->test_object->getActivationStartingTime()
                     )->setTimezone(new DateTimeZone($this->activeUser->getTimeZone())),
                     DateTimeImmutable::createFromFormat(
                         'U',
                         (string) $this->test_object->getActivationEndingTime()
                     )->setTimezone(new DateTimeZone($this->activeUser->getTimeZone())),
                 ],
                 'activation_visibility' => $this->test_object->getActivationVisibility()
             ];
         }
         return $value;
     }

Here is the caller graph for this function:

◆ performSaveForm()

ilObjTestSettingsMainGUI::performSaveForm ( array $data )

private

Definition at line 330 of file class.ilObjTestSettingsMainGUI.php.

References getAccessSettingsForStorage(), getAdditionalFunctionalitySettingsForStorage(), getFinishingSettingsForStorage(), getGeneralSettingsForStorage(), getIntroductionSettingsForStorage(), getParticipantsFunctionalitySettingsForStorage(), getQuestionBehaviourSettingsForStorage(), getTestBehaviourSettingsForStorage(), saveAdditionalFunctionalitySettingsSection(), saveAvailabilitySettingsSection(), and savePresentationSettingsSection().

Referenced by finalizeSave().

     {
         $old_online_status = $this->test_object->getObjectProperties()->getPropertyIsOnline()->getIsOnline();
         $this->test_object->getObjectProperties()->storePropertyTitleAndDescription(
             $data[self::GENERAL_SETTINGS_SECTION_LABEL]['title_and_description']
         );
         $general_settings = $this->getGeneralSettingsForStorage($data[self::GENERAL_SETTINGS_SECTION_LABEL]);
 
         $this->saveAvailabilitySettingsSection($data[self::AVAILABILITY_SETTINGS_SECTION_LABEL]);
         $this->savePresentationSettingsSection($data[self::PRESENTATION_SETTINGS_SECTION_LABEL]);
 
         $introduction_settings = $this->getIntroductionSettingsForStorage(
             $data[self::INTRODUCTION_SETTINGS_SECTION_LABEL]
         );
         $access_settings = $this->getAccessSettingsForStorage(
             $data[self::ACCESS_SETTINGS_LABEL]
         );
         $test_behaviour_settings = $this->getTestBehaviourSettingsForStorage(
             $data[self::TEST_BEHAVIOUR_SETTINGS_LABEL]
         );
         $question_behaviour_settings = $this->getQuestionBehaviourSettingsForStorage(
             $data[self::QUESTION_BEHAVIOUR_SETTINGS_LABEL]
         );
         $participant_functionality_settings = $this->getParticipantsFunctionalitySettingsForStorage(
             $data[self::PARTICIPANTS_FUNCTIONALITY_SETTINGS_LABEL]
         );
 
         $finishing_settings = $this->getFinishingSettingsForStorage($data[self::FINISH_TEST_SETTINGS_LABEL]);
 
         if (array_key_exists(self::ADDITIONAL_FUNCTIONALITY_SETTINGS_LABEL, $data)
             || array_key_exists(self::ECS_FUNCTIONALITY_SETTINGS_LABEL, $data)) {
             $this->saveAdditionalFunctionalitySettingsSection($data);
         }
 
         $additional_settings = $this->getAdditionalFunctionalitySettingsForStorage(
             $data[self::ADDITIONAL_FUNCTIONALITY_SETTINGS_LABEL] ?? []
         );
 
         $settings = new ilObjTestMainSettings(
             $this->test_object->getTestId(),
             $general_settings,
             $introduction_settings,
             $access_settings,
             $test_behaviour_settings,
             $question_behaviour_settings,
             $participant_functionality_settings,
             $finishing_settings,
             $additional_settings
         );
         $this->main_settings_repository->store($settings);
         $this->main_settings = $this->main_settings_repository->getFor($this->test_object->getTestId());
         $this->test_object->read();
         $this->test_object->addToNewsOnOnline(
             $old_online_status,
             $this->test_object->getObjectProperties()->getPropertyIsOnline()->getIsOnline()
         );
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ populateConfirmationModal()

ilObjTestSettingsMainGUI::populateConfirmationModal	(	string	$current_question_set_type,
		string	$new_question_set_type
	)

private

Definition at line 300 of file class.ilObjTestSettingsMainGUI.php.

References $id, $message, ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), ilObjTest\QUESTION_SET_TYPE_FIXED, ILIAS\Repository\ui(), and ILIAS\UI\Implementation\Component\withAdditionalOnLoadCode().

Referenced by saveForm().

      : InterruptiveModal {
         $message = sprintf(
             $this->lng->txt('tst_change_quest_set_type_from_old_to_new_with_conflict'),
             $this->test_object->getQuestionSetTypeTranslation($this->lng, $current_question_set_type),
             $this->test_object->getQuestionSetTypeTranslation($this->lng, $new_question_set_type)
         );
 
         if ($current_question_set_type === ilObjTest::QUESTION_SET_TYPE_FIXED
             && $this->test_object->hasQuestionsWithoutQuestionpool()) {
             $message .= '<br /><br />' . $this->lng->txt('tst_nonpool_questions_get_lost_warning');
         }
 
         $this->tpl->addJavaScript('./Modules/Test/templates/default/settings_confirmation.js');
         $on_load_code = static function (string $id): string {
             return 'il.test.confirmSettings.init(' . $id . ')';
         };
 
         $modal = $this->ui->factory()->modal()->interruptive(
             $this->lng->txt('confirm'),
             $message,
             $this->ctrl->getFormActionByClass(self::class, self::CMD_CONFIRMED_SAVE_FORM)
         )->withActionButtonLabel($this->lng->txt('confirm'))
             ->withAdditionalOnLoadCode($on_load_code);
 
         return $modal->withOnLoad($modal->getShowSignal());
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ removeAllParticipantsIfRequired()

ilObjTestSettingsMainGUI::removeAllParticipantsIfRequired ( )

private

Definition at line 388 of file class.ilObjTestSettingsMainGUI.php.

Referenced by finalizeSave().

                                                       : void
     {
         if (!$this->test_object->participantDataExist() && !$this->test_object->getFixedParticipants()) {
             foreach ($this->test_object->getInvitedUsers() as $usr_id => $usr_data) {
                 $this->test_object->disinviteUser($usr_id);
             }
         }
     }

Here is the caller graph for this function:

◆ saveAdditionalFunctionalitySettingsSection()

ilObjTestSettingsMainGUI::saveAdditionalFunctionalitySettingsSection ( array $sections )

protected

Definition at line 735 of file class.ilObjTestSettingsMainGUI.php.

References saveOrganisationalUnitsActivation().

Referenced by performSaveForm().

                                                                                   : void
     {
         if (array_key_exists(self::ECS_FUNCTIONALITY_SETTINGS_LABEL, $sections)) {
             $ecs = new ilECSTestSettings($this->test_object);
             $ecs->saveSettingsSection($sections[self::ECS_FUNCTIONALITY_SETTINGS_LABEL]);
         }
 
         if (!array_key_exists(self::ADDITIONAL_FUNCTIONALITY_SETTINGS_LABEL, $sections)) {
             return;
         }
 
         $additional_settings_section = $sections[self::ADDITIONAL_FUNCTIONALITY_SETTINGS_LABEL];
         if (array_key_exists('organisational_units_activation', $additional_settings_section)) {
             $this->saveOrganisationalUnitsActivation($additional_settings_section['organisational_units_activation']);
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ saveAvailabilitySettingsSection()

ilObjTestSettingsMainGUI::saveAvailabilitySettingsSection ( array $section )

private

Definition at line 540 of file class.ilObjTestSettingsMainGUI.php.

Referenced by performSaveForm().

                                                                     : void
     {
         $time_based_availability = $section['timebased_availability'];
 
         $participant_data_exists = $this->test_object->participantDataExist();
         $this->test_object->storeActivationSettings(
             $participant_data_exists
                 ? $this->test_object->isActivationLimited()
                 : $time_based_availability['is_activation_limited'],
             $participant_data_exists
                 ? $this->test_object->getActivationStartingTime()
                 : $time_based_availability['activation_starting_time'],
             $time_based_availability['activation_ending_time'],
             $time_based_availability['activation_visibility']
         );
         $this->test_object->getObjectProperties()->storePropertyIsOnline($section['is_online']);
     }

Here is the caller graph for this function:

◆ saveForm()

ilObjTestSettingsMainGUI::saveForm ( )

private

Definition at line 215 of file class.ilObjTestSettingsMainGUI.php.

References $data, buildForm(), finalizeSave(), populateConfirmationModal(), and showForm().

                                : void
     {
         $form = $this->buildForm()->withRequest($this->request);
         $data = $form->getData();
         if ($data === null) {
             $this->showForm($form);
             return;
         }
 
         $current_question_set_type = $this->main_settings->getGeneralSettings()->getQuestionSetType();
         $current_question_config = $this->testQuestionSetConfigFactory->getQuestionSetConfig();
         $new_question_set_type = $data[self::GENERAL_SETTINGS_SECTION_LABEL]['question_set_type'];
 
         if ($new_question_set_type !== $current_question_set_type
             && $current_question_config->doesQuestionSetRelatedDataExist()) {
             $modal = $this->populateConfirmationModal($current_question_set_type, $new_question_set_type);
             $this->showForm($form, $modal);
             return;
         }
 
         $this->finalizeSave($data);
     }

Here is the call graph for this function:

◆ saveOrganisationalUnitsActivation()

ilObjTestSettingsMainGUI::saveOrganisationalUnitsActivation ( bool $activation )

protected

Definition at line 752 of file class.ilObjTestSettingsMainGUI.php.

References ilOrgUnitGlobalSettings\getInstance(), and ilOrgUnitObjectPositionSetting\setActive().

Referenced by saveAdditionalFunctionalitySettingsSection().

                                                                           : void
     {
         $position_settings = ilOrgUnitGlobalSettings::getInstance()->getObjectPositionSettingsByType(
             $this->test_object->getType()
         );
 
         if ($position_settings->isActive() && $position_settings->isChangeableForObject()) {
             $orgu_object_settings = new ilOrgUnitObjectPositionSetting($this->test_object->getId());
             $orgu_object_settings->setActive(
                 $activation
             );
             $orgu_object_settings->update();
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ savePresentationSettingsSection()

ilObjTestSettingsMainGUI::savePresentationSettingsSection ( array $section )

protected

Definition at line 577 of file class.ilObjTestSettingsMainGUI.php.

Referenced by performSaveForm().

                                                                       : void
     {
         if (array_key_exists('custom_icon', $section)) {
             $this->test_object->getObjectProperties()->storePropertyIcon($section['custom_icon']);
         }
         $this->test_object->getObjectProperties()->storePropertyTileImage($section['tile_image']);
     }

Here is the caller graph for this function:

◆ showForm()

ilObjTestSettingsMainGUI::showForm	(	StandardForm	$form = `null`,
		InterruptiveModal	$modal = `null`
	)

private

Definition at line 166 of file class.ilObjTestSettingsMainGUI.php.

References buildForm(), ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), ILIAS\Repository\toolbar(), and ILIAS\Repository\ui().

Referenced by confirmedSaveForm(), finalizeSave(), and saveForm().

                                                                                          : void
     {
         if ($form === null) {
             $form = $this->buildForm();
         }
 
         if ($this->main_settings->getIntroductionSettings()->getIntroductionText() !== '') {
             $this->toolbar->addComponent(
                 $this->ui->factory()->link()->standard(
                     $this->lng->txt('show_old_introduction'),
                     $this->ctrl->getLinkTargetByClass(self::class, 'showOldIntroduction')
                 )
             );
         }
 
         if ($this->main_settings->getFinishingSettings()->getConcludingRemarksText() !== '') {
             $this->toolbar->addComponent(
                 $this->ui->factory()->link()->standard(
                     $this->lng->txt('show_old_concluding_remarks'),
                     $this->ctrl->getLinkTargetByClass(self::class, 'showOldConcludingRemarks')
                 )
             );
         }
 
         $rendered_modal = '';
         if ($modal !== null) {
             $rendered_modal = $this->ui->renderer()->render($modal);
         }
 
         $this->tpl->setContent($this->ui->renderer()->render($form) . $rendered_modal);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ showOldConcludingRemarks()

ilObjTestSettingsMainGUI::showOldConcludingRemarks ( )

private

Definition at line 152 of file class.ilObjTestSettingsMainGUI.php.

References ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), ILIAS\Repository\toolbar(), and ILIAS\Repository\ui().

                                                : void
     {
         $this->toolbar->addComponent(
             $this->ui->factory()->link()->standard(
                 $this->lng->txt('back'),
                 $this->ctrl->getLinkTargetByClass(self::class, 'showForm')
             )
         );
 
         $this->tpl->setContent(
             $this->main_settings->getFinishingSettings()->getConcludingRemarksText()
         );
     }

Here is the call graph for this function:

◆ showOldIntroduction()

ilObjTestSettingsMainGUI::showOldIntroduction ( )

private

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

References ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), ILIAS\Repository\toolbar(), and ILIAS\Repository\ui().

                                           : void
     {
         $this->toolbar->addComponent(
             $this->ui->factory()->link()->standard(
                 $this->lng->txt('back'),
                 $this->ctrl->getLinkTargetByClass(self::class, 'showForm')
             )
         );
 
         $this->tpl->setContent(
             $this->main_settings->getIntroductionSettings()->getIntroductionText()
         );
     }