ILIAS\Test\Settings\MainSettings\SettingsFinishing Class Reference

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

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

Public Member Functions
	__construct (int $test_id, protected bool $show_answer_overview=false, protected bool $concluding_remarks_enabled=false, protected ?string $concluding_remarks_text='', protected ?int $concluding_remarks_page_id=null, protected RedirectionModes $redirection_mode=RedirectionModes::NONE, protected ?string $redirection_url=null, protected int $mail_notification_content_type=0, protected bool $always_send_mail_notification=false)
	toForm (\ilLanguage $lng, FieldFactory $f, Refinery $refinery, ?array $environment=null)
	toStorage ()
	toLog (AdditionalInformationGenerator $additional_info)
	getShowAnswerOverview ()
	withShowAnswerOverview (bool $show_answer_overview)
	getConcludingRemarksEnabled ()
	withConcludingRemarksEnabled (bool $concluding_remarks_enabled)
	getConcludingRemarksText ()
	getConcludingRemarksPageId ()
	withConcludingRemarksPageId (?int $concluding_remarks_page_id)
	getRedirectionMode ()
	withRedirectionMode (RedirectionModes $redirection_mode)
	getRedirectionUrl ()
	withRedirectionUrl (?string $redirection_url)
	getMailNotificationContentType ()
	withMailNotificationContentType (int $mail_notification_content_type)
	getAlwaysSendMailNotification ()
	withAlwaysSendMailNotification (bool $always_send_mail_notification)
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)

Private Member Functions
	getRedirectionInputs (\ilLanguage $lng, FieldFactory $f, Refinery $refinery)
	getMailNotificationInputs (\ilLanguage $lng, FieldFactory $f, Refinery $refinery)

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

Detailed Description

Definition at line 30 of file SettingsFinishing.php.

Constructor & Destructor Documentation

__construct()

ILIAS\Test\Settings\MainSettings\SettingsFinishing::__construct	(	int	$test_id,
		protected bool	$show_answer_overview = false,
		protected bool	$concluding_remarks_enabled = false,
		protected ?string	$concluding_remarks_text = '',
		protected ?int	$concluding_remarks_page_id = null,
		protected RedirectionModes	$redirection_mode = RedirectionModes::NONE,
		protected ?string	$redirection_url = null,
		protected int	$mail_notification_content_type = 0,
		protected bool	$always_send_mail_notification = false
	)

Definition at line 32 of file SettingsFinishing.php.

      {
        parent::__construct($test_id);
    }

References ILIAS\Test\Settings\TestSettings\$test_id, and ILIAS\GlobalScreen\Provider\__construct().

Here is the call graph for this function:

Member Function Documentation

getAlwaysSendMailNotification()

ILIAS\Test\Settings\MainSettings\SettingsFinishing::getAlwaysSendMailNotification

(

)

Definition at line 356 of file SettingsFinishing.php.

                                                   : bool
    {
        return $this->always_send_mail_notification;
    }

getConcludingRemarksEnabled()

ILIAS\Test\Settings\MainSettings\SettingsFinishing::getConcludingRemarksEnabled

(

)

Definition at line 291 of file SettingsFinishing.php.

                                                 : bool
    {
        return $this->concluding_remarks_enabled;
    }

getConcludingRemarksPageId()

ILIAS\Test\Settings\MainSettings\SettingsFinishing::getConcludingRemarksPageId

(

)

Definition at line 308 of file SettingsFinishing.php.

                                                : ?int
    {
        return $this->concluding_remarks_page_id;
    }

getConcludingRemarksText()

ILIAS\Test\Settings\MainSettings\SettingsFinishing::getConcludingRemarksText

(

)

Definition at line 303 of file SettingsFinishing.php.

                                              : string
    {
        return $this->concluding_remarks_text ?? '';
    }

getMailNotificationContentType()

ILIAS\Test\Settings\MainSettings\SettingsFinishing::getMailNotificationContentType

(

)

Definition at line 344 of file SettingsFinishing.php.

                                                    : int
    {
        return $this->mail_notification_content_type;
    }

getMailNotificationInputs()

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

private

