MailingListsMembersTable.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
namespace ILIAS\Contact\MailingLists;
 
use ILIAS\Data;
use ILIAS\UI;
use Psr\Http\Message\ServerRequestInterface;
use ilArrayUtil;
use ilUserUtil;
use ilMailingListsGUI;
use ilLanguage;
use ilMailingList;
 
class MailingListsMembersTable implements UI\Component\Table\DataRetrieval
{
    private readonly ServerRequestInterface $request;
    private readonly Data\Factory $data_factory;
    private ?array $records = null;
 
    public function __construct(
        private readonly ilMailingList $mailing_list,
        private readonly \ilCtrlInterface $ctrl,
        private readonly ilLanguage $lng,
        private readonly \ILIAS\UI\Factory $ui_factory,
        \ILIAS\HTTP\GlobalHttpState $http
    ) {
        $this->request = $http->request();
        $this->data_factory = new Data\Factory();
    }
 
    public function getComponent(): UI\Component\Table\Data
    {
        $columns = $this->getColumns();
        $actions = $this->getActions();
 
        return $this->ui_factory
            ->table()
            ->data(
                $this,
                \sprintf(
                    $this->lng->txt('mail_members_of_mailing_list'),
                    $this->mailing_list->getTitle()
                ),
                $columns,
            )
            ->withId(self::class . '_' . $this->mailing_list->getId())
            ->withOrder(new \ILIAS\Data\Order('login', \ILIAS\Data\Order::ASC))
            ->withActions($actions)
            ->withRequest($this->request);
    }
 
    private function getColumns(): array
    {
        return [
            'login' => $this->ui_factory
                ->table()
                ->column()
                ->text($this->lng->txt('login'))
                ->withIsSortable(true),
        ];
    }
 
    private function getActions(): array
    {
        $query_params_namespace = ['contact', 'mailinglist', 'members'];
 
        $uri = $this->data_factory->uri(
            ILIAS_HTTP_PATH . '/' . $this->ctrl->getLinkTargetByClass(
                ilMailingListsGUI::class,
                'handleMailingListMemberActions'
            )
        );
 
        $url_builder = new UI\URLBuilder($uri);
        [
            $url_builder,
            $action_parameter_token_copy,
            $row_id_token
        ] = $url_builder->acquireParameters(
            $query_params_namespace,
            'action',
            'entry_ids'
        );
 
        return [
            'confirmDeleteMembers' => $this->ui_factory->table()->action()->multi(
                $this->lng->txt('remove'),
                $url_builder->withParameter($action_parameter_token_copy, 'confirmDeleteMembers'),
                $row_id_token
            ),
        ];
    }
 
    private function initRecords(): void
    {
        if ($this->records === null) {
            $this->records = [];
            $i = 0;
            $entries = $this->mailing_list->getAssignedEntries();
            if ($entries !== []) {
                $usr_ids = array_map(static fn(array $entry): int => (int) $entry['usr_id'], $entries);
                $names = ilUserUtil::getNamePresentation($usr_ids, false, false, '', false, false, false);
 
                foreach ($entries as $entry) {
                    $this->records[$i]['a_id'] = $entry['a_id'];
                    $this->records[$i]['user_id'] = $entry['usr_id'];
                    $this->records[$i]['login'] = $names[$entry['usr_id']];
                    ++$i;
                }
            }
        }
    }
 
    public function getRows(
        UI\Component\Table\DataRowBuilder $row_builder,
        array $visible_column_ids,
        Data\Range $range,
        Data\Order $order,
        ?array $filter_data,
        ?array $additional_parameters
    ): \Generator {
        $records = $this->getRecords($range, $order);
 
        foreach ($records as $record) {
            $row_id = (string) $record['a_id'];
            yield $row_builder->buildDataRow($row_id, $record);
        }
    }
 
    public function getTotalRowCount(
        ?array $filter_data,
        ?array $additional_parameters
    ): ?int {
        $this->initRecords();
 
        return \count($this->records);
    }
 
    private function sortedRecords(Data\Order $order): array
    {
        $records = $this->records;
        [$order_field, $order_direction] = $order->join([], fn($ret, $key, $value) => [$key, $value]);
 
        return ilArrayUtil::stableSortArray($records, $order_field, strtolower($order_direction), false);
    }
 
    private function getRecords(Data\Range $range, Data\Order $order): array
    {
        $this->initRecords();
 
        $records = $this->sortedRecords($order);
 
        return $this->limitRecords($records, $range);
    }
 
    private function limitRecords(array $records, Data\Range $range): array
    {
        return \array_slice($records, $range->getStart(), $range->getLength());
    }
}