class.ilAssQuestionHintsTableGUI.php

Go to the documentation of this file.

<?php

class ilAssQuestionHintsTableGUI extends ilTable2GUI
{
    public const INDEX_TO_POSITION_FACTOR = 10;

    public const TBL_MODE_TESTOUTPUT = '1';
    public const TBL_MODE_ADMINISTRATION = '2';

    private $questionOBJ = null;

    private $tableMode = null;

    private $hintOrderingClipboard = null;

    public function __construct(
        assQuestion $questionOBJ,
        ilAssQuestionHintList $questionHintList,
        ilAssQuestionHintAbstractGUI $parentGUI,
        $parentCmd,
        $tableMode = self::TBL_MODE_TESTOUTPUT,
        ilAssQuestionHintsOrderingClipboard $hintOrderingClipboard = null
    ) {
        global $DIC;
        $ilCtrl = $DIC['ilCtrl'];
        $lng = $DIC['lng'];

        $this->questionOBJ = $questionOBJ;
        $this->tableMode = $tableMode;
        $this->hintOrderingClipboard = $hintOrderingClipboard;

        $this->setPrefix('tsthints' . $tableMode);
        $this->setId('tsthints' . $tableMode);

        parent::__construct($parentGUI, $parentCmd);

        $this->setTitle(sprintf($lng->txt('tst_question_hints_table_header'), $questionOBJ->getTitleForHTMLOutput()));
        $this->setNoEntriesText($lng->txt('tst_question_hints_table_no_items'));

        // we don't take care about offset/limit values, so this avoids segmentation in general
        // --> required for ordering via clipboard feature
        $this->setExternalSegmentation(true);

        $tableData = $questionHintList->getTableData();

        if ($this->questionOBJ->isAdditionalContentEditingModePageObject()) {
            require_once 'Modules/TestQuestionPool/classes/class.ilAssHintPageGUI.php';

            foreach ($tableData as $key => $data) {
                $this->questionOBJ->ensureHintPageObjectExists($data['hint_id']);
                $pageObjectGUI = new ilAssHintPageGUI($data['hint_id']);
                $pageObjectGUI->setOutputMode("presentation");
                $tableData[$key]['hint_text'] = $pageObjectGUI->presentation();
            }
        }

        $this->setData($tableData);

        if ($this->tableMode == self::TBL_MODE_ADMINISTRATION) {
            $this->setRowTemplate('tpl.tst_question_hints_administration_table_row.html', 'Modules/TestQuestionPool');

            $this->setSelectAllCheckbox('hint_ids[]');

            $rowCount = count($tableData);
            $this->initAdministrationColumns($rowCount);
            $this->initAdministrationCommands($rowCount);
        } else {
            $this->setRowTemplate('tpl.tst_question_hints_testoutput_table_row.html', 'Modules/TestQuestionPool');

            $this->initTestoutputColumns();
            $this->initTestoutputCommands();
        }
    }

    private function initAdministrationCommands($rowCount): void
    {
        global $DIC;
        $ilCtrl = $DIC['ilCtrl'];
        $lng = $DIC['lng'];

        $this->setFormAction($ilCtrl->getFormAction($this->parent_obj));

        if ($this->hintOrderingClipboard->hasStored()) {
            $this->addMultiCommand(
                ilAssQuestionHintsGUI::CMD_PASTE_FROM_ORDERING_CLIPBOARD_BEFORE,
                $lng->txt('tst_questions_hints_table_multicmd_paste_hint_before')
            );

            $this->addMultiCommand(
                ilAssQuestionHintsGUI::CMD_PASTE_FROM_ORDERING_CLIPBOARD_AFTER,
                $lng->txt('tst_questions_hints_table_multicmd_paste_hint_after')
            );
        } elseif ($rowCount > 0) {
            $this->addMultiCommand(
                ilAssQuestionHintsGUI::CMD_CONFIRM_DELETE,
                $lng->txt('tst_questions_hints_table_multicmd_delete_hint')
            );

            if ($rowCount > 1) {
                $this->addMultiCommand(
                    ilAssQuestionHintsGUI::CMD_CUT_TO_ORDERING_CLIPBOARD,
                    $lng->txt('tst_questions_hints_table_multicmd_cut_hint')
                );
            }

            $this->addCommandButton(
                ilAssQuestionHintsGUI::CMD_SAVE_LIST_ORDER,
                $lng->txt('tst_questions_hints_table_cmd_save_order')
            );
        }
    }

