ILIAS\TestQuestionPool\Questions\Presentation\QuestionTable Class Reference

Inheritance diagram for ILIAS\TestQuestionPool\Questions\Presentation\QuestionTable:

Collaboration diagram for ILIAS\TestQuestionPool\Questions\Presentation\QuestionTable:

Public Member Functions
	__construct (protected UIFactory $ui_factory, protected UIRenderer $ui_renderer, protected DataFactory $data_factory, protected Refinery $refinery, protected URLBuilder $url_builder, protected URLBuilderToken $action_parameter_token, protected URLBuilderToken $row_id_token, protected \ilDBInterface $db, protected \ilLanguage $lng, protected \ilComponentRepository $component_repository, protected \ilRbacSystem $rbac, protected \ilObjUser $current_user, protected TaxonomyService $taxonomy, protected NotesService $notes_service, protected int $parent_obj_id, protected int $request_ref_id)
	getTable ()
	getFilter (\ilUIService $ui_service, string $action)
	Filters should be part of the Table; for now, since they are not fully integrated, they are rendered and applied seperately. More...
	getColums ()
	getRows (Table\DataRowBuilder $row_builder, array $visible_column_ids, Range $range, Order $order, ?array $filter_data, ?array $additional_parameters)
	getTotalRowCount (?array $filter_data, ?array $additional_parameters)
Public Member Functions inherited from ilAssQuestionList
	__construct (private ilDBInterface $db, private ilLanguage $lng, private Refinery $refinery, private ilComponentRepository $component_repository, private ?NotesService $notes_service=null)
	setOrder (?Order $order=null)
	setRange (?Range $range=null)
	getParentObjId ()
	setParentObjId (?int $parentObjId)
	setParentObjectType (string $parentObjType)
	setParentObjIdsFilter (array $parentObjIdsFilter)
	setQuestionInstanceTypeFilter (?string $questionInstanceTypeFilter)
	setIncludeQuestionIdsFilter (array $questionIdsFilter)
	setExcludeQuestionIdsFilter (array $excludeQuestionIdsFilter)
	addFieldFilter (string $fieldName, mixed $fieldValue)
	addTaxonomyFilter ($taxId, $taxNodes, $parentObjId, $parentObjType)
	addTaxonomyFilterNoTaxonomySet (bool $flag)
	setAvailableTaxonomyIds (array $availableTaxonomyIds)
	setAnswerStatusActiveId (?int $answerStatusActiveId)
	setAnswerStatusFilter (string $answerStatusFilter)
	setJoinObjectData (bool $a_val)
	Set if object data table should be joined. More...
	load ()
	getTotalRowCount (?array $filter_data, ?array $additional_parameters)
	setCommentFilter (?int $commented=null)
	getDataArrayForQuestionId (int $questionId)
	getQuestionDataArray ()
	isInList (int $questionId)
	getTitle (string $a_comp_id, string $a_item_type, int $a_item_id)
	Get title of an assigned item. More...
	getTitle (string $a_comp_id, string $a_item_type, int $a_item_id)
	Get title of an assigned item. More...

Protected Member Functions
	getData (Order $order, Range $range)
	getActions ()
	buildAction (string $act, string $type, bool $async=false)
	postOrder (array $list, \ILIAS\Data\Order $order)
Protected Member Functions inherited from ilAssQuestionList
	getTaxItems (string $parentType, int $parentObjId, int $taxId, int $taxNode)
	getNumberOfCommentsForQuestion (int $question_id)

Private Member Functions
	treeify (&$pointer, $stack)
	toNestedList (array $nodes)
	taxNodeReader ($tree, $sortfield, $node_id)
	singleTaxonomyRepresentation (int $tax_id, array $stored_tax_data, string $check_marker)
	taxonomyRepresentation (array $taxonomy_data)
	showCommentAction ()

Additional Inherited Members
Data Fields inherited from ilAssQuestionList
const	QUESTION_ANSWER_STATUS_NON_ANSWERED = 'nonAnswered'
	answer status domain for single questions More...
const	QUESTION_ANSWER_STATUS_WRONG_ANSWERED = 'wrongAnswered'
const	QUESTION_ANSWER_STATUS_CORRECT_ANSWERED = 'correctAnswered'
const	ANSWER_STATUS_FILTER_ALL_NON_CORRECT = 'allNonCorrect'
	answer status filter value domain More...