Definition at line 162 of file SettingsFinishing.php.

     : OptionalGroup {
        $notification_trafo = $refinery->custom()->transformation(
            static function (?array $v): array {
                if ($v === null) {
                    return [
                        'notification_content_type' => 0,
                        'always_notify' => false
                    ];
                }
 
                return $v;
            }
        );
 
        $sub_inputs_finish_notification = [
            'notification_content_type' => $f->radio(
                $lng->txt('tst_finish_notification_content_type')
            )->withOption(
                '1',
                $lng->txt('tst_finish_notification_simple')
            )->withOption(
                '2',
                $lng->txt('tst_finish_notification_advanced')
            )->withRequired(true)
            ->withValue('1')
            ->withAdditionalTransformation($refinery->kindlyTo()->int()),
            'always_notify' => $f->checkbox(
                $lng->txt('mailnottype'),
                $lng->txt('mailnottype_desc')
            )
        ];
 
        $mail_notification_inputs = $f->optionalGroup(
            $sub_inputs_finish_notification,
            $lng->txt('tst_finish_notification'),
            $lng->txt('tst_finish_notification_desc')
        )->withValue(null)
            ->withAdditionalTransformation($notification_trafo);
 
        if ($this->getMailNotificationContentType() === 0) {
            return $mail_notification_inputs;
        }
 
        return $mail_notification_inputs->withValue(
            [
                'notification_content_type' => (string) $this->getMailNotificationContentType(),
                'always_notify' => (bool) $this->getAlwaysSendMailNotification()
            ]
        );
    }

getRedirectionInputs()

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

private

Definition at line 69 of file SettingsFinishing.php.

     : OptionalGroup {
        $redirection_trafo = $refinery->custom()->transformation(
            static function (?array $v): array {
                if ($v === null) {
                    return [
                        'redirect_mode' => RedirectionModes::NONE,
                        'redirect_url' => ''
                    ];
                }
 
                return [
                    'redirect_mode' => RedirectionModes::tryFrom($v['redirect_mode'])
                        ?? RedirectionModes::NONE,
                    'redirect_url' => $v['redirect_url']
                ];
            }
        );
 
        $sub_inputs_redirect = [
            'redirect_mode' => $f
                ->radio($lng->txt('redirect_after_finishing_rule'))
                ->withOption(
                    (string) RedirectionModes::ALWAYS->value,
                    $lng->txt('redirect_always')
                )->withOption(
                    (string) RedirectionModes::ALWAYS_TO_LOGOUT->value,
                    $lng->txt('redirect_always_to_logout')
                )->withOption(
                    (string) RedirectionModes::IF_KIOSK_ACTIVATED->value,
                    $lng->txt('redirect_in_kiosk_mode')
                )->withRequired(true)
                ->withAdditionalTransformation($refinery->kindlyTo()->int()),
            'redirect_url' => $f
                ->text($lng->txt('redirection_url'))
                ->withAdditionalTransformation($refinery->string()->hasMaxLength(4000))
                ->withAdditionalTransformation(
                    $refinery->custom()->constraint(
                        static function ($v) use ($refinery): bool {
                            try {
                                return $v === '' || $refinery->to()->data('uri')->transform($v);
                            } catch (Throwable) {
                                return false;
                            }
                        },
                        $lng->txt('redirect_url_invalid')
                    )
                )
        ];
 
        $redirection_input = $f
            ->optionalGroup(
                $sub_inputs_redirect,
                $lng->txt('redirect_after_finishing_tst'),
                $lng->txt('redirect_after_finishing_tst_desc')
            )
            ->withValue(null)
            ->withAdditionalTransformation($redirection_trafo)
            ->withAdditionalTransformation(
                $refinery->custom()->constraint(
                    static function (array $v): bool {
                        return in_array(
                            $v['redirect_mode'],
                            [RedirectionModes::NONE, RedirectionModes::ALWAYS_TO_LOGOUT],
                            true
                        ) || $v['redirect_url'] !== '';
                    },
                    static function (\Closure $txt, array $value): string {
                        return sprintf(
                            $txt('redirect_url_required_for_rule'),
                            $value['redirect_mode'] === RedirectionModes::ALWAYS
                                ? $txt('redirect_always')
                                : $txt('redirect_in_kiosk_mode')
                        );
                    }
                )
            );
 
        if ($this->getRedirectionMode() === RedirectionModes::NONE) {
            return $redirection_input;
        }
 
        return $redirection_input->withValue(
            [
                'redirect_mode' => $this->getRedirectionMode()->value,
                'redirect_url' => $this->getRedirectionUrl()
            ]
        );
    }

