SettingsResultSummary.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
namespace ILIAS\Test\Settings\ScoreReporting;
 
use ILIAS\Test\ExportImport\Exportable;
use ILIAS\Test\Settings\TestSettings;
use ILIAS\Test\Logging\AdditionalInformationGenerator;
use ILIAS\UI\Component\Input\Field\Factory as FieldFactory;
use ILIAS\UI\Component\Input\Container\Form\FormInput;
use ILIAS\Refinery\Factory as Refinery;
 
class SettingsResultSummary extends TestSettings implements Exportable
{
    protected ScoreReportingTypes $score_reporting = ScoreReportingTypes::SCORE_REPORTING_DISABLED;
    protected ?\DateTimeImmutable $reporting_date = null;
    protected bool $pass_deletion_allowed = false;
    protected bool $show_pass_details = false;
    protected bool $show_grading_status = false;
    protected bool $show_grading_mark = false;
 
    public function toForm(
        \ilLanguage $lng,
        FieldFactory $f,
        Refinery $refinery,
        ?array $environment = null
    ): 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];
            }
        );
 
        $results_time_group = $f->switchableGroup(
            [
                ScoreReportingTypes::SCORE_REPORTING_IMMIDIATLY->value => $f->group([], $lng->txt('tst_results_access_always'), $lng->txt('tst_results_access_always_desc')),
                ScoreReportingTypes::SCORE_REPORTING_FINISHED->value => $f->group([], $lng->txt('tst_results_access_finished'), $lng->txt('tst_results_access_finished_desc')),
                ScoreReportingTypes::SCORE_REPORTING_AFTER_PASSED->value => $f->group([], $lng->txt('tst_results_access_passed'), $lng->txt('tst_results_access_passed_desc')),
                ScoreReportingTypes::SCORE_REPORTING_DATE->value => $f->group(
                    [
                    $f->dateTime($lng->txt('tst_reporting_date'), "")
                        ->withTimezone($environment['user_time_zone'])
                        ->withFormat($environment['user_date_format'])
                        ->withUseTime(true)
                        ->withValue(
                            $this->getReportingDate()?->setTimezone(
                                new \DateTimeZone($environment['user_time_zone'])
                            )
                        )
                        ->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() !== ScoreReportingTypes::SCORE_REPORTING_DISABLED) {
            $results_time_group = $results_time_group->withValue($this->getScoreReporting()->value);
        }
 
 
        $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->getScoreReporting()->isReportingEnabled()) {
            $optional_group = $optional_group->withValue(
                [
                    "score_reporting_mode" => $this->getScoreReporting()->value,
                    "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(ScoreReportingTypes::from($mode))
                            ->withReportingDate($date);
                    }
                )
            );
    }
 
    public function toStorage(): array
    {
        return [
            'pass_deletion_allowed' => [\ilDBConstants::T_INTEGER, (int) $this->getPassDeletionAllowed()],
            'score_reporting' => [\ilDBConstants::T_INTEGER, $this->getScoreReporting()->value],
            'reporting_date' => [\ilDBConstants::T_INTEGER, $this->getReportingDate() !== null ? $this->getReportingDate()->getTimestamp() : 0],
            'show_grading_status' => [\ilDBConstants::T_INTEGER, (int) $this->getShowGradingStatusEnabled()],
            'show_grading_mark' => [\ilDBConstants::T_INTEGER, (int) $this->getShowGradingMarkEnabled()]
        ];
    }
 
    public function toLog(AdditionalInformationGenerator $additional_info): array
    {
        switch ($this->getScoreReporting()) {
            case ScoreReportingTypes::SCORE_REPORTING_DISABLED:
                $log_array[AdditionalInformationGenerator::KEY_SCORING_REPORTING] = $additional_info
                    ->getEnabledDisabledTagForBool(false);
                break;
            case ScoreReportingTypes::SCORE_REPORTING_FINISHED:
                $log_array[AdditionalInformationGenerator::KEY_SCORING_REPORTING] = $additional_info
                    ->getTagForLangVar('tst_results_access_finished');
                $log_array += $this->getLogEntriesForScoreReportingEnabled($additional_info);
                break;
            case ScoreReportingTypes::SCORE_REPORTING_IMMIDIATLY:
                $log_array[AdditionalInformationGenerator::KEY_SCORING_REPORTING] = $additional_info
                    ->getTagForLangVar('tst_results_access_always');
                $log_array += $this->getLogEntriesForScoreReportingEnabled($additional_info);
                break;
            case ScoreReportingTypes::SCORE_REPORTING_DATE:
                $log_array[AdditionalInformationGenerator::KEY_SCORING_REPORTING] = $this->getReportingDate()
                    ->setTimezone(new \DateTimeZone('UTC'))->format(AdditionalInformationGenerator::DATE_STORAGE_FORMAT);
                $log_array += $this->getLogEntriesForScoreReportingEnabled($additional_info);
                break;
            case ScoreReportingTypes::SCORE_REPORTING_AFTER_PASSED:
                $log_array[AdditionalInformationGenerator::KEY_SCORING_REPORTING] = $additional_info
                    ->getTagForLangVar('tst_results_access_passed');
                $log_array += $this->getLogEntriesForScoreReportingEnabled($additional_info);
                break;
        }
        return $log_array;
    }
 
    private function getLogEntriesForScoreReportingEnabled(
        AdditionalInformationGenerator $additional_info
    ): array {
        return [
            AdditionalInformationGenerator::KEY_SCORING_REPORTING_SHOW_STATUS => $additional_info
                ->getEnabledDisabledTagForBool($this->getShowGradingStatusEnabled()),
            AdditionalInformationGenerator::KEY_SCORING_REPORTING_SHOW_MARK => $additional_info
                ->getEnabledDisabledTagForBool($this->getShowGradingMarkEnabled()),
            AdditionalInformationGenerator::KEY_SCORING_REPORTING_SHOW_DETAILS => $additional_info
                ->getEnabledDisabledTagForBool($this->getShowPassDetails()),
            AdditionalInformationGenerator::KEY_SCORING_DELETION_ALLOWED => $additional_info
                ->getEnabledDisabledTagForBool($this->getPassDeletionAllowed())
        ];
    }
 
    public function getScoreReporting(): ScoreReportingTypes
    {
        return $this->score_reporting;
    }
    public function withScoreReporting(ScoreReportingTypes $score_reporting): self
    {
        $clone = clone $this;
        $clone->score_reporting = $score_reporting;
        return $clone;
    }
 
    public function getReportingDate(): ?\DateTimeImmutable
    {
        return $this->reporting_date;
    }
    public function withReportingDate(?\DateTimeImmutable $reporting_date): self
    {
        $clone = clone $this;
        $clone->reporting_date = $reporting_date;
        return $clone;
    }
 
    public function getShowGradingStatusEnabled(): bool
    {
        return $this->show_grading_status;
    }
    public function withShowGradingStatusEnabled(bool $show_grading_status): self
    {
        $clone = clone $this;
        $clone->show_grading_status = $show_grading_status;
        return $clone;
    }
 
    public function getShowGradingMarkEnabled(): bool
    {
        return $this->show_grading_mark;
    }
    public function withShowGradingMarkEnabled(bool $show_grading_mark): self
    {
        $clone = clone $this;
        $clone->show_grading_mark = $show_grading_mark;
        return $clone;
    }
 
    public function getPassDeletionAllowed(): bool
    {
        return $this->pass_deletion_allowed;
    }
    public function withPassDeletionAllowed(bool $pass_deletion_allowed): self
    {
        $clone = clone $this;
        $clone->pass_deletion_allowed = $pass_deletion_allowed;
        return $clone;
    }
 
    public function getShowPassDetails(): bool
    {
        return $this->show_pass_details;
    }
    public function withShowPassDetails(bool $flag): self
    {
        $clone = clone $this;
        $clone->show_pass_details = $flag;
        return $clone;
    }
 
    public function toExport(): array
    {
        return [
            'score_reporting' => $this->getScoreReporting()->value,
            'reporting_date' => $this->getReportingDate()?->format(\DateTimeInterface::ATOM),
            'show_grading_status' => $this->getShowGradingStatusEnabled(),
            'show_grading_mark' => $this->getShowGradingMarkEnabled(),
            'show_pass_details' => $this->getShowPassDetails(),
            'pass_deletion_allowed' => $this->getPassDeletionAllowed()
        ];
    }
 
    public static function fromExport(array $data): static
    {
        return (new self())
            ->withScoreReporting(ScoreReportingTypes::from($data['score_reporting']))
            ->withReportingDate($data['reporting_date'] !== 0 ? new \DateTimeImmutable($data['reporting_date']) : null)
            ->withShowGradingStatusEnabled((bool) $data['show_grading_status'])
            ->withShowGradingMarkEnabled((bool) $data['show_grading_mark'])
            ->withShowPassDetails((bool) $data['show_pass_details'])
            ->withPassDeletionAllowed((bool) $data['pass_deletion_allowed']);
    }
}