class.ilTermsOfServiceTableGUI.php

Go to the documentation of this file.

<?php declare(strict_types=1);
/* Copyright (c) 1998-2018 ILIAS open source, Extended GPL, see docs/LICENSE */
 
abstract class ilTermsOfServiceTableGUI extends ilTable2GUI
{
    protected $provider;
 
    protected $visibleOptionalColumns = [];
 
    protected $optionalColumns = [];
 
    protected $filter = [];
 
    protected $optional_filter = [];
 
    public function __construct($a_parent_obj, $command = '', $a_template_context = '')
    {
        parent::__construct($a_parent_obj, $command, $a_template_context);
 
        $columns = $this->getColumnDefinition();
        $this->optionalColumns = (array) $this->getSelectableColumns();
        $this->visibleOptionalColumns = (array) $this->getSelectedColumns();
 
        foreach ($columns as $index => $column) {
            if ($this->isColumnVisible($index)) {
                $this->addColumn(
                    $column['txt'],
                    isset($column['sortable']) && $column['sortable'] ? $column['field'] : '',
                    isset($column['width']) ? $column['width'] : '',
                    isset($column['is_checkbox']) ? (bool) $column['is_checkbox'] : false
                );
            }
        }
    }
 
    public function setProvider(ilTermsOfServiceTableDataProvider $provider) : void
    {
        $this->provider = $provider;
    }
 
    public function getProvider() : ? ilTermsOfServiceTableDataProvider
    {
        return $this->provider;
    }
 
    protected function onBeforeDataFetched(array &$params, array &$filter) : void
    {
    }
 
    protected function prepareRow(array &$row) : void
    {
    }
 
    protected function preProcessData(array &$data) : void
    {
    }
 
    protected function formatCellValue(string $column, array $row) : string
    {
        return trim($row[$column]);
    }
 
    public function getSelectableColumns()
    {
        $optionalColumns = array_filter($this->getColumnDefinition(), function ($column) {
            return isset($column['optional']) && $column['optional'];
        });
 
        $columns = [];
        foreach ($optionalColumns as $index => $column) {
            $columns[$column['field']] = $column;
        }
 
        return $columns;
    }
 
    protected function isColumnVisible(int $index) : bool
    {
        $columnDefinition = $this->getColumnDefinition();
        if (array_key_exists($index, $columnDefinition)) {
            $column = $columnDefinition[$index];
            if (isset($column['optional']) && !$column['optional']) {
                return true;
            }
 
            if (
                is_array($this->visibleOptionalColumns) &&
                array_key_exists($column['field'], $this->visibleOptionalColumns)
            ) {
                return true;
            }
        }
 
        return false;
    }
 
    final protected function fillRow($row)
    {
        $this->prepareRow($row);
 
        foreach ($this->getColumnDefinition() as $index => $column) {
            if (!$this->isColumnVisible($index)) {
                continue;
            }
 
            $this->tpl->setCurrentBlock('column');
            $value = $this->formatCellValue($column['field'], $row);
            if ((string) $value === '') {
                $this->tpl->touchBlock('column');
            } else {
                $this->tpl->setVariable('COLUMN_VALUE', $value);
            }
 
            $this->tpl->parseCurrentBlock();
        }
    }
 
    abstract protected function getColumnDefinition() : array;
 
    public function populate() : void
    {
        if ($this->getExternalSegmentation() && $this->getExternalSorting()) {
            $this->determineOffsetAndOrder();
        } else {
            if (!$this->getExternalSegmentation() && $this->getExternalSorting()) {
                $this->determineOffsetAndOrder(true);
            }
        }
 
        $params = [];
        if ($this->getExternalSegmentation()) {
            $params['limit'] = $this->getLimit();
            $params['offset'] = $this->getOffset();
        }
        if ($this->getExternalSorting()) {
            $params['order_field'] = $this->getOrderField();
            $params['order_direction'] = $this->getOrderDirection();
        }
 
        $this->determineSelectedFilters();
        $filter = (array) $this->filter;
 
        foreach ($this->optional_filter as $key => $value) {
            if ($this->isFilterSelected($key)) {
                $filter[$key] = $value;
            }
        }
 
        $this->onBeforeDataFetched($params, $filter);
        $data = $this->getProvider()->getList($params, $filter);
 
        if (!count($data['items']) && $this->getOffset() > 0 && $this->getExternalSegmentation()) {
            $this->resetOffset();
            if ($this->getExternalSegmentation()) {
                $params['limit'] = $this->getLimit();
                $params['offset'] = $this->getOffset();
            }
            $data = $this->provider->getList($params, $filter);
        }
 
        $this->preProcessData($data);
 
        $this->setData($data['items']);
        if ($this->getExternalSegmentation()) {
            $this->setMaxCount($data['cnt']);
        }
    }
}