const	ANSWER_STATUS_FILTER_NON_ANSWERED_ONLY = 'nonAnswered'
const	ANSWER_STATUS_FILTER_WRONG_ANSWERED_ONLY = 'wrongAnswered'
const	QUESTION_INSTANCE_TYPE_ORIGINALS = 'QST_INSTANCE_TYPE_ORIGINALS'
const	QUESTION_INSTANCE_TYPE_DUPLICATES = 'QST_INSTANCE_TYPE_DUPLICATES'
const	QUESTION_INSTANCE_TYPE_ALL = 'QST_INSTANCE_TYPE_ALL'
const	QUESTION_COMMENTED_ONLY = '1'
const	QUESTION_COMMENTED_EXCLUDED = '2'
Protected Attributes inherited from ilAssQuestionList
bool	$join_obj_data = true
string	$filter_comments = null
array	$questions = []

Detailed Description

Definition at line 36 of file QuestionTable.php.

Constructor & Destructor Documentation

__construct()

ILIAS\TestQuestionPool\Questions\Presentation\QuestionTable::__construct	(	protected UIFactory	$ui_factory,
		protected UIRenderer	$ui_renderer,
		protected DataFactory	$data_factory,
		protected Refinery	$refinery,
		protected URLBuilder	$url_builder,
		protected URLBuilderToken	$action_parameter_token,
		protected URLBuilderToken	$row_id_token,
		protected \ilDBInterface	$db,
		protected \ilLanguage	$lng,
		protected \ilComponentRepository	$component_repository,
		protected \ilRbacSystem	$rbac,
		protected \ilObjUser	$current_user,
		protected TaxonomyService	$taxonomy,
		protected NotesService	$notes_service,
		protected int	$parent_obj_id,
		protected int	$request_ref_id
	)

Definition at line 38 of file QuestionTable.php.

      {
        $lng->loadLanguageModule('qpl');
        parent::__construct($db, $lng, $refinery, $component_repository, $notes_service);
        $this->setAvailableTaxonomyIds($taxonomy->getUsageOfObject($parent_obj_id));
    }

References ILIAS\$db, $lng, ILIAS\UI\examples\Layout\Page\Standard\$refinery, ILIAS\GlobalScreen\Provider\__construct(), and ilAssQuestionList\setAvailableTaxonomyIds().

Here is the call graph for this function:

Member Function Documentation

buildAction()

ILIAS\TestQuestionPool\Questions\Presentation\QuestionTable::buildAction ( string  $act, string  $type, bool  $async = false  )

protected

Definition at line 347 of file QuestionTable.php.

                                                                                  : array
    {
        $action = $this->ui_factory->table()->action()
            ->$type(
                $this->lng->txt($act),
                $this->url_builder->withParameter($this->action_parameter_token, $act),
                $this->row_id_token
            );
        if ($async) {
            $action = $action->withAsync(true);
        }
 
        return [$act => $action];
    }

References ILIAS\Repository\lng().

Here is the call graph for this function:

getActions()

ILIAS\TestQuestionPool\Questions\Presentation\QuestionTable::getActions ( )

protected

Definition at line 327 of file QuestionTable.php.

                                   : array
    {
        $write_access = $this->rbac->checkAccess('write', $this->request_ref_id);
        return array_merge(
            $this->buildAction('copy', 'standard'),
            $write_access ? $this->buildAction('move', 'standard') : [],
            $write_access ? $this->buildAction('delete', 'standard') : [],
            $this->buildAction('export', 'multi'),
            $this->buildAction('preview', 'single'),
            $this->buildAction('statistics', 'single'),
            $write_access ? $this->buildAction('edit_question', 'single') : [],
            $write_access ? $this->buildAction('edit_page', 'single') : [],
            $write_access ? $this->buildAction('feedback', 'single') : [],
            $write_access ? $this->buildAction(\ilBulkEditQuestionsGUI::CMD_EDITTAUTHOR, 'multi') : [],
            $write_access ? $this->buildAction(\ilBulkEditQuestionsGUI::CMD_EDITLIFECYCLE, 'multi') : [],
            $write_access ? $this->buildAction(\ilBulkEditQuestionsGUI::CMD_EDITTAXONOMIES, 'multi') : [],
            $this->showCommentAction() ? $this->buildAction('comments', 'single', true) : []
        );
    }