    private function initTestoutputCommands(): void
    {
        if ($this->parent_obj instanceof ilAssQuestionHintsGUI) {
            return;
        }

        global $DIC;
        $ilCtrl = $DIC['ilCtrl'];
        $lng = $DIC['lng'];

        $this->setFormAction($ilCtrl->getFormAction($this->parent_obj));

        $this->addCommandButton(
            ilAssQuestionHintRequestGUI::CMD_BACK_TO_QUESTION,
            $lng->txt('tst_question_hints_back_to_question')
        );
    }

    private function initAdministrationColumns($rowCount): void
    {
        global $DIC;
        $lng = $DIC['lng'];

        $this->addColumn('', '', '30', true);

        $this->addColumn($lng->txt('tst_question_hints_table_column_hint_order'), 'hint_index', '60');
        $this->addColumn($lng->txt('tst_question_hints_table_column_hint_text'), 'hint_text');
        $this->addColumn($lng->txt('tst_question_hints_table_column_hint_points'), 'hint_points', '250');

        $this->addColumn('', '', '100');

        $this->setDefaultOrderField("hint_index");
        $this->setDefaultOrderDirection("asc");

        if ($rowCount < 1) {
            $this->disable('header');
        }
    }

    private function initTestoutputColumns(): void
    {
        global $DIC;
        $lng = $DIC['lng'];

        $this->addColumn($lng->txt('tst_question_hints_table_column_hint_index'), 'hint_index', '200');
        $this->addColumn($lng->txt('tst_question_hints_table_column_hint_text'), 'hint_text');
        $this->addColumn($lng->txt('tst_question_hints_table_column_hint_points'), 'hint_points', '200');

        $this->setDefaultOrderField("hint_index");
        $this->setDefaultOrderDirection("asc");
    }

    public function numericOrdering(string $a_field): bool
    {
        switch ($a_field) {
            case 'hint_index':
            case 'hint_points':

                return true;
        }

        return false;
    }

    public function fillRow(array $a_set): void
    {
        global $DIC;
        $ilCtrl = $DIC['ilCtrl'];
        $lng = $DIC['lng'];

        if ($this->tableMode == self::TBL_MODE_ADMINISTRATION) {
            $list = new ilAdvancedSelectionListGUI();
            $list->setListTitle($lng->txt('actions'));
            $list->setId("advsl_hint_{$a_set['hint_id']}_actions");

            if ($this->questionOBJ->isAdditionalContentEditingModePageObject()) {
                $editPointsHref = $ilCtrl->getLinkTargetByClass('ilAssQuestionHintGUI', ilAssQuestionHintGUI::CMD_SHOW_FORM);
                $editPointsHref = ilUtil::appendUrlParameterString($editPointsHref, "hint_id={$a_set['hint_id']}", true);
                $list->addItem($lng->txt('tst_question_hints_table_link_edit_hint_points'), '', $editPointsHref);

                $editPageHref = $ilCtrl->getLinkTargetByClass('ilasshintpagegui', 'edit');
                $editPageHref = ilUtil::appendUrlParameterString($editPageHref, "hint_id={$a_set['hint_id']}", true);
                $list->addItem($lng->txt('tst_question_hints_table_link_edit_hint_page'), '', $editPageHref);
            } else {
                $editHref = $ilCtrl->getLinkTargetByClass('ilAssQuestionHintGUI', ilAssQuestionHintGUI::CMD_SHOW_FORM);
                $editHref = ilUtil::appendUrlParameterString($editHref, "hint_id={$a_set['hint_id']}", true);
                $list->addItem($lng->txt('tst_question_hints_table_link_edit_hint'), '', $editHref);
            }

            $deleteHref = $ilCtrl->getLinkTarget($this->parent_obj, ilAssQuestionHintsGUI::CMD_CONFIRM_DELETE);
            $deleteHref = ilUtil::appendUrlParameterString($deleteHref, "hint_id={$a_set['hint_id']}", true);
            $list->addItem($lng->txt('tst_question_hints_table_link_delete_hint'), '', $deleteHref);

            $this->tpl->setVariable('ACTIONS', $list->getHTML());

            $this->tpl->setVariable('HINT_ID', $a_set['hint_id']);

            $hintIndex = $a_set['hint_index'] * self::INDEX_TO_POSITION_FACTOR;
        } else {
            $showHref = $this->parent_obj->getHintPresentationLinkTarget($a_set['hint_id']);

            $this->tpl->setVariable('HINT_HREF', $showHref);

            $hintIndex = ilAssQuestionHint::getHintIndexLabel($lng, $a_set['hint_index']);
        }

        $this->tpl->setVariable('HINT_INDEX', $hintIndex);
        $txt = ilLegacyFormElementsUtil::prepareTextareaOutput($a_set['hint_text'], true);
        $this->tpl->setVariable('HINT_TEXT', $txt);
        $this->tpl->setVariable('HINT_POINTS', $a_set['hint_points']);
    }
}