QuestionsTable.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
namespace ILIAS\Test\Questions\Presentation;
 
use ILIAS\Test\Utilities\TitleColumnsBuilder;
use ILIAS\Test\Questions\Properties\Repository as TestQuestionsRepository;
use ILIAS\Test\Questions\Properties\Properties as TestQuestionProperties;
use ILIAS\Refinery\Factory as Refinery;
use ILIAS\UI\Factory as UIFactory;
use ILIAS\UI\Component\Listing\Property as PropertyListing;
use ILIAS\UI\Component\Table\Ordering;
use ILIAS\UI\Component\Table\OrderingRetrieval;
use ILIAS\UI\Component\Table\OrderingRowBuilder;
use ILIAS\Language\Language;
use Psr\Http\Message\ServerRequestInterface;
 
class QuestionsTable implements OrderingRetrieval
{
    private ?array $records = null;
    public function __construct(
        private readonly UIFactory $ui_factory,
        private readonly Refinery $refinery,
        private readonly ServerRequestInterface $request,
        private readonly QuestionsTableActions $table_actions,
        private readonly Language $lng,
        private readonly \ilObjTest $test_obj,
        private readonly TestQuestionsRepository $questionrepository,
        private readonly TitleColumnsBuilder $title_builder,
    ) {
    }
 
    public function getSummary(): PropertyListing
    {
        $this->loadRecords();
 
        $listing = $this->ui_factory->listing()->property()
            ->withProperty(
                $this->lng->txt('tst_num_questions'),
                $this->refinery->kindlyTo()->string()->transform(
                    $this->test_obj->getQuestionCount()
                )
            );
 
        if ($this->test_obj->isRandomTest()) {
            return $listing;
        }
 
        return $listing->withProperty(
            $this->lng->txt('maximum_points'),
            $this->refinery->kindlyTo()->string()->transform(
                array_reduce(
                    $this->records,
                    fn(float $c, TestQuestionProperties $v): float
                        => $c + $v->getGeneralQuestionProperties()->getAvailablePoints(),
                    0.0
                )
            )
        );
 
    }
 
    public function getTableComponent(): Ordering
    {
        $table = $this->ui_factory->table()->ordering(
            $this,
            $this->table_actions->getOrderActionUrl(),
            '',
            $this->getColumns()
        )
        ->withId((string) $this->test_obj->getId())
        ->withActions($this->table_actions->getActions())
        ->withRequest($this->request);
 
 
 
        if ($this->test_obj->isRandomTest()
            || $this->test_obj->evalTotalPersons() !== 0) {
            return $table->withOrderingDisabled(true);
        }
 
        return $table;
    }
 
    public function getRows(
        OrderingRowBuilder $row_builder,
        array $visible_column_ids
    ): \Generator {
        foreach ($this->getRecords() as $record) {
            $row = $record->getAsQuestionsTableRow(
                $this->lng,
                $this->ui_factory,
                $this->refinery,
                $this->table_actions->getQuestionTargetLinkBuilder(),
                $row_builder,
                $this->title_builder
            );
            yield $this->table_actions->setDisabledActions($row, $record);
        }
    }
 
    private function getColumns(): array
    {
        $f = $this->ui_factory;
        $columns = [
            'question_id' => $f->table()->column()->text($this->lng->txt('question_id'))
                ->withIsOptional(true, false),
            'title' => $f->table()->column()->link($this->lng->txt('tst_question_title')),
            'description' => $f->table()->column()->text($this->lng->txt('description'))
                ->withIsOptional(true, false),
            'complete' => $f->table()->column()->boolean(
                $this->lng->txt('question_complete_title'),
                $f->symbol()->icon()->custom('assets/images/standard/icon_checked.svg', '', 'small'),
                $f->symbol()->icon()->custom('assets/images/standard/icon_alert.svg', '', 'small')
            ),
            'type_tag' => $f->table()->column()->text($this->lng->txt('tst_question_type')),
            'points' => $f->table()->column()->number($this->lng->txt('points'))->withDecimals(2),
            'author' => $f->table()->column()->text($this->lng->txt('author'))
                ->withIsOptional(true, false),
            'lifecycle' => $f->table()->column()->text($this->lng->txt('qst_lifecycle'))
                ->withIsOptional(true, false),
            'qpl' => $f->table()->column()->link($this->lng->txt('qpl')),
            'nr_of_answers' => $f->table()->column()->number($this->lng->txt('number_of_answers'))
                ->withIsOptional(true, false),
            'average_points' => $f->table()->column()->number($this->lng->txt('average_reached_points'))->withDecimals(2)
                ->withIsOptional(true, false),
            'percentage_points_achieved' => $f->table()->column()->text($this->lng->txt('percentage_points_achieved'))
                ->withIsOptional(true, false),
        ];
 
        return $columns;
    }
 
    private function getActions(): array
    {
        $this->table_actions->getActions();
    }
 
    private function getRecords(): \Generator
    {
        if ($this->records === null) {
            $this->loadRecords();
        }
        yield from $this->records;
    }
 
    private function loadRecords(): void
    {
        $this->records = $this->questionrepository
            ->getQuestionPropertiesWithAggregatedResultsForTest($this->test_obj);
        usort(
            $this->records,
            static fn(TestQuestionProperties $a, TestQuestionProperties $b): int =>
                $a->getSequenceInformation()?->getPlaceInSequence() <=> $b->getSequenceInformation()?->getPlaceInSequence()
        );
    }
}