References ilBulkEditQuestionsGUI\CMD_EDITLIFECYCLE, ilBulkEditQuestionsGUI\CMD_EDITTAUTHOR, ilBulkEditQuestionsGUI\CMD_EDITTAXONOMIES, and ILIAS\Repository\rbac().

Referenced by ILIAS\TestQuestionPool\Questions\Presentation\QuestionTable\getTable().

Here is the call graph for this function:

Here is the caller graph for this function:

getColums()

ILIAS\TestQuestionPool\Questions\Presentation\QuestionTable::getColums

(

)

Definition at line 150 of file QuestionTable.php.

                               : array
    {
        $f = $this->ui_factory->table()->column();
        $df = $this->data_factory->dateFormat();
        $icon_yes = $this->ui_factory->symbol()->icon()->custom(\ilUtil::getImagePath('standard/icon_checked.svg'), 'yes');
        $icon_no = $this->ui_factory->symbol()->icon()->custom(\ilUtil::getImagePath('standard/icon_unchecked.svg'), 'no');
 
        return [
            'title' => $f->link($this->lng->txt('title')),
            'description' => $f->text($this->lng->txt('description'))->withIsOptional(true, true),
            'ttype' => $f->text($this->lng->txt('question_type'))->withIsOptional(true, true),
            'points' => $f->number($this->lng->txt('points'))->withDecimals(2)->withIsOptional(true, true),
            'author' => $f->text($this->lng->txt('author'))->withIsOptional(true, true),
            'lifecycle' => $f->text($this->lng->txt('qst_lifecycle'))->withIsOptional(true, true),
            'taxonomies' => $f->text($this->lng->txt('qpl_settings_subtab_taxonomies'))->withIsOptional(true, true),
            'feedback' => $f->boolean($this->lng->txt('feedback'), $icon_yes, $icon_no)->withIsOptional(true, true),
            'created' => $f->date(
                $this->lng->txt('create_date'),
                $this->current_user->getDateTimeFormat()
            )->withIsOptional(true, true),
            'tstamp' => $f->date(
                $this->lng->txt('last_update'),
                $this->current_user->getDateTimeFormat()
            )->withIsOptional(true, true),
            'comments' => $f->number($this->lng->txt('comments'))->withIsOptional(true, false),
        ];
    }

References Vendor\Package\$f, ilUtil\getImagePath(), and ILIAS\Repository\lng().

Here is the call graph for this function:

getData()

ILIAS\TestQuestionPool\Questions\Presentation\QuestionTable::getData ( Order  $order, Range  $range  )

protected

Definition at line 317 of file QuestionTable.php.

                                                          : array
    {
        $this->setParentObjId($this->parent_obj_id);
        $this->load();
        $data = $this->postOrder($this->getQuestionDataArray(), $order);
        [$offset, $length] = $range->unpack();
        $length = $length > 0 ? $length : null;
        return array_slice($data, $offset, $length);
    }

References $data, ILIAS\UI\Implementation\Component\Table\$range, and ILIAS\Data\Range\unpack().

Here is the call graph for this function:

getFilter()

ILIAS\TestQuestionPool\Questions\Presentation\QuestionTable::getFilter	(	\ilUIService	$ui_service,
		string	$action
	)

Filters should be part of the Table; for now, since they are not fully integrated, they are rendered and applied seperately.