getRedirectionMode()

ILIAS\Test\Settings\MainSettings\SettingsFinishing::getRedirectionMode

(

)

Definition at line 320 of file SettingsFinishing.php.

                                        : RedirectionModes
    {
        return $this->redirection_mode;
    }

getRedirectionUrl()

ILIAS\Test\Settings\MainSettings\SettingsFinishing::getRedirectionUrl

(

)

Definition at line 332 of file SettingsFinishing.php.

                                       : ?string
    {
        return $this->redirection_url;
    }

getShowAnswerOverview()

ILIAS\Test\Settings\MainSettings\SettingsFinishing::getShowAnswerOverview

(

)

Definition at line 279 of file SettingsFinishing.php.

                                           : bool
    {
        return $this->show_answer_overview;
    }

toForm()

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

Reimplemented from ILIAS\Test\Settings\TestSettings.

Definition at line 46 of file SettingsFinishing.php.

     : FormInput {
        $inputs['show_answer_overview'] = $f->checkbox(
            $lng->txt('enable_examview'),
            $lng->txt('enable_examview_desc')
        )->withValue($this->getShowAnswerOverview());
 
        $inputs['show_concluding_remarks'] = $f->checkbox(
            $lng->txt('final_statement'),
            $lng->txt('final_statement_show_desc')
        )->withValue((bool) $this->getConcludingRemarksEnabled());
 
        $inputs['redirect_after_finish'] = $this->getRedirectionInputs($lng, $f, $refinery);
 
        $inputs['finish_notification'] = $this->getMailNotificationInputs($lng, $f, $refinery);
 
        return $f->section($inputs, $lng->txt('tst_final_information'));
    }

toLog()

ILIAS\Test\Settings\MainSettings\SettingsFinishing::toLog

(

AdditionalInformationGenerator

$additional_info

)

Reimplemented from ILIAS\Test\Settings\TestSettings.

Definition at line 231 of file SettingsFinishing.php.

                                                                          : array
    {
        $log_array = [
            AdditionalInformationGenerator::KEY_TEST_ANSWER_OVERVIEW_ENABLED => $additional_info
                ->getEnabledDisabledTagForBool($this->getShowAnswerOverview()),
            AdditionalInformationGenerator::KEY_TEST_CONCLUDING_REMARKS_ENABLED => $additional_info
                ->getEnabledDisabledTagForBool($this->getConcludingRemarksEnabled()),
            AdditionalInformationGenerator::KEY_TEST_REDIRECT_URL => $this->getRedirectionUrl(),
 
        ];
 
        switch ($this->getRedirectionMode()) {
            case RedirectionModes::NONE:
                $log_array[AdditionalInformationGenerator::KEY_TEST_REDIRECT_MODE] = $additional_info
                    ->getNoneTag();
                break;
            case RedirectionModes::ALWAYS:
                $log_array[AdditionalInformationGenerator::KEY_TEST_REDIRECT_MODE] = $additional_info
                    ->getTagForLangVar('redirect_always');
                break;
            case RedirectionModes::IF_KIOSK_ACTIVATED:
                $log_array[AdditionalInformationGenerator::KEY_TEST_REDIRECT_MODE] = $additional_info
                    ->getTagForLangVar('redirect_in_kiosk_mode');
                break;
        }
 
        switch ($this->getMailNotificationContentType()) {
            case 0:
                $log_array[AdditionalInformationGenerator::KEY_TEST_MAIL_NOTIFICATION_CONTENT_TYPE] = $additional_info
                    ->getNoneTag();
                break;
            case 1:
                $log_array[AdditionalInformationGenerator::KEY_TEST_MAIL_NOTIFICATION_CONTENT_TYPE] = $additional_info
                    ->getTagForLangVar('tst_finish_notification_simple');
                $log_array[AdditionalInformationGenerator::KEY_TEST_ALWAYS_SEND_NOTIFICATION] = $additional_info
                    ->getEnabledDisabledTagForBool($this->getAlwaysSendMailNotification());
                break;
            case 2:
                $log_array[AdditionalInformationGenerator::KEY_TEST_MAIL_NOTIFICATION_CONTENT_TYPE] = $additional_info
                    ->getTagForLangVar('tst_finish_notification_advanced');
                $log_array[AdditionalInformationGenerator::KEY_TEST_ALWAYS_SEND_NOTIFICATION] = $additional_info
                    ->getEnabledDisabledTagForBool($this->getAlwaysSendMailNotification());
                break;
        }
 
        return $log_array;
    }

