ilTestPassResultsTable Class Reference

Collaboration diagram for ilTestPassResultsTable:

Public Member Functions
	__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)
	render ()

Protected Member Functions
	applyControls (string $mode, string $sortation, array $question_results)
	getViewControlNamespace ()
	getViewControlsParameter ()
	getViewControls (UIFactory $ui_factory, ilLanguage $lng, URLBuilder $target, string $mode, string $sortation)
	return [] More...
	getMapping ()

Protected Attributes
Presentation	$table

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

Detailed Description

Definition at line 33 of file class.ilTestPassResultsTable.php.

Constructor & Destructor Documentation

__construct()

ilTestPassResultsTable::__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
	)

Definition at line 48 of file class.ilTestPassResultsTable.php.

References $lng, $results, applyControls(), getMapping(), ilTestPassResult\getQuestionResults(), ilTestPassResult\getSettings(), getViewControls(), and getViewControlsParameter().

      {
        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);
    }

Here is the call graph for this function:

Member Function Documentation

applyControls()

ilTestPassResultsTable::applyControls ( string  $mode, string  $sortation, array  $question_results  )

protected

Parameters

ilQuestionResult[]

$question_results

Definition at line 82 of file class.ilTestPassResultsTable.php.

References Vendor\Package\$a, Vendor\Package\$b, ilQuestionResult\CORRECT_FULL, and ilQuestionResult\getQuestionScore().

Referenced by __construct().

      {
        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;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getMapping()

ilTestPassResultsTable::getMapping ( )

protected

Definition at line 174 of file class.ilTestPassResultsTable.php.

References $lng, $path, ilQuestionResult\CORRECT_FULL, ilQuestionResult\CORRECT_NONE, ilQuestionResult\CORRECT_PARTIAL, and ilUtil\getImagePath().

Referenced by __construct().

                                   : \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);
        };
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getViewControlNamespace()

ilTestPassResultsTable::getViewControlNamespace ( )

protected

Definition at line 110 of file class.ilTestPassResultsTable.php.

References $namespace.

Referenced by getViewControls(), and getViewControlsParameter().

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

Here is the caller graph for this function:

getViewControls()

ilTestPassResultsTable::getViewControls ( UIFactory  $ui_factory, ilLanguage  $lng, URLBuilder  $target, string  $mode, string  $sortation  )

protected

return []

Definition at line 135 of file class.ilTestPassResultsTable.php.

References $check, $token, ILIAS\UI\URLBuilder\acquireParameter(), ILIAS\UI\URLBuilder\buildURI(), getViewControlNamespace(), ilLanguage\txt(), and ILIAS\UI\URLBuilder\withParameter().

Referenced by __construct().

     : 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
        ];
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getViewControlsParameter()

ilTestPassResultsTable::getViewControlsParameter ( )

protected

Definition at line 118 of file class.ilTestPassResultsTable.php.

References getViewControlNamespace(), ILIAS\FileDelivery\http(), and ILIAS\Repository\refinery().

Referenced by __construct().

                                                 : 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];
    }

Here is the call graph for this function:

Here is the caller graph for this function:

render()

ilTestPassResultsTable::render

(

)

Definition at line 74 of file class.ilTestPassResultsTable.php.

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

Field Documentation

$table

Presentation ilTestPassResultsTable::$table

protected

Definition at line 46 of file class.ilTestPassResultsTable.php.

ENV

const ilTestPassResultsTable::ENV = 'e'

private

Definition at line 35 of file class.ilTestPassResultsTable.php.

LNG

const ilTestPassResultsTable::LNG = 'l'

private

Definition at line 36 of file class.ilTestPassResultsTable.php.

MODE_OPT_ALL

const ilTestPassResultsTable::MODE_OPT_ALL = "all"

private

Definition at line 39 of file class.ilTestPassResultsTable.php.

MODE_OPT_CORRECT

const ilTestPassResultsTable::MODE_OPT_CORRECT = "ok"

private

Definition at line 40 of file class.ilTestPassResultsTable.php.

MODE_OPT_INCORRECT

const ilTestPassResultsTable::MODE_OPT_INCORRECT = "fail"

private

Definition at line 41 of file class.ilTestPassResultsTable.php.

PARAM_MODE

const ilTestPassResultsTable::PARAM_MODE = 'm'

private

Definition at line 38 of file class.ilTestPassResultsTable.php.

PARAM_SORT

const ilTestPassResultsTable::PARAM_SORT = 's'

private

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

SORT_OPT_ORDEROFAPPEARANCE

const ilTestPassResultsTable::SORT_OPT_ORDEROFAPPEARANCE = 'ooa'

private

Definition at line 43 of file class.ilTestPassResultsTable.php.

SORT_OPT_POSSIBLESCORE

const ilTestPassResultsTable::SORT_OPT_POSSIBLESCORE = 'ms'

private

Definition at line 44 of file class.ilTestPassResultsTable.php.

URL_NAMESPACE

const ilTestPassResultsTable::URL_NAMESPACE = ['taresult', 'vc']

private

Definition at line 37 of file class.ilTestPassResultsTable.php.

---

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

• Modules/Test/classes/Results/class.ilTestPassResultsTable.php