Definition at line 76 of file QuestionTable.php.

                                                                       : Filter
    {
        $lifecycle_options = array_merge(
            ['' => $this->lng->txt('qst_lifecycle_filter_all')],
            \ilAssQuestionLifecycle::getDraftInstance()->getSelectOptions($this->lng)
        );
        $question_type_options = [
            '' => $this->lng->txt('filter_all_question_types')
        ];
        $question_types = \ilObjQuestionPool::_getQuestionTypes();
        foreach ($question_types as $translation => $row) {
            $question_type_options[$row['type_tag']] = $translation;
        }
 
        $field_factory = $this->ui_factory->input()->field();
        $filter_inputs = [
            'title' => $field_factory->text($this->lng->txt("title")),
            'description' => $field_factory->text($this->lng->txt("description")),
            'author' => $field_factory->text($this->lng->txt("author")),
            'lifecycle' => $field_factory->select($this->lng->txt("qst_lifecycle"), $lifecycle_options),
            'type' => $field_factory->select($this->lng->txt("type"), $question_type_options),
            'commented' => $field_factory->select(
                $this->lng->txt("ass_comments"),
                [
                    \ilAssQuestionList::QUESTION_COMMENTED_ONLY => $this->lng->txt('qpl_filter_commented_only'),
                    \ilAssQuestionList::QUESTION_COMMENTED_EXCLUDED => $this->lng->txt('qpl_filter_commented_exclude')
                ]
            )
        ];
 
        $taxs = $this->taxonomy->getUsageOfObject($this->parent_obj_id, true);
        $tax_filter_options = [
            'null' => '<b>' . $this->lng->txt('tax_filter_notax') . '</b>'
        ];
 
        foreach ($taxs as $tax_entry) {
            $tax = new \ilObjTaxonomy($tax_entry['tax_id']);
            $tax_tree = $tax->getTree();
            $sortfield = $tax->getSortingMode() === \ilObjTaxonomy::SORT_ALPHABETICAL ? 'title' : 'order_nr';
            $children = $this->taxNodeReader($tax_tree, $sortfield, $tax_tree->readRootId());
            $nodes = implode('-', array_map(fn($node) => $node['obj_id'], $children));
 
            $tax_id = $tax_entry['tax_id'] . '-0-' . $nodes;
            $tax_title = '<b>' . $tax_entry['title'] . '</b>';
            if ($children === []) {
                continue;
            }
            $tax_filter_options[$tax_id] = $tax_title;
 
            foreach ($children as $subtax) {
                $stax_id = $subtax['tax_id'] . '-' . $subtax['obj_id'];
                $stax_title = str_repeat('&nbsp; ', ($subtax['depth'] - 2) * 2)
                    . ' &boxur;&HorizontalLine; '
                    . $subtax['title'];
 
                $tax_filter_options[$stax_id] = $stax_title;
            }
        }
        $filter_inputs['taxonomies'] = $field_factory->multiSelect($this->lng->txt("tax_filter"), $tax_filter_options);
 
        $active = array_fill(0, count($filter_inputs), true);
 
        $filter = $ui_service->filter()->standard(
            'question_table_filter_id',
            $action,
            $filter_inputs,
            $active,
            true,
            true
        );
        return $filter;
    }

References ilObjQuestionPool\_getQuestionTypes(), ilUIService\filter(), ilAssQuestionLifecycle\getDraftInstance(), ILIAS\Repository\lng(), ilAssQuestionList\QUESTION_COMMENTED_EXCLUDED, ilAssQuestionList\QUESTION_COMMENTED_ONLY, ilObjTaxonomy\SORT_ALPHABETICAL, and ILIAS\TestQuestionPool\Questions\Presentation\QuestionTable\taxNodeReader().

Here is the call graph for this function:

getRows()

ILIAS\TestQuestionPool\Questions\Presentation\QuestionTable::getRows	(	Table\DataRowBuilder	$row_builder,
		array	$visible_column_ids,
		Range	$range,
		Order	$order,
		?array	$filter_data,
		?array	$additional_parameters
	)

Definition at line 277 of file QuestionTable.php.

     : \Generator {
        $timezone = new \DateTimeZone($this->current_user->getTimeZone());
        foreach ($this->getData($order, $range) as $record) {
            $row_id = (string) $record['question_id'];
            $record['created'] = (new \DateTimeImmutable("@{$record['created']}"))->setTimezone($timezone);
            $record['tstamp'] = (new \DateTimeImmutable("@{$record['tstamp']}"))->setTimezone($timezone);
            $lifecycle = \ilAssQuestionLifecycle::getInstance($record['lifecycle']);
            $record['lifecycle'] = $lifecycle->getTranslation($this->lng);
 
            $title = $record['title'];
            $to_question = $this->url_builder
                ->withParameter($this->action_parameter_token, 'preview')
                ->withParameter($this->row_id_token, $row_id)
                ->buildURI()->__toString();
            if (!(bool) $record['complete']) {
                $title .= ' (' . $this->lng->txt('warning_question_not_complete') . ')';
            }
            $record['title'] = $this->ui_factory->link()->standard($title, $to_question);
            $record['taxonomies'] = $this->taxonomyRepresentation($record['taxonomies']);
 
            yield $row_builder->buildDataRow($row_id, $record);
        }
    }

