class.ilTestPassResultsTable.php

Go to the documentation of this file.

<?php

declare(strict_types=1);

use ILIAS\UI\Implementation\Component\Table\Presentation;
use ILIAS\UI\URLBuilder;
use ILIAS\UI\Factory as UIFactory;
use ILIAS\UI\Renderer as UIRenderer;
use ILIAS\Refinery\Factory as Refinery;
use ILIAS\HTTP\Services as HTTPService;
use ILIAS\Data\Factory as DataFactory;

class ilTestPassResultsTable
{
    private const ENV = 'e';
    private const LNG = 'l';
    private const URL_NAMESPACE = ['taresult', 'vc'];
    private const PARAM_MODE = 'm';
    private const MODE_OPT_ALL = "all";
    private const MODE_OPT_CORRECT = "ok";
    private const MODE_OPT_INCORRECT = "fail";
    private const PARAM_SORT = 's';
    private const SORT_OPT_ORDEROFAPPEARANCE = 'ooa';
    private const SORT_OPT_POSSIBLESCORE = 'ms';

    protected Presentation $table;

    public function __construct(
        UIFactory $ui_factory,
        protected UIRenderer $ui_renderer,
        protected Refinery $refinery,
        protected HTTPService $http,
        DataFactory $data_factory,
        ilLanguage $lng,
        protected ilTestPassResult $test_results,
        string $title
    ) {
        list($mode, $sortation) = $this->getViewControlsParameter();
        $results = $this->applyControls($mode, $sortation, $test_results->getQuestionResults());
        $target = new URLBuilder($data_factory->uri($http->request()->getUri()->__toString()));

        $this->table = $ui_factory->table()->presentation(
            $title,
            $this->getViewControls($ui_factory, $lng, $target, $mode, $sortation),
            $this->getMapping()
        )
        ->withEnvironment([
            self::ENV => $test_results->getSettings(),
            self::LNG => $lng
        ])
        ->withData($results);
    }

    public function render(): string
    {
        return $this->ui_renderer->render($this->table);
    }

    protected function applyControls(
        string $mode,
        string $sortation,
        array $question_results
    ) {
        switch ($mode) {
            case self::MODE_OPT_CORRECT:
                $filter = static fn($qr) => $qr->getCorrect() === ilQuestionResult::CORRECT_FULL;
                break;
            case self::MODE_OPT_INCORRECT:
                $filter = static fn($qr) => $qr->getCorrect() !== ilQuestionResult::CORRECT_FULL;
                break;
            case self::MODE_OPT_ALL:
            default:
                $filter = static fn($qr) => true;
        }
        $question_results = array_filter($question_results, $filter);

        if ($sortation === self::SORT_OPT_POSSIBLESCORE) {
            usort(
                $question_results,
                static fn(ilQuestionResult $a, ilQuestionResult $b) => $a->getQuestionScore() <=> $b->getQuestionScore()
            );
            $question_results = array_reverse($question_results);
        }
        return $question_results;
    }

    protected function getViewControlNamespace(): array
    {
        $namespace = self::URL_NAMESPACE;
        $namespace[] = (string) $this->test_results->getActiveId();
        $namespace[] = (string) $this->test_results->getPass();
        return $namespace;
    }

    protected function getViewControlsParameter(): array
    {
        $request = $this->http->wrapper()->query();
        $pre = implode(URLBuilder::SEPARATOR, $this->getViewControlNamespace()) . URLBuilder::SEPARATOR;

        $mode = $request->has($pre . self::PARAM_MODE) ?
            $request->retrieve($pre . self::PARAM_MODE, $this->refinery->kindlyTo()->string()) : self::MODE_OPT_ALL;

        $sortation = $request->has($pre . self::PARAM_SORT) ?
            $request->retrieve($pre . self::PARAM_SORT, $this->refinery->kindlyTo()->string()) : self::SORT_OPT_ORDEROFAPPEARANCE;

        return [$mode, $sortation];
    }

