Inheritance diagram for ilObjTestSettingsResultSummary:

Collaboration diagram for ilObjTestSettingsResultSummary:

Public Member Functions
	__construct (int $test_id)

	toForm (\ilLanguage $lng, FieldFactory $f, Refinery $refinery, array $environment=null)

	toStorage ()

	getScoreReporting ()

	withScoreReporting (int $score_reporting)

	getScoreReportingEnabled ()

	getReportingDate ()

	withReportingDate (?\DateTimeImmutable $reporting_date)

	getShowGradingStatusEnabled ()

	withShowGradingStatusEnabled (bool $show_grading_status)

	getShowGradingMarkEnabled ()

	withShowGradingMarkEnabled (bool $show_grading_mark)

	getPassDeletionAllowed ()

	withPassDeletionAllowed (bool $pass_deletion_allowed)

	getShowPassDetails ()

	withShowPassDetails (bool $flag)

Public Member Functions inherited from TestSettings
	__construct (int $test_id)

	getTestId ()

	withTestId (int $test_id)

	toForm (\ilLanguage $lng, FieldFactory $f, Refinery $refinery, array $environment=null)

	toStorage ()

Data Fields
const	SCORE_REPORTING_DISABLED = 0

const	SCORE_REPORTING_FINISHED = 1

const	SCORE_REPORTING_IMMIDIATLY = 2

const	SCORE_REPORTING_DATE = 3

const	SCORE_REPORTING_AFTER_PASSED = 4

Protected Attributes
int	$score_reporting = 0

DateTimeImmutable	$reporting_date = null

bool	$pass_deletion_allowed = false

bool	$show_pass_details = false
	this is derived from results_presentation with RESULTPRES_BIT_PASS_DETAILS; see ilObjTestSettingsResultDetails More...

Protected Attributes inherited from TestSettings
int	$test_id

Detailed Description

Definition at line 25 of file ilObjTestSettingsResultSummary.php.

Constructor & Destructor Documentation

◆ __construct()

ilObjTestSettingsResultSummary::__construct ( int $test_id )

Reimplemented from TestSettings.

Definition at line 42 of file ilObjTestSettingsResultSummary.php.

    {
        parent::__construct($test_id);
    }

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

Here is the call graph for this function:

Member Function Documentation

◆ getPassDeletionAllowed()

ilObjTestSettingsResultSummary::getPassDeletionAllowed ( )

Definition at line 232 of file ilObjTestSettingsResultSummary.php.

                                            : bool
    {
        return $this->pass_deletion_allowed;
    }

◆ getReportingDate()

ilObjTestSettingsResultSummary::getReportingDate ( )

Definition at line 199 of file ilObjTestSettingsResultSummary.php.

                                      : ?\DateTimeImmutable
    {
        return $this->reporting_date;
    }

◆ getScoreReporting()

ilObjTestSettingsResultSummary::getScoreReporting ( )

Definition at line 183 of file ilObjTestSettingsResultSummary.php.

                                       : int
    {
        return $this->score_reporting;
    }

◆ getScoreReportingEnabled()

ilObjTestSettingsResultSummary::getScoreReportingEnabled ( )

Definition at line 194 of file ilObjTestSettingsResultSummary.php.

                                              : bool
    {
        return $this->score_reporting !== self::SCORE_REPORTING_DISABLED;
    }

◆ getShowGradingMarkEnabled()

ilObjTestSettingsResultSummary::getShowGradingMarkEnabled ( )

Definition at line 221 of file ilObjTestSettingsResultSummary.php.

                                               : bool
    {
        return $this->show_grading_mark;
    }

◆ getShowGradingStatusEnabled()

ilObjTestSettingsResultSummary::getShowGradingStatusEnabled ( )

Definition at line 210 of file ilObjTestSettingsResultSummary.php.

                                                 : bool
    {
        return $this->show_grading_status;
    }

◆ getShowPassDetails()

ilObjTestSettingsResultSummary::getShowPassDetails ( )

Definition at line 243 of file ilObjTestSettingsResultSummary.php.

                                        : bool
    {
        return $this->show_pass_details;
    }

◆ toForm()

ilObjTestSettingsResultSummary::toForm	(	\ilLanguage	$lng,
		FieldFactory	$f,
		Refinery	$refinery,
		array	$environment = `null`
	)

Reimplemented from TestSettings.