References $lifecycle, ilAssQuestionLifecycle\getInstance(), and ILIAS\Repository\lng().

Here is the call graph for this function:

getTable()

ILIAS\TestQuestionPool\Questions\Presentation\QuestionTable::getTable

(

)

Definition at line 61 of file QuestionTable.php.

                              : Table\Data
    {
        return $this->ui_factory->table()->data(
            $this,
            $this->lng->txt('questions'),
            $this->getColums(),
        )
        ->withActions($this->getActions())
        ->withId('qpt' . $this->parent_obj_id . '_' . $this->request_ref_id);
    }

References ILIAS\TestQuestionPool\Questions\Presentation\QuestionTable\getActions(), ILIAS\Repository\lng(), and ILIAS\UI\Component\Table\Data\withActions().

Here is the call graph for this function:

getTotalRowCount()

ILIAS\TestQuestionPool\Questions\Presentation\QuestionTable::getTotalRowCount	(	?array	$filter_data,
		?array	$additional_parameters
	)

Reimplemented from ilAssQuestionList.

Definition at line 308 of file QuestionTable.php.

     : ?int {
        $this->setParentObjId($this->parent_obj_id);
        $this->load();
        return count($this->getQuestionDataArray());
    }

postOrder()

ILIAS\TestQuestionPool\Questions\Presentation\QuestionTable::postOrder ( array  $list, \ILIAS\Data\Order  $order  )

protected

Definition at line 362 of file QuestionTable.php.

                                                                       : array
    {
        [$aspect, $direction] = $order->join('', function ($i, $k, $v) {
            return [$k, $v];
        });
        usort($list, static function (array $a, array $b) use ($aspect): int {
            if (is_numeric($a[$aspect]) || is_bool($a[$aspect])) {
                return $a[$aspect] <=> $b[$aspect];
            }
            if (is_array($a[$aspect])) {
                return $a[$aspect] <=> $b[$aspect];
            }
 
            $aspect_a = '';
            $aspect_b = '';
            if ($a[$aspect] !== null) {
                $aspect_a = $a[$aspect];
            }
            if ($b[$aspect] !== null) {
                $aspect_b = $b[$aspect];
            }
 
            return strcoll($aspect_a, $aspect_b);
        });
 
        if ($direction === $order::DESC) {
            $list = array_reverse($list);
        }
        return $list;
    }

References Vendor\Package\$a, and Vendor\Package\$b.

showCommentAction()

ILIAS\TestQuestionPool\Questions\Presentation\QuestionTable::showCommentAction ( )

private

Definition at line 393 of file QuestionTable.php.

                                        : bool
    {
        return $this->notes_service->domain()->commentsActive($this->parent_obj_id)
            || $this->rbac->checkAccess('write', $this->request_ref_id);
    }

References ILIAS\Repository\rbac().

Here is the call graph for this function:

singleTaxonomyRepresentation()

ILIAS\TestQuestionPool\Questions\Presentation\QuestionTable::singleTaxonomyRepresentation ( int  $tax_id, array  $stored_tax_data, string  $check_marker  )

private

Definition at line 226 of file QuestionTable.php.

     : string {
        $tax = new \ilObjTaxonomy($tax_id);
        $tax_tree = $tax->getTree();
        $sortfield = $tax->getSortingMode() === \ilObjTaxonomy::SORT_ALPHABETICAL ? 'title' : 'order_nr';
        $taxnodes = $this->taxNodeReader($tax_tree, $sortfield, $tax_tree->readRootId());
 
        $nodes = [];
        foreach ($taxnodes as $taxnode) {
            $taxdata = array_filter(
                $stored_tax_data,
                fn($data_child) => $data_child['node_id'] === $taxnode['obj_id']
            );
 
            foreach (array_keys($taxdata) as $node_obj_id) {
                $path = array_map(
                    fn($n) => in_array($n['obj_id'], array_keys($stored_tax_data)) ? $check_marker . $n['title'] : $n['title'],
                    $tax_tree->getPathFull($node_obj_id),
                );
                $path[0] = \ilObject::_lookupTitle($tax_id);
                $this->treeify($nodes, $path);
            }
        }
        return $this->toNestedList($nodes);
    }