    protected function getViewControls(
        UIFactory $ui_factory,
        ilLanguage $lng,
        URLBuilder $target,
        string $mode,
        string $sortation
    ): array {
        $builder = $target->acquireParameter($this->getViewControlNamespace(), self::PARAM_MODE);
        [$target, $token] = $builder;

        $modes = [
            $lng->txt('resulttable_all') => $target->withParameter($token, self::MODE_OPT_ALL)->buildURI()->__toString(),
            $lng->txt('resulttable_correct') => $target->withParameter($token, self::MODE_OPT_CORRECT)->buildURI()->__toString(),
            $lng->txt('resulttable_incorrect') => $target->withParameter($token, self::MODE_OPT_INCORRECT)->buildURI()->__toString(),
        ];
        $check = [self::MODE_OPT_ALL, self::MODE_OPT_CORRECT, self::MODE_OPT_INCORRECT];
        $active = array_search($mode, $check);

        $vc_mode = $ui_factory->viewControl()->mode($modes, $lng->txt('ta_resulttable_vc_mode_aria'))
            ->withActive(array_keys($modes)[$active]);

        $options = [
            self::SORT_OPT_ORDEROFAPPEARANCE => $lng->txt('resulttable_vc_sort_iooa'),
            self::SORT_OPT_POSSIBLESCORE => $lng->txt('resulttable_vc_sort_posscore')
        ];

        $pre = implode(URLBuilder::SEPARATOR, $this->getViewControlNamespace()) . URLBuilder::SEPARATOR;
        $vc_sort = $ui_factory->viewControl()->sortation($options)->withTargetURL(
            $target->buildURI()->__toString(),
            $pre . self::PARAM_SORT
        )
        ->withLabel($options[$sortation]);

        return [
            $vc_mode,
            $vc_sort
        ];
    }

    protected function getMapping(): \Closure
    {
        return function ($row, $question_result, $ui_factory, $environment) {
            $env = $environment[self::ENV];
            $lng = $environment[self::LNG];

            $title = htmlspecialchars($question_result->getTitle());

            $important_fields = [
                $lng->txt('position') => (string) ($question_result->getPosition() + 1),
                $lng->txt('question_id') => (string) $question_result->getId(),
                $lng->txt('question_type') => $lng->txt($question_result->getType()),
                $lng->txt('points') => sprintf(
                    '%s/%s (%s%%)',
                    (string) $question_result->getUserScore(),
                    (string) $question_result->getQuestionScore(),
                    (string) $question_result->getUserScorePercent()
                )
            ];

            $stats_fields = $important_fields;
            $stats_fields[$lng->txt('tst_question_hints_requested_hint_count_header')] = (string) $question_result->getNumberOfRequestedHints();
            $stats = $ui_factory->listing()->characteristicValue()->text($stats_fields);


            $feedback = $ui_factory->listing()->descriptive([
                $lng->txt('tst_feedback') => $question_result->getFeedback()
            ]);

            $contents = [];

            $contents[] = $stats;
            if ($env->getShowFeedback()) {
                $contents[] = $feedback;
            }

            if ($recap = $question_result->getContentForRecapitulation()) {
                $contents[] = $ui_factory->listing()->descriptive([
                    $lng->txt('suggested_solution') => $recap
                ]);
            }

            $listing = [
                $lng->txt('tst_header_participant') => $question_result->getUserAnswer()
            ];
            if ($autosave_content = $question_result->getAutosavedAnswer()) {
                $listing[$lng->txt('autosavecontent')] = $autosave_content;
            }

            $answer_contents = [
                $ui_factory->listing()->descriptive($listing)
            ];
            if ($env->getShowBestSolution()) {
                $answer_contents[] = $ui_factory->listing()->descriptive([
                    $lng->txt('tst_header_solution') => $question_result->getBestSolution()
                ]);
            }

            $answers = $ui_factory->layout()->alignment()->horizontal()->evenlyDistributed(...$answer_contents);
            $contents[] = $answers;

            $content = $ui_factory->layout()->alignment()->vertical(...$contents);

            switch ($question_result->getCorrect()) {
                case ilQuestionResult::CORRECT_FULL:
                    $icon_name = 'icon_ok.svg';
                    $label = $lng->txt("answer_is_right");
                    break;
                case ilQuestionResult::CORRECT_PARTIAL:
                    $icon_name = 'icon_mostly_ok.svg';
                    $label = $lng->txt("answer_is_not_correct_but_positive");
                    break;
                case ilQuestionResult::CORRECT_NONE:
                    $icon_name = 'icon_not_ok.svg';
                    $label = $lng->txt("answer_is_wrong");
                    break;
            }
            $path = ilUtil::getImagePath('standard/' . $icon_name);
            $correct_icon = $ui_factory->symbol()->icon()->custom(
                $path,
                $label
            );

            return $row
                ->withHeadline($title)
                ->withLeadingSymbol($correct_icon)
                ->withImportantFields($important_fields)
                ->withContent($content);
        };
    }
}