References ALWAYS, ILIAS\Test\Logging\AdditionalInformationGenerator\getEnabledDisabledTagForBool(), ILIAS\Test\Logging\AdditionalInformationGenerator\getNoneTag(), and ILIAS\Test\Logging\AdditionalInformationGenerator\getTagForLangVar().

Here is the call graph for this function:

toStorage()

ILIAS\Test\Settings\MainSettings\SettingsFinishing::toStorage

(

)

Reimplemented from ILIAS\Test\Settings\TestSettings.

Definition at line 217 of file SettingsFinishing.php.

                               : array
    {
        return [
            'enable_examview' => ['integer', (int) $this->getShowAnswerOverview()],
            'showfinalstatement' => ['integer', (int) $this->getConcludingRemarksEnabled()],
            'finalstatement' => ['text', $this->getConcludingRemarksText()],
            'concluding_remarks_page_id' => ['integer', $this->getConcludingRemarksPageId()],
            'redirection_mode' => ['integer', $this->getRedirectionMode()->value],
            'redirection_url' => ['text', $this->getRedirectionUrl()],
            'mailnotification' => ['integer', $this->getMailNotificationContentType()],
            'mailnottype' => ['integer', (int) $this->getAlwaysSendMailNotification()]
        ];
    }

References ILIAS\Repository\int().

Here is the call graph for this function:

withAlwaysSendMailNotification()

ILIAS\Test\Settings\MainSettings\SettingsFinishing::withAlwaysSendMailNotification

(

bool

$always_send_mail_notification

)

Definition at line 361 of file SettingsFinishing.php.

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

withConcludingRemarksEnabled()

ILIAS\Test\Settings\MainSettings\SettingsFinishing::withConcludingRemarksEnabled

(

bool

$concluding_remarks_enabled

)

Definition at line 296 of file SettingsFinishing.php.

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

withConcludingRemarksPageId()

ILIAS\Test\Settings\MainSettings\SettingsFinishing::withConcludingRemarksPageId

(

?int

$concluding_remarks_page_id

)

Definition at line 313 of file SettingsFinishing.php.

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

Referenced by ilObjTest\addConcludingRemarksToSettingsFromImport(), and ilObjTest\getConcludingRemarksPageId().

Here is the caller graph for this function:

withMailNotificationContentType()

ILIAS\Test\Settings\MainSettings\SettingsFinishing::withMailNotificationContentType

(

int

$mail_notification_content_type

)

Definition at line 349 of file SettingsFinishing.php.

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

withRedirectionMode()

ILIAS\Test\Settings\MainSettings\SettingsFinishing::withRedirectionMode

(

RedirectionModes

$redirection_mode

)

Definition at line 325 of file SettingsFinishing.php.

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

withRedirectionUrl()

ILIAS\Test\Settings\MainSettings\SettingsFinishing::withRedirectionUrl

(

?string

$redirection_url

)

Definition at line 337 of file SettingsFinishing.php.

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

withShowAnswerOverview()

ILIAS\Test\Settings\MainSettings\SettingsFinishing::withShowAnswerOverview

(

bool

$show_answer_overview

)

Definition at line 284 of file SettingsFinishing.php.

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

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

Here is the caller graph for this function:

---

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

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