Definition at line 47 of file ilObjTestSettingsResultSummary.php.

     : FormInput {
        $trafo = $refinery->custom()->transformation(
            function ($v) {
                list($mode, $date) = $v;
                if (count($date) < 1) {
                    $date = null;
                } else {
                    $date = array_shift($date);
                }
                return [(int) $mode, $date];
            }
        );
 
        $reporting_date = $this->getReportingDate();
        if ($reporting_date !== null) {
            $reporting_date = $reporting_date->setTimezone(
                new DateTimeZone($environment['user_time_zone'])
            )->format($environment['user_date_format']->toString() . ' H:i');
        }
 
        $results_time_group = $f->switchableGroup(
            [
                self::SCORE_REPORTING_IMMIDIATLY => $f->group([], $lng->txt('tst_results_access_always'), $lng->txt('tst_results_access_always_desc')),
                self::SCORE_REPORTING_FINISHED => $f->group([], $lng->txt('tst_results_access_finished'), $lng->txt('tst_results_access_finished_desc')),
                self::SCORE_REPORTING_AFTER_PASSED => $f->group([], $lng->txt('tst_results_access_passed'), $lng->txt('tst_results_access_passed_desc')),
                self::SCORE_REPORTING_DATE => $f->group(
                    [
                    $f->dateTime($lng->txt('tst_reporting_date'), "")
                        ->withTimezone($environment['user_time_zone'])
                        ->withUseTime(true)
                        ->withFormat($environment['user_date_format'])
                        ->withValue(
                            $reporting_date
                        )
                        ->withRequired(true)
                    ],
                    $lng->txt('tst_results_access_date'),
                    $lng->txt('tst_results_access_date_desc')
                )
            ],
            $lng->txt('tst_results_access_setting'),
            ""
        )
        ->withRequired(true)
        ->withAdditionalTransformation($trafo);
 
        if ($this->getScoreReporting() > 0) {
            $results_time_group = $results_time_group->withValue($this->getScoreReporting());
        }
 
        $optional_group = $f->optionalGroup(
            [
                'score_reporting_mode' => $results_time_group,
                'show_grading_status' => $f->checkbox(
                    $lng->txt('tst_results_grading_opt_show_status'),
                    $lng->txt('tst_results_grading_opt_show_status_desc')
                ),
                'show_grading_mark' => $f->checkbox(
                    $lng->txt('tst_results_grading_opt_show_mark'),
                    $lng->txt('tst_results_grading_opt_show_mark_desc')
                ),
                'show_pass_details' => $f->checkbox(
                    $lng->txt('tst_results_grading_opt_show_details'),
                    $lng->txt('tst_results_grading_opt_show_details_desc')
                ),
                'pass_deletion_allowed' => $f->checkbox(
                    $lng->txt('tst_pass_deletion'),
                    $lng->txt('tst_pass_deletion_allowed')
                )
            ],
            $lng->txt('tst_results_access_enabled'),
            $lng->txt('tst_results_access_enabled_desc')
        );
 
        if ($this->getScoreReportingEnabled()) {
            $optional_group = $optional_group->withValue(
                [
                    "score_reporting_mode" => $this->getScoreReporting(),
                    "show_grading_status" => $this->getShowGradingStatusEnabled(),
                    "show_grading_mark" => $this->getShowGradingMarkEnabled(),
                    "show_pass_details" => $this->getShowPassDetails(),
                    "pass_deletion_allowed" => $this->getPassDeletionAllowed()
                ]
            );
        } else {
            $optional_group = $optional_group->withValue(null);
        }
 
        $fields = ['score_reporting' => $optional_group];
        return $f->section($fields, $lng->txt('test_results'))
            ->withAdditionalTransformation(
                $refinery->custom()->transformation(
                    function ($v) {
                        $settings = clone $this;
                        $mode = 0;
                        $date = null;
                        if ($v['score_reporting']) {
                            list($mode, $date) = $v['score_reporting']['score_reporting_mode'];
                            $settings = $settings
                                ->withShowGradingStatusEnabled($v['score_reporting']['show_grading_status'])
                                ->withShowGradingMarkEnabled($v['score_reporting']['show_grading_mark'])
                                ->withShowPassDetails($v['score_reporting']['show_pass_details'])
                                ->withPassDeletionAllowed($v['score_reporting']['pass_deletion_allowed'])
                            ;
                        }
                        return $settings
                            ->withScoreReporting((int) $mode)
                            ->withReportingDate($date);
                    }
                )
            );
    }

References ILIAS\Repository\int().

Here is the call graph for this function:

◆ toStorage()

ilObjTestSettingsResultSummary::toStorage ( )

Reimplemented from TestSettings.

Definition at line 165 of file ilObjTestSettingsResultSummary.php.

                               : array
    {
        $dat = $this->getReportingDate();
        if ($dat) {
            $dat = $dat->setTimezone(new DateTimeZone('UTC'))
                ->format(ilObjTestScoreSettingsDatabaseRepository::STORAGE_DATE_FORMAT);
        }
        return [
            'pass_deletion_allowed' => ['integer', (int) $this->getPassDeletionAllowed()],
            'score_reporting' => ['integer', $this->getScoreReporting()],
            'reporting_date' => ['text', (string) $dat],
            'show_grading_status' => ['integer', (int) $this->getShowGradingStatusEnabled()],
            'show_grading_mark' => ['integer', (int) $this->getShowGradingMarkEnabled()]
            //show_pass_details
        ];
    }

References ILIAS\Repository\int(), and ilObjTestScoreSettingsDatabaseRepository\STORAGE_DATE_FORMAT.

Here is the call graph for this function:

◆ withPassDeletionAllowed()

ilObjTestSettingsResultSummary::withPassDeletionAllowed ( bool $pass_deletion_allowed )

Definition at line 236 of file ilObjTestSettingsResultSummary.php.

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

◆ withReportingDate()

ilObjTestSettingsResultSummary::withReportingDate ( ?\DateTimeImmutable $reporting_date )

Definition at line 203 of file ilObjTestSettingsResultSummary.php.

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

◆ withScoreReporting()

ilObjTestSettingsResultSummary::withScoreReporting ( int $score_reporting )

Definition at line 187 of file ilObjTestSettingsResultSummary.php.

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

◆ withShowGradingMarkEnabled()

ilObjTestSettingsResultSummary::withShowGradingMarkEnabled ( bool $show_grading_mark )

Definition at line 225 of file ilObjTestSettingsResultSummary.php.

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

◆ withShowGradingStatusEnabled()

ilObjTestSettingsResultSummary::withShowGradingStatusEnabled ( bool $show_grading_status )

Definition at line 214 of file ilObjTestSettingsResultSummary.php.

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

◆ withShowPassDetails()

ilObjTestSettingsResultSummary::withShowPassDetails ( bool $flag )

Definition at line 247 of file ilObjTestSettingsResultSummary.php.

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