class.ilTermsOfServiceDocumentTableGUI.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
use ILIAS\UI\Factory;
use ILIAS\UI\Renderer;
 
class ilTermsOfServiceDocumentTableGUI extends ilTermsOfServiceTableGUI
{
    protected Factory $uiFactory;
    protected Renderer $uiRenderer;
    protected bool $isEditable = false;
    protected int $factor = 10;
    protected int $i = 1;
    protected int $numRenderedCriteria = 0;
    protected ilTermsOfServiceCriterionTypeFactoryInterface $criterionTypeFactory;
    protected array $uiComponents = [];
 
    public function __construct(
        ilTermsOfServiceControllerEnabled $a_parent_obj,
        string $command,
        ilTermsOfServiceCriterionTypeFactoryInterface $criterionTypeFactory,
        Factory $uiFactory,
        Renderer $uiRenderer,
        bool $isEditable = false
    ) {
        $this->criterionTypeFactory = $criterionTypeFactory;
        $this->uiFactory = $uiFactory;
        $this->uiRenderer = $uiRenderer;
        $this->isEditable = $isEditable;
 
        $this->setId('tos_documents');
        $this->setFormName('tos_documents');
 
        parent::__construct($a_parent_obj, $command);
 
        $this->setTitle($this->lng->txt('tos_tbl_docs_title'));
        $this->setFormAction($this->ctrl->getFormAction($this->getParentObject(), $command));
 
        $this->setDefaultOrderDirection('ASC');
        $this->setDefaultOrderField('sorting');
        $this->setExternalSorting(true);
        $this->setExternalSegmentation(true);
        $this->setLimit(PHP_INT_MAX);
 
        $this->setRowTemplate('tpl.tos_documents_row.html', 'Services/TermsOfService');
 
        if ($this->isEditable) {
            $this->setSelectAllCheckbox('tos_id[]');
            $this->addMultiCommand('deleteDocuments', $this->lng->txt('delete'));
            $this->addCommandButton('saveDocumentSorting', $this->lng->txt('sorting_save'));
        }
    }
 
    protected function getColumnDefinition(): array
    {
        $i = 0;
 
        $columns = [];
 
        if ($this->isEditable) {
            $columns[++$i] = [
                'field' => 'chb',
                'txt' => '',
                'default' => true,
                'optional' => false,
                'sortable' => false,
                'is_checkbox' => true,
                'width' => '1%'
            ];
        }
 
        $columns[++$i] = [
            'field' => 'sorting',
            'txt' => $this->lng->txt('tos_tbl_docs_head_sorting'),
            'default' => true,
            'optional' => false,
            'sortable' => false,
            'width' => '5%'
        ];
 
        $columns[++$i] = [
            'field' => 'title',
            'txt' => $this->lng->txt('tos_tbl_docs_head_title'),
            'default' => true,
            'optional' => false,
            'sortable' => false,
            'width' => '25%'
        ];
 
        $columns[++$i] = [
            'field' => 'creation_ts',
            'txt' => $this->lng->txt('tos_tbl_docs_head_created'),
            'default' => true,
            'optional' => true,
            'sortable' => false
        ];
 
        $columns[++$i] = [
            'field' => 'modification_ts',
            'txt' => $this->lng->txt('tos_tbl_docs_head_last_change'),
            'default' => true,
            'optional' => true,
            'sortable' => false
        ];
 
        $columns[++$i] = [
            'field' => 'criteria',
            'txt' => $this->lng->txt('tos_tbl_docs_head_criteria'),
            'default' => true,
            'optional' => false,
            'sortable' => false
        ];
 
        if ($this->isEditable) {
            $columns[++$i] = [
                'field' => 'actions',
                'txt' => $this->lng->txt('actions'),
                'default' => true,
                'optional' => false,
                'sortable' => false,
                'width' => '10%'
            ];
        }
 
        return $columns;
    }
 
    protected function preProcessData(array &$data): void
    {
        foreach ($data['items'] as $key => $document) {
            $data['items'][$key] = [
                'id' => $document->getId(),
                'title' => $document->getTitle(),
                'creation_ts' => $document->getCreationTs(),
                'modification_ts' => $document->getModificationTs(),
                'text' => $document->getText(),
                'criteria' => '',
                'criteriaAssignments' => $document->criteria()
            ];
        }
    }
 
    protected function formatCellValue(string $column, array $row): string
    {
        if (in_array($column, ['creation_ts', 'modification_ts'])) {
            return ilDatePresentation::formatDate(new ilDateTime($row[$column], IL_CAL_UNIX));
        } elseif ('sorting' === $column) {
            return $this->formatSorting($row);
        } elseif ('title' === $column) {
            return $this->formatTitle($column, $row);
        } elseif ('actions' === $column) {
            return $this->formatActionsDropDown($column, $row);
        } elseif ('chb' === $column) {
            return ilLegacyFormElementsUtil::formCheckbox(false, 'tos_id[]', (string) $row['id']);
        } elseif ('criteria' === $column) {
            return $this->formatCriterionAssignments($column, $row);
        }
 
        return parent::formatCellValue($column, $row);
    }
 