taxNodeReader()

ILIAS\TestQuestionPool\Questions\Presentation\QuestionTable::taxNodeReader (   $tree,   $sortfield,   $node_id  )

private

Definition at line 205 of file QuestionTable.php.

                                                               : array
    {
        $ret = [];
        $nodes = $tree->getChildsByTypeFilter($node_id, ['taxn']);
        usort(
            $nodes,
            fn($a, $b) => strcmp(
                (string) $a[$sortfield],
                (string) $b[$sortfield]
            )
        );
 
        foreach ($nodes as $node) {
            $ret[] = $node;
            foreach ($this->taxNodeReader($tree, $sortfield, $node['obj_id']) as $c) {
                $ret[] = $c;
            }
        }
        return $ret;
    }

References Vendor\Package\$a, Vendor\Package\$b, $c, and ILIAS\TestQuestionPool\Questions\Presentation\QuestionTable\taxNodeReader().

Referenced by ILIAS\TestQuestionPool\Questions\Presentation\QuestionTable\getFilter(), and ILIAS\TestQuestionPool\Questions\Presentation\QuestionTable\taxNodeReader().

Here is the call graph for this function:

Here is the caller graph for this function:

taxonomyRepresentation()

ILIAS\TestQuestionPool\Questions\Presentation\QuestionTable::taxonomyRepresentation ( array  $taxonomy_data )

private

Definition at line 255 of file QuestionTable.php.

                                                                 : string
    {
        $check = $this->ui_renderer->render(
            $this->ui_factory->symbol()->icon()->custom(\ilUtil::getImagePath('standard/icon_checked.svg'), 'checked')
        );
 
        $taxonomies = [];
        $taxs = $this->taxonomy->getUsageOfObject($this->parent_obj_id, true);
        foreach ($taxs as $tax_entry) {
            $tax_id = $tax_entry['tax_id'];
            if (!array_key_exists($tax_id, $taxonomy_data)) {
                continue;
            }
            $taxonomies[] = $this->singleTaxonomyRepresentation(
                $tax_id,
                $taxonomy_data[$tax_id],
                $check
            );
        }
        return implode('', $taxonomies);
    }

References $check, and ilUtil\getImagePath().

Here is the call graph for this function:

toNestedList()

ILIAS\TestQuestionPool\Questions\Presentation\QuestionTable::toNestedList ( array  $nodes )

private

Definition at line 190 of file QuestionTable.php.

                                               : string
    {
        $entries = [];
        foreach ($nodes as $k => $n) {
            if ($n === []) {
                $entries[] = $k;
            } else {
                $entries[] = $k . $this->toNestedList($n);
            }
        }
        return $this->ui_renderer->render(
            $this->ui_factory->listing()->unordered($entries)
        );
    }

References ILIAS\TestQuestionPool\Questions\Presentation\QuestionTable\toNestedList().

Referenced by ILIAS\TestQuestionPool\Questions\Presentation\QuestionTable\toNestedList().

Here is the call graph for this function:

Here is the caller graph for this function:

treeify()

ILIAS\TestQuestionPool\Questions\Presentation\QuestionTable::treeify ( &  $pointer,   $stack  )

private

Definition at line 178 of file QuestionTable.php.

    {
        $hop = array_shift($stack);
        if (!$hop) {
            return;
        }
        if (! array_key_exists($hop, $pointer)) {
            $pointer[$hop] = [];
        }
        $this->treeify($pointer[$hop], $stack);
    }

References ILIAS\TestQuestionPool\Questions\Presentation\QuestionTable\treeify().

Referenced by ILIAS\TestQuestionPool\Questions\Presentation\QuestionTable\treeify().

Here is the call graph for this function:

Here is the caller graph for this function:

---

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

• components/ILIAS/TestQuestionPool/src/Questions/Presentation/QuestionTable.php