class.ilMailAutoCompleteRecipientResult.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
class ilMailAutoCompleteRecipientResult
{
    final public const int MODE_STOP_ON_MAX_ENTRIES = 1;
    final public const int MODE_FETCH_ALL = 2;
    final public const int MAX_RESULT_ENTRIES = 1000;
 
    protected bool $allow_smtp;
    protected int $user_id;
    protected array $handled_recipients = [];
    protected int $mode = self::MODE_STOP_ON_MAX_ENTRIES;
    protected int $max_entries;
    public array $result = [
        'items' => [],
        'hasMoreResults' => false
    ];
 
    public function __construct(int $mode)
    {
        global $DIC;
 
        $this->allow_smtp = $DIC->rbac()->system()->checkAccess('smtp_mail', MAIL_SETTINGS_ID);
        $this->user_id = $DIC->user()->getId();
        $this->max_entries = ilSearchSettings::getInstance()->getAutoCompleteLength();
 
        $this->initMode($mode);
    }
 
    protected function initMode(int $mode): void
    {
        if (!in_array($mode, [self::MODE_FETCH_ALL, self::MODE_STOP_ON_MAX_ENTRIES], true)) {
            throw new InvalidArgumentException("Wrong mode passed!");
        }
        $this->mode = $mode;
    }
 
    public function isResultAddable(): bool
    {
        if ($this->mode === self::MODE_STOP_ON_MAX_ENTRIES &&
            $this->max_entries >= 0 && count($this->result['items']) >= $this->max_entries) {
            return false;
        }
 
        if ($this->mode === self::MODE_FETCH_ALL &&
            count($this->result['items']) >= self::MAX_RESULT_ENTRIES) {
            return false;
        }
 
        return true;
    }
 
    public function addResult(string $login, string $firstname, string $lastname): void
    {
        if ($login !== '' && !isset($this->handled_recipients[$login])) {
            $recipient = [];
            $recipient['value'] = $login;
 
            $label = $login;
            if ($firstname && $lastname) {
                $label .= " [" . $firstname . ", " . $lastname . "]";
            }
            $recipient['label'] = $label;
 
            $this->result['items'][] = $recipient;
            $this->handled_recipients[$login] = 1;
        }
    }
 
    public function getItems(): array
    {
        return $this->result;
    }
 
    public function numItems(): int
    {
        return count($this->result['items']);
    }
}