    protected function formatActionsDropDown(string $column, array $row): string
    {
        if (!$this->isEditable) {
            return '';
        }
 
        $this->ctrl->setParameter($this->getParentObject(), 'tos_id', $row['id']);
 
        $editBtn = $this->uiFactory
            ->button()
            ->shy(
                $this->lng->txt('edit'),
                $this->ctrl->getLinkTarget($this->getParentObject(), 'showEditDocumentForm')
            );
 
        $deleteModal = $this->uiFactory
            ->modal()
            ->interruptive(
                $this->lng->txt('tos_doc_delete'),
                $this->lng->txt('tos_sure_delete_documents_s'),
                $this->ctrl->getFormAction($this->getParentObject(), 'deleteDocument')
            )
            ->withActionButtonLabel('deleteDocument');
 
        $deleteBtn = $this->uiFactory
            ->button()
            ->shy($this->lng->txt('delete'), '#')
            ->withOnClick($deleteModal->getShowSignal());
 
        $this->uiComponents[] = $deleteModal;
 
        $attachCriterionBtn = $this->uiFactory
            ->button()
            ->shy(
                $this->lng->txt('tos_tbl_docs_action_add_criterion'),
                $this->ctrl->getLinkTarget($this->getParentObject(), 'showAttachCriterionForm')
            );
 
        $this->ctrl->setParameter($this->getParentObject(), 'tos_id', null);
 
        $dropDown = $this->uiFactory
            ->dropdown()
            ->standard([$editBtn, $deleteBtn, $attachCriterionBtn])
            ->withLabel($this->lng->txt('actions'));
 
        return $this->uiRenderer->render([$dropDown]);
    }
 
    protected function formatCriterionAssignments(string $column, array $row): string
    {
        $items = [];
 
        if (0 === count($row['criteriaAssignments'])) {
            return $this->lng->txt('tos_tbl_docs_cell_not_criterion');
        }
 
        foreach ($row['criteriaAssignments'] as $criterion) {
            $this->ctrl->setParameter($this->getParentObject(), 'tos_id', $row['id']);
            $this->ctrl->setParameter($this->getParentObject(), 'crit_id', $criterion->getId());
 
            $editBtn = $this->uiFactory
                ->button()
                ->shy(
                    $this->lng->txt('edit'),
                    $this->ctrl->getLinkTarget($this->getParentObject(), 'showChangeCriterionForm')
                );
 
            $deleteModal = $this->uiFactory
                ->modal()
                ->interruptive(
                    $this->lng->txt('tos_doc_detach_crit_confirm_title'),
                    $this->lng->txt('tos_doc_sure_detach_crit'),
                    $this->ctrl->getFormAction($this->getParentObject(), 'detachCriterionAssignment')
                )
                ->withActionButtonLabel('detachCriterionAssignment');
 
            $deleteBtn = $this->uiFactory
                ->button()
                ->shy($this->lng->txt('delete'), '#')
                ->withOnClick($deleteModal->getShowSignal());
 
            $dropDown = $this->uiFactory
                ->dropdown()
                ->standard([$editBtn, $deleteBtn]);
 
            $criterionType = $this->criterionTypeFactory->findByTypeIdent($criterion->getCriterionId(), true);
            $typeGui = $criterionType->ui($this->lng);
 
            $items[implode(' ', [
                $typeGui->getIdentPresentation(),
                ($this->isEditable ? $this->uiRenderer->render($dropDown) : '')
            ])] =
                $this->uiFactory->legacy(
                    $this->uiRenderer->render(
                        $typeGui->getValuePresentation(
                            $criterion->getCriterionValue(),
                            $this->uiFactory
                        )
                    )
                );
 
            if ($this->isEditable) {
                $this->uiComponents[] = $deleteModal;
            }
 
            $this->ctrl->setParameter($this->getParentObject(), 'tos_id', null);
            $this->ctrl->setParameter($this->getParentObject(), 'crit_id', null);
        }
 
        $criteriaList = $this->uiFactory
            ->listing()
            ->descriptive($items);
 
        return $this->uiRenderer->render([
            $criteriaList
        ]);
    }
 
    protected function formatTitle(string $column, array $row): string
    {
        $modal = $this->uiFactory
            ->modal()
            ->lightbox([$this->uiFactory->modal()->lightboxTextPage($row['text'], $row['title'])]);
 
        $titleLink = $this->uiFactory
            ->button()
            ->shy($row[$column], '#')
            ->withOnClick($modal->getShowSignal());
 
        return $this->uiRenderer->render([$titleLink, $modal]);
    }
 
    protected function formatSorting(array $row): string
    {
        $value = ($this->i++) * $this->factor;
        if (!$this->isEditable) {
            return (string) $value;
        }
 
        $sortingField = new ilNumberInputGUI('', 'sorting[' . $row['id'] . ']');
        $sortingField->setValue((string) $value);
        $sortingField->setMaxLength(4);
        $sortingField->setSize(2);
 
        return $sortingField->render();
    }
 
    public function getHTML(): string
    {
        return parent::getHTML() . $this->uiRenderer->render($this->uiComponents);
    }
}