ilMail Class Reference

Inheritance diagram for ilMail:

Collaboration diagram for ilMail:

Public Member Functions
	__construct (private int $a_user_id, private ?ilMailAddressTypeFactory $mail_address_type_factory=null, private ilMailRfc822AddressParserFactory $mail_address_parser_factory=new ilMailRfc822AddressParserFactory(), private ?ilAppEventHandler $event_handler=null, private ?ilLogger $logger=null, private ?ilDBInterface $db=null, private ?ilLanguage $lng=null, private ?ilFileDataMail $mail_file_data=null, protected ?ilMailOptions $mail_options=null, private ?ilMailbox $mailbox=null, private ?ilMailMimeSenderFactory $sender_factory=null, private ?Closure $usr_id_by_login_callable=null, private ?AutoresponderService $auto_responder_service=null, private ?int $mail_admin_node_ref_id=null, private ?int $mail_obj_ref_id=null, private ?ilObjUser $actor=null, private ?ilMailTemplatePlaceholderResolver $placeholder_resolver=null, private ?ilMailTemplatePlaceholderToEmptyResolver $placeholder_to_empty_resolver=null, ?Conductor $legal_documents=null, ?MailSignatureService $signature_service=null,)
	autoresponder ()
	withContextId (string $context_id)
	withContextParameters (array $parameters)
	existsRecipient (string $new_recipient, string $existing_recipients)
	setSaveInSentbox (bool $save_in_sentbox)
	getSaveInSentbox ()
	getMailObjectReferenceId ()
	formatNamesForOutput (string $recipients)
	getPreviousMail (int $mail_id)
	getNextMail (int $mail_id)
	getMailsOfFolder (int $a_folder_id, array $filter=[])
	countMailsOfFolder (int $folder_id)
	deleteMailsOfFolder (int $folder_id)
	getMail (int $mail_id)
	markRead (array $mail_ids)
	markUnread (array $mail_ids)
	moveMailsToFolder (array $mail_ids, int $folder_id)
	deleteMails (array $mail_ids)
	getNewDraftId (int $folder_id)
	updateDraft (int $a_folder_id, array $a_attachments, string $a_rcp_to, string $a_rcp_cc, string $a_rcp_bcc, string $a_m_subject, string $a_m_message, int $a_draft_id=0, bool $a_use_placeholders=false, ?string $a_tpl_context_id=null, array $a_tpl_context_params=[])
	persistToStage (int $a_user_id, array $a_attachments, string $a_rcp_to, string $a_rcp_cc, string $a_rcp_bcc, string $a_m_subject, string $a_m_message, bool $a_use_placeholders=false, ?string $a_tpl_context_id=null, ?array $a_tpl_ctx_params=[])
	retrieveFromStage ()
	enqueue (string $a_rcp_to, string $a_rcp_cc, string $a_rcp_bcc, string $a_m_subject, string $a_m_message, array $a_attachment, bool $a_use_placeholders=false)
	Should be used to enqueue a 'mail'. More...
	sendMail (MailDeliveryData $mail_data)
	This method is used to finally send internal messages and external emails To use the mail system as a consumer, please use ilMail::enqueue. More...
	validateRecipients (string $to, string $cc, string $bcc)
	saveAttachments (array $attachments)
	appendInstallationSignature (?bool $a_flag=null)
	setUserInstanceById (array $user_instances_by_id_map)
	setMailOptionsByUserIdMap (array $mail_options_by_usr_id_map)
	formatLinebreakMessage (string $message)

Static Public Member Functions
static	_getAutoGeneratedMessageString (?ilLanguage $lang=null)
static	_getIliasMailerName ()
static	_getInstallationSignature ()
static	getSalutation (int $a_usr_id, ?ilLanguage $a_language=null)

Data Fields
const string	ILIAS_HOST = 'ilias'
const string	PROP_CONTEXT_SUBJECT_PREFIX = 'subject_prefix'
int	$user_id

Protected Attributes
array	$mail_data = []

Private Member Functions
	isSystemMail ()
	readMailObjectReferenceId ()
	fetchMailData (?array $row)
	sendInternalMail (int $folder_id, int $sender_usr_id, array $attachments, string $to, string $cc, string $bcc, string $status, string $subject, string $message, int $usr_id=0, bool $use_placeholders=false, ?string $template_contenxt_id=null, array $template_context_parameters=[])
	replacePlaceholders (string $message, int $usr_id=0)
	replacePlaceholdersEmpty (string $message)
	distributeMail (MailDeliveryData $mail_data)
	sendMailWithReplacedPlaceholder (MailDeliveryData $mail_data, array $to_usr_ids)
	sendMailWithReplacedEmptyPlaceholder (MailDeliveryData $mail_data, array $recipients,)
	sendMailWithoutReplacedPlaceholder (MailDeliveryData $mail_data, array $to_usr_ids, array $cc_bcc_recipients)
	sendChanneledMails (MailDeliveryData $mail_data, array $recipients, string $message)
	delegateExternalEmails (string $subject, array $attachments, string $message, array $usr_id_to_external_email_addresses_map)
	getUserIds (array $recipients)
	checkMail (string $to, string $cc, string $bcc, string $subject)
	checkRecipients (string $recipients)
	getSubjectSentFolderId ()
	saveInSentbox (array $attachment, string $to, string $cc, string $bcc, string $subject, string $message)
	sendMimeMail (string $to, string $cc, string $bcc, string $subject, string $message, array $attachments)
	parseAddresses (string $addresses)
	Explode recipient string, allowed separators are ',' ';' ' '. More...
	getCountRecipient (string $recipients, bool $only_external_addresses=true)
	getCountRecipients (string $to_recipients, string $cc_recipients, string $bcc_recipients, bool $only_external_addresses=true)
	getEmailRecipients (string $recipients)
	getUserInstanceById (int $usr_id)
	getMailOptionsByUserId (int $usr_id)
	createRecipient (int $user_id)

Private Attributes
MailSignatureService	$signature_service
string	$table_mail
string	$table_mail_saved
bool	$save_in_sentbox
bool	$append_installation_signature = false
bool	$append_user_signature = false
string	$context_id = null
array	$context_parameters = []
array	$mail_options_by_usr_id_map = []
array	$user_instances_by_id_map = []
int	$max_recipient_character_length = 998
readonly Conductor	$legal_documents

Detailed Description

Definition at line 27 of file class.ilMail.php.

Constructor & Destructor Documentation

__construct()

ilMail::__construct	(	private int	$a_user_id,
		private ?ilMailAddressTypeFactory	$mail_address_type_factory = null,
		private ilMailRfc822AddressParserFactory	$mail_address_parser_factory = new ilMailRfc822AddressParserFactory(),
		private ?ilAppEventHandler	$event_handler = null,
		private ?ilLogger	$logger = null,
		private ?ilDBInterface	$db = null,
		private ?ilLanguage	$lng = null,
		private ?ilFileDataMail	$mail_file_data = null,
		protected ?ilMailOptions	$mail_options = null,
		private ?ilMailbox	$mailbox = null,
		private ?ilMailMimeSenderFactory	$sender_factory = null,
		private ?Closure	$usr_id_by_login_callable = null,
		private ?AutoresponderService	$auto_responder_service = null,
		private ?int	$mail_admin_node_ref_id = null,
		private ?int	$mail_obj_ref_id = null,
		private ?ilObjUser	$actor = null,
		private ?ilMailTemplatePlaceholderResolver	$placeholder_resolver = null,
		private ?ilMailTemplatePlaceholderToEmptyResolver	$placeholder_to_empty_resolver = null,
		?Conductor	$legal_documents = null,
		?MailSignatureService	$signature_service = null
	)

Definition at line 53 of file class.ilMail.php.

References $DIC, $lng, ilObjUser\_lookupId(), ilLoggerFactory\getLogger(), ILIAS\Repository\int(), ILIAS\Repository\lng(), ILIAS\Repository\logger(), null, readMailObjectReferenceId(), and setSaveInSentbox().

      {
        global $DIC;
        $this->logger = $logger ?? ilLoggerFactory::getLogger('mail');
        $this->mail_address_type_factory = $mail_address_type_factory ?? new ilMailAddressTypeFactory(null, $logger);
        $this->event_handler = $event_handler ?? $DIC->event();
        $this->db = $db ?? $DIC->database();
        $this->lng = $lng ?? $DIC->language();
        $this->actor = $actor ?? $DIC->user();
        $this->mail_file_data = $mail_file_data ?? new ilFileDataMail($a_user_id);
        $this->mail_options = $mail_options ?? new ilMailOptions($a_user_id);
        $this->mailbox = $mailbox ?? new ilMailbox($a_user_id);

        $this->sender_factory = $sender_factory ?? $DIC->mail()->mime()->senderFactory();
        $this->usr_id_by_login_callable = $usr_id_by_login_callable ?? (static fn(string $login): int => (int) ilObjUser::_lookupId($login));
        $this->auto_responder_service = $auto_responder_service ?? $DIC->mail()->autoresponder();
        $this->user_id = $a_user_id;
        if ($this->mail_obj_ref_id === null) {
            $this->readMailObjectReferenceId();
        }
        $this->lng->loadLanguageModule('mail');
        $this->table_mail = 'mail';
        $this->table_mail_saved = 'mail_saved';
        $this->setSaveInSentbox(false);
        $this->placeholder_resolver = $placeholder_resolver ?? $DIC->mail()->placeholderResolver();
        $this->placeholder_to_empty_resolver = $placeholder_to_empty_resolver ?? $DIC->mail()->placeholderToEmptyResolver();
        $this->legal_documents = $legal_documents ?? $DIC['legalDocuments'];
        $this->signature_service = $signature_service ?? $DIC->mail()->signature();
    }

Here is the call graph for this function:

Member Function Documentation

_getAutoGeneratedMessageString()

static ilMail::_getAutoGeneratedMessageString ( ?ilLanguage  $lang = null )

static

Definition at line 1342 of file class.ilMail.php.

References $DIC, $lang, ilUtil\_getHttpPath(), ilLanguageFactory\_getLanguage(), and ILIAS_VERSION_NUMERIC.

Referenced by ilSystemNotification\compose(), ilUserCronCheckAccounts\run(), ilMailSummaryNotification\send(), ilECSObjectSettings\sendNewContentNotification(), ilRemoteObjectBase\sendNewContentNotification(), and ilECSAppEventListener\sendNotification().

                                                                                   : string
    {
        global $DIC;

        if (!($lang instanceof ilLanguage)) {
            $lang = ilLanguageFactory::_getLanguage();
        }

        $lang->loadLanguageModule('mail');

        return sprintf(
            $lang->txt('mail_auto_generated_info'),
            $DIC->settings()->get('inst_name', 'ILIAS ' . ((int) ILIAS_VERSION_NUMERIC)),
            ilUtil::_getHttpPath()
        ) . "\n\n";
    }

Here is the call graph for this function:

Here is the caller graph for this function:

_getIliasMailerName()

static ilMail::_getIliasMailerName ( )

static

Definition at line 1359 of file class.ilMail.php.

References $DIC.

Referenced by ilMailFolderGUI\confirmDeleteMails(), ilPDMailBlockGUI\getListItemForData(), ILIAS\Mail\Folder\MailFolderTableUI\getSender(), ilMailFolderGUI\printMail(), ilMailSummaryNotification\send(), and ilMailTest\testGetIliasMailerName().

                                                : string
    {
        global $DIC;
        $sender_factory = $DIC->mail()->mime()->senderFactory();

        return $sender_factory->system()->getFromName();
    }

Here is the caller graph for this function:

_getInstallationSignature()

static ilMail::_getInstallationSignature ( )

static

Definition at line 1380 of file class.ilMail.php.

References $DIC.

Referenced by ilObjUserGUI\__sendProfileMail(), ilForumMailNotification\addLinkToMail(), ilSystemNotification\compose(), ilForumMailEventNotificationSender\createAttachmentLinkText(), ilTimingsCronReminder\fillObjectListForMailBody(), ilCronDeleteInactiveUserReminderMailNotification\initLanguage(), ilMailSummaryNotification\send(), ILIAS\Wiki\Notification\NotificationGUI\send(), ILIAS\Mail\Cron\ExpiredOrOrphanedMails\MailNotification\send(), ILIAS\User\Profile\ChangeMailMail\sendEmailToExistingAddress(), ILIAS\User\Profile\ChangeMailMail\sendEmailToNewEmailAddress(), ILIAS\LegalDocuments\ConsumerToolbox\Mail\sendGeneric(), ilAccountRegistrationMail\sendLanguageVariableBasedAccountMail(), ilWikiUtil\sendNotification(), and ilObjSurveyGUI\sendUserResultsMail().

                                                      : string
    {
        global $DIC;
        return $DIC->mail()->signature()->installation();
    }

Here is the caller graph for this function:

appendInstallationSignature()

ilMail::appendInstallationSignature

(

?bool

$a_flag = null

)

Returns

self|bool

Definition at line 1370 of file class.ilMail.php.

References $append_installation_signature, and null.

Referenced by enqueue().

    {
        if ($a_flag === null) {
            return $this->append_installation_signature;
        }

        $this->append_installation_signature = $a_flag;
        return $this;
    }

Here is the caller graph for this function:

autoresponder()

ilMail::autoresponder

(

)

Definition at line 103 of file class.ilMail.php.

                                   : AutoresponderService
    {
        return $this->auto_responder_service;
    }

checkMail()

ilMail::checkMail ( string  $to, string  $cc, string  $bcc, string  $subject  )

private

Returns

list<ilMailError>

Definition at line 866 of file class.ilMail.php.

References ilStr\strLen().

Referenced by enqueue().

                                                                                    : array
    {
        $errors = [];

        $checks = [
            $subject => 'mail_add_subject',
            $to => 'mail_add_recipient',
        ];
        foreach ($checks as $string => $error) {
            if ($string === '') {
                $errors[] = new ilMailError($error);
            }
        }

        if (ilStr::strLen($subject) > 255) {
            // https://mantis.ilias.de/view.php?id=37881
            $errors[] = new ilMailError('mail_subject_too_long');
        }

        return $errors;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

checkRecipients()

ilMail::checkRecipients ( string  $recipients )

private

Returns

list<ilMailError>

Definition at line 891 of file class.ilMail.php.

References Vendor\Package\$e, and parseAddresses().

Referenced by validateRecipients().

                                                        : array
    {
        $errors = [];

        try {
            $addresses = $this->parseAddresses($recipients);
            foreach ($addresses as $address) {
                $address_type = $this->mail_address_type_factory->getByPrefix($address);
                if (!$address_type->validate($this->user_id)) {
                    $errors[] = $address_type->getErrors();
                }
            }
        } catch (Exception $e) {
            $position = strpos($e->getMessage(), ':');
            throw new ilMailException(
                ($position === false) ? $e->getMessage() : substr($e->getMessage(), $position + 2),
                $e->getCode(),
                $e
            );
        }

        return array_merge(...$errors);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

countMailsOfFolder()

ilMail::countMailsOfFolder

(

int

$folder_id

)

Definition at line 264 of file class.ilMail.php.

References $res.

                                                      : int
    {
        $res = $this->db->queryF(
            "SELECT COUNT(*) FROM $this->table_mail WHERE user_id = %s AND folder_id = %s",
            ['integer', 'integer'],
            [$this->user_id, $folder_id]
        );

        return $this->db->numRows($res);
    }

createRecipient()

ilMail::createRecipient ( int  $user_id )

private

Definition at line 1453 of file class.ilMail.php.

References getMailOptionsByUserId(), and getUserInstanceById().

Referenced by distributeMail(), sendMailWithoutReplacedPlaceholder(), and sendMailWithReplacedPlaceholder().

                                                  : Recipient
    {
        return new Recipient(
            $user_id,
            $this->getUserInstanceById($user_id),
            $this->getMailOptionsByUserId($user_id),
            $this->legal_documents
        );
    }

Here is the call graph for this function:

Here is the caller graph for this function:

delegateExternalEmails()

ilMail::delegateExternalEmails ( string  $subject, array  $attachments, string  $message, array  $usr_id_to_external_email_addresses_map  )

private

Parameters

list<string>	$attachments
array<int,string[]>	$usr_id_to_external_email_addresses_map

Definition at line 779 of file class.ilMail.php.

References sendMimeMail(), and ilStr\strLen().

Referenced by sendChanneledMails().

     : void {
        if (count($usr_id_to_external_email_addresses_map) === 1) {
            $usr_id_to_external_email_addresses_map = array_values($usr_id_to_external_email_addresses_map);
            $first_addresses = current($usr_id_to_external_email_addresses_map);

            $this->sendMimeMail(
                implode(',', $first_addresses),
                '',
                '',
                $subject,
                $message,
                $attachments
            );
        } elseif (count($usr_id_to_external_email_addresses_map) > 1) {
            $flattened_email_addresses = iterator_to_array(new RecursiveIteratorIterator(new RecursiveArrayIterator(
                $usr_id_to_external_email_addresses_map
            )), false);

            $flattened_email_addresses = array_unique($flattened_email_addresses);

            // https://mantis.ilias.de/view.php?id=23981 and https://www.ietf.org/rfc/rfc2822.txt
            $remaining_addresses = '';
            foreach ($flattened_email_addresses as $email_address) {
                $sep = '';
                if ($remaining_addresses !== '') {
                    $sep = ',';
                }

                $recipients_line_length = ilStr::strLen($remaining_addresses) +
                    ilStr::strLen($sep . $email_address);
                if ($recipients_line_length >= $this->max_recipient_character_length) {
                    $this->sendMimeMail(
                        '',
                        '',
                        $remaining_addresses,
                        $subject,
                        $message,
                        $attachments
                    );

                    $remaining_addresses = '';
                    $sep = '';
                }

                $remaining_addresses .= ($sep . $email_address);
            }

            if ($remaining_addresses !== '') {
                $this->sendMimeMail(
                    '',
                    '',
                    $remaining_addresses,
                    $subject,
                    $message,
                    $attachments
                );
            }
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

deleteMails()

ilMail::deleteMails

(

array

$mail_ids

)

Parameters

list<int>

$mailIds

Definition at line 375 of file class.ilMail.php.

References $id.

Referenced by deleteMailsOfFolder(), and sendMail().

                                                : void
    {
        $mail_ids = array_filter(array_map('intval', $mail_ids));
        foreach ($mail_ids as $id) {
            $this->db->manipulateF(
                "DELETE FROM $this->table_mail WHERE user_id = %s AND mail_id = %s",
                ['integer', 'integer'],
                [$this->user_id, $id]
            );
            $this->mail_file_data->deassignAttachmentFromDirectory($id);
        }
    }

Here is the caller graph for this function:

deleteMailsOfFolder()

ilMail::deleteMailsOfFolder

(

int

$folder_id

)

Definition at line 275 of file class.ilMail.php.

References deleteMails(), and getMailsOfFolder().

                                                       : void
    {
        $mails = $this->getMailsOfFolder($folder_id);
        foreach ($mails as $mail_data) {
            $this->deleteMails([$mail_data['mail_id']]);
        }
    }

Here is the call graph for this function:

distributeMail()

ilMail::distributeMail ( MailDeliveryData  $mail_data )

private

Definition at line 591 of file class.ilMail.php.

References createRecipient(), MailDeliveryData\getBcc(), MailDeliveryData\getCc(), MailDeliveryData\getTo(), getUserIds(), MailDeliveryData\isUsePlaceholder(), ILIAS\Repository\logger(), sendMailWithoutReplacedPlaceholder(), sendMailWithReplacedEmptyPlaceholder(), and sendMailWithReplacedPlaceholder().

Referenced by sendMail().

                                                                : bool
    {
        $this->auto_responder_service->emptyAutoresponderData();
        $to_usr_ids = $this->getUserIds([$mail_data->getTo()]);
        $this->logger->debug(sprintf(
            'Parsed TO user ids from given recipients for serial letter notification: %s',
            implode(', ', $to_usr_ids)
        ));

        $other_usr_ids = $this->getUserIds([$mail_data->getCc(), $mail_data->getBcc()]);
        $cc_bcc_recipients = array_map(
            $this->createRecipient(...),
            $other_usr_ids
        );
        $this->logger->debug(sprintf(
            'Parsed CC/BCC user ids from given recipients for serial letter notification: %s',
            implode(', ', $other_usr_ids)
        ));

        if ($mail_data->isUsePlaceholder()) {
            $this->sendMailWithReplacedPlaceholder($mail_data, $to_usr_ids);
            $this->sendMailWithReplacedEmptyPlaceholder($mail_data, $cc_bcc_recipients);
        } else {
            $this->sendMailWithoutReplacedPlaceholder($mail_data, $to_usr_ids, $cc_bcc_recipients);
        }

        $this->auto_responder_service->disableAutoresponder();
        $this->auto_responder_service->handleAutoresponderMails($this->user_id);

        return true;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

enqueue()

ilMail::enqueue	(	string	$a_rcp_to,
		string	$a_rcp_cc,
		string	$a_rcp_bcc,
		string	$a_m_subject,
		string	$a_m_message,
		array	$a_attachment,
		bool	$a_use_placeholders = false
	)

Should be used to enqueue a 'mail'.

A validation is executed before, errors are returned

Parameters

list<string>

$a_attachment

Returns

list<ilMailError>

Definition at line 974 of file class.ilMail.php.

References $DIC, appendInstallationSignature(), checkMail(), ilContext\CONTEXT_CRON, getCountRecipients(), getSaveInSentbox(), ilContext\getType(), isSystemMail(), ILIAS\Repository\lng(), ILIAS\Repository\logger(), sendMail(), and validateRecipients().

     : array {
        global $DIC;

        $this->logger->info(
            'New mail system task:' .
            ' To: ' . $a_rcp_to .
            ' | CC: ' . $a_rcp_cc .
            ' | BCC: ' . $a_rcp_bcc .
            ' | Subject: ' . $a_m_subject .
            ' | Attachments: ' . print_r($a_attachment, true)
        );

        if ($a_attachment && !$this->mail_file_data->checkFilesExist($a_attachment)) {
            return [new ilMailError('mail_attachment_file_not_exist', [implode(', ', $a_attachment)])];
        }

        $errors = $this->checkMail($a_rcp_to, $a_rcp_cc, $a_rcp_bcc, $a_m_subject);
        if ($errors !== []) {
            return $errors;
        }

        $errors = $this->validateRecipients($a_rcp_to, $a_rcp_cc, $a_rcp_bcc);
        if ($errors !== []) {
            return $errors;
        }

        $rcp_to = $a_rcp_to;
        $rcp_cc = $a_rcp_cc;
        $rcp_bcc = $a_rcp_bcc;

        $number_of_external_addresses = $this->getCountRecipients($rcp_to, $rcp_cc, $rcp_bcc);
        if (
            $number_of_external_addresses > 0 &&
            !$this->isSystemMail() &&
            !$DIC->rbac()->system()->checkAccessOfUser($this->user_id, 'smtp_mail', $this->mail_obj_ref_id)
        ) {
            return [new ilMailError('mail_no_permissions_write_smtp')];
        }

        if ($this->appendInstallationSignature()) {
            $a_m_message .= self::_getInstallationSignature();
        }

        if (ilContext::getType() === ilContext::CONTEXT_CRON) {
            $mail_data = new MailDeliveryData(
                $rcp_to,
                $rcp_cc,
                $rcp_bcc,
                $a_m_subject,
                $a_m_message,
                $a_attachment,
                $a_use_placeholders
            );
            return $this->sendMail($mail_data);
        }

        $task_factory = $DIC->backgroundTasks()->taskFactory();
        $task_manager = $DIC->backgroundTasks()->taskManager();

        $bucket = new BasicBucket();
        $bucket->setUserId($this->user_id);

        $task = $task_factory->createTask(ilMailDeliveryJob::class, [
            $this->user_id,
            $rcp_to,
            $rcp_cc,
            $rcp_bcc,
            $a_m_subject,
            $a_m_message,
            serialize($a_attachment),
            $a_use_placeholders,
            $this->getSaveInSentbox(),
            (string) $this->context_id,
            serialize(array_merge(
                $this->context_parameters,
                [
                    'auto_responder' => $this->auto_responder_service->isAutoresponderEnabled()
                ]
            ))
        ]);
        $interaction = $task_factory->createTask(ilMailDeliveryJobUserInteraction::class, [
            $task,
            $this->user_id,
        ]);

        $bucket->setTask($interaction);
        $bucket->setTitle($this->lng->txt('mail_bg_task_title'));
        $bucket->setDescription(sprintf($this->lng->txt('mail_bg_task_desc'), $a_m_subject));

        $this->logger->info('Delegated delivery to background task');
        $task_manager->run($bucket);

        return [];
    }

Here is the call graph for this function:

existsRecipient()

ilMail::existsRecipient	(	string	$new_recipient,
		string	$existing_recipients
	)

Definition at line 131 of file class.ilMail.php.

References parseAddresses().

                                                                                       : bool
    {
        $new_addresses = new ilMailAddressListImpl($this->parseAddresses($new_recipient));
        $addresses = new ilMailAddressListImpl($this->parseAddresses($existing_recipients));
        $list = new ilMailDiffAddressList($new_addresses, $addresses);

        $diffed_addresses = $list->value();

        return $diffed_addresses === [];
    }

Here is the call graph for this function:

fetchMailData()

ilMail::fetchMailData ( ?array  $row )

private

Definition at line 388 of file class.ilMail.php.

References ILIAS\Repository\int(), and null.

Referenced by getMail(), getMailsOfFolder(), getNextMail(), getPreviousMail(), and retrieveFromStage().

                                               : ?array
    {
        if (!is_array($row) || empty($row)) {
            return null;
        }

        if (isset($row['attachments'])) {
            $unserialized = unserialize(stripslashes((string) $row['attachments']), ['allowed_classes' => false]);
            $row['attachments'] = is_array($unserialized) ? $unserialized : [];
        } else {
            $row['attachments'] = [];
        }

        if (isset($row['tpl_ctx_params']) && is_string($row['tpl_ctx_params'])) {
            $decoded = json_decode($row['tpl_ctx_params'], true, 512, JSON_THROW_ON_ERROR);
            $row['tpl_ctx_params'] = (array) ($decoded ?? []);
        } else {
            $row['tpl_ctx_params'] = [];
        }

        if (isset($row['mail_id'])) {
            $row['mail_id'] = (int) $row['mail_id'];
        }

        if (isset($row['user_id'])) {
            $row['user_id'] = (int) $row['user_id'];
        }

        if (isset($row['folder_id'])) {
            $row['folder_id'] = (int) $row['folder_id'];
        }

        if (isset($row['sender_id'])) {
            $row['sender_id'] = (int) $row['sender_id'];
        }

        if (isset($row['use_placeholders'])) {
            $row['use_placeholders'] = (bool) $row['use_placeholders'];
        }

        $null_to_string_properties = ['m_subject', 'm_message', 'rcp_to', 'rcp_cc', 'rcp_bcc'];
        foreach ($null_to_string_properties as $null_to_string_property) {
            if (!isset($row[$null_to_string_property])) {
                $row[$null_to_string_property] = '';
            }
        }

        return $row;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

formatLinebreakMessage()

ilMail::formatLinebreakMessage

(

string

$message

)

Definition at line 1448 of file class.ilMail.php.

References $message.

                                                           : string
    {
        return $message;
    }

formatNamesForOutput()

ilMail::formatNamesForOutput

(

string

$recipients

)

Definition at line 162 of file class.ilMail.php.

References ilObjUser\_lookupId(), ilObjUser\_lookupPref(), getUserInstanceById(), and ILIAS\Repository\lng().

                                                            : string
    {
        $recipients = trim($recipients);
        if ($recipients === '') {
            return $this->lng->txt('not_available');
        }

        $names = [];

        $recipients = array_filter(array_map('trim', explode(',', $recipients)));
        foreach ($recipients as $recipient) {
            $usr_id = ilObjUser::_lookupId($recipient);
            if (is_int($usr_id) && $usr_id > 0) {
                $pp = ilObjUser::_lookupPref($usr_id, 'public_profile');
                if ($pp === 'g' || ($pp === 'y' && !$this->actor->isAnonymous())) {
                    $user = $this->getUserInstanceById($usr_id);
                    if ($user) {
                        $names[] = $user->getFullname() . ' [' . $recipient . ']';
                        continue;
                    }
                }
            }

            $names[] = $recipient;
        }

        return implode(', ', $names);
    }

Here is the call graph for this function:

getCountRecipient()

ilMail::getCountRecipient ( string  $recipients, bool  $only_external_addresses = true  )

private

Definition at line 1302 of file class.ilMail.php.

References parseAddresses().

Referenced by getCountRecipients().

                                                                                                : int
    {
        $addresses = new ilMailAddressListImpl($this->parseAddresses($recipients));
        if ($only_external_addresses) {
            $addresses = new ilMailOnlyExternalAddressList(
                $addresses,
                self::ILIAS_HOST,
                $this->usr_id_by_login_callable
            );
        }

        return count($addresses->value());
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getCountRecipients()

ilMail::getCountRecipients ( string  $to_recipients, string  $cc_recipients, string  $bcc_recipients, bool  $only_external_addresses = true  )

private

Definition at line 1316 of file class.ilMail.php.

References getCountRecipient().

Referenced by enqueue(), and sendMail().

     : int {
        return (
            $this->getCountRecipient($to_recipients, $only_external_addresses) +
            $this->getCountRecipient($cc_recipients, $only_external_addresses) +
            $this->getCountRecipient($bcc_recipients, $only_external_addresses)
        );
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getEmailRecipients()

ilMail::getEmailRecipients ( string  $recipients )

private

Definition at line 1329 of file class.ilMail.php.

References parseAddresses().

Referenced by sendMail().

                                                           : string
    {
        $addresses = new ilMailOnlyExternalAddressList(
            new ilMailAddressListImpl($this->parseAddresses($recipients)),
            self::ILIAS_HOST,
            $this->usr_id_by_login_callable
        );

        $email_recipients = array_map(static fn(ilMailAddress $address): string => (string) $address, $addresses->value());

        return implode(',', $email_recipients);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getMail()

ilMail::getMail

(

int

$mail_id

)

Definition at line 283 of file class.ilMail.php.

References $mail_data, $res, and fetchMailData().

                                         : ?array
    {
        $res = $this->db->queryF(
            "SELECT * FROM $this->table_mail WHERE user_id = %s AND mail_id = %s",
            ['integer', 'integer'],
            [$this->user_id, $mail_id]
        );

        $this->mail_data = $this->fetchMailData($this->db->fetchAssoc($res));

        return $this->mail_data;
    }

Here is the call graph for this function:

getMailObjectReferenceId()

ilMail::getMailObjectReferenceId

(

)

Definition at line 157 of file class.ilMail.php.

                                              : int
    {
        return $this->mail_obj_ref_id;
    }

getMailOptionsByUserId()

ilMail::getMailOptionsByUserId ( int  $usr_id )

private

Definition at line 1431 of file class.ilMail.php.

Referenced by createRecipient(), and sendChanneledMails().

                                                        : ilMailOptions
    {
        if (!isset($this->mail_options_by_usr_id_map[$usr_id])) {
            $this->mail_options_by_usr_id_map[$usr_id] = new ilMailOptions($usr_id);
        }

        return $this->mail_options_by_usr_id_map[$usr_id];
    }

Here is the caller graph for this function:

getMailsOfFolder()

ilMail::getMailsOfFolder	(	int	$a_folder_id,
		array	$filter = []
	)

Definition at line 233 of file class.ilMail.php.

References $res, and fetchMailData().

Referenced by deleteMailsOfFolder(), and ilPDMailBlockGUI\getMails().

                                                                          : array
    {
        $mails = [];

        $query =
            'SELECT sender_id, m_subject, mail_id, m_status, send_time, import_name ' .
            "FROM $this->table_mail " .
            'LEFT JOIN object_data ON obj_id = sender_id ' .
            'WHERE user_id = %s AND folder_id = %s ' .
            'AND ((sender_id > 0 AND sender_id IS NOT NULL AND obj_id IS NOT NULL) ' .
            'OR (sender_id = 0 OR sender_id IS NULL))';

        if (isset($filter['status']) && $filter['status'] !== '') {
            $query .= ' AND m_status = ' . $this->db->quote($filter['status'], 'text');
        }

        $query .= ' ORDER BY send_time DESC';

        $res = $this->db->queryF(
            $query,
            ['integer', 'integer'],
            [$this->user_id, $a_folder_id]
        );

        while ($row = $this->db->fetchAssoc($res)) {
            $mails[] = $this->fetchMailData($row);
        }

        return array_filter($mails);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getNewDraftId()

ilMail::getNewDraftId

(

int

$folder_id

)

Definition at line 438 of file class.ilMail.php.

                                                 : int
    {
        $next_id = $this->db->nextId($this->table_mail);
        $this->db->insert($this->table_mail, [
            'mail_id' => ['integer', $next_id],
            'user_id' => ['integer', $this->user_id],
            'folder_id' => ['integer', $folder_id],
            'sender_id' => ['integer', $this->user_id],
        ]);

        return $next_id;
    }

getNextMail()

ilMail::getNextMail

(

int

$mail_id

)

Definition at line 212 of file class.ilMail.php.

References $mail_data, $res, and fetchMailData().

                                             : ?array
    {
        $this->db->setLimit(1, 0);

        $query = implode(' ', [
            "SELECT b.* FROM $this->table_mail a",
            "INNER JOIN $this->table_mail b ON b.folder_id = a.folder_id",
            'AND b.user_id = a.user_id AND b.send_time < a.send_time',
            'WHERE a.user_id = %s AND a.mail_id = %s ORDER BY b.send_time DESC',
        ]);
        $res = $this->db->queryF(
            $query,
            ['integer', 'integer'],
            [$this->user_id, $mail_id]
        );

        $this->mail_data = $this->fetchMailData($this->db->fetchAssoc($res));

        return $this->mail_data;
    }

Here is the call graph for this function:

getPreviousMail()

ilMail::getPreviousMail

(

int

$mail_id

)

Definition at line 191 of file class.ilMail.php.

References $mail_data, $res, and fetchMailData().

                                                 : ?array
    {
        $this->db->setLimit(1, 0);

        $query = implode(' ', [
            "SELECT b.* FROM $this->table_mail a",
            "INNER JOIN $this->table_mail b ON b.folder_id = a.folder_id",
            'AND b.user_id = a.user_id AND b.send_time > a.send_time',
            'WHERE a.user_id = %s AND a.mail_id = %s ORDER BY b.send_time ASC',
        ]);
        $res = $this->db->queryF(
            $query,
            ['integer', 'integer'],
            [$this->user_id, $mail_id]
        );

        $this->mail_data = $this->fetchMailData($this->db->fetchAssoc($res));

        return $this->mail_data;
    }

Here is the call graph for this function:

getSalutation()

static ilMail::getSalutation ( int  $a_usr_id, ?ilLanguage  $a_language = null  )

static

Definition at line 1386 of file class.ilMail.php.

References $DIC, $lang, ilObjUser\_lookupGender(), and ilObjUser\_lookupName().

Referenced by ilTestManScoringParticipantNotification\buildBody(), ilSystemNotification\compose(), ilForumMailNotification\createMail(), ilForumMailEventNotificationSender\createMailBodyText(), ilChatroom\getSessions(), ilUserCronCheckAccounts\run(), ilRegistrationMailNotification\send(), ilMailSummaryNotification\send(), ILIAS\Portfolio\Notification\SharedNotification\send(), ilLMMailNotification\send(), ILIAS\Mail\Cron\ExpiredOrOrphanedMails\MailNotification\send(), ilDataCollectionMailNotification\send(), ilBuddySystemNotification\send(), ilSessionMembershipMailNotification\send(), ilLearningSequenceMembershipMailNotification\send(), ilIndividualAssessmentPrimitiveInternalNotificator\send(), ilCalendarMailNotification\send(), ilExerciseMailNotification\send(), ilCourseMembershipMailNotification\send(), ilGroupMembershipMailNotification\send(), ilTestMailNotification\sendAdvancedNotification(), ilExerciseMailNotification\sendExerciseNotification(), ilTestMailNotification\sendSimpleNotification(), and ilObjSurveyGUI\sendUserResultsMail().

                                                                                       : string
    {
        global $DIC;

        $lang = ($a_language instanceof ilLanguage) ? $a_language : $DIC->language();
        $lang->loadLanguageModule('mail');

        $gender = ilObjUser::_lookupGender($a_usr_id);
        $gender = $gender ?: 'n';
        $name = ilObjUser::_lookupName($a_usr_id);

        if ($name['firstname'] === '') {
            return $lang->txt('mail_salutation_anonymous') . ',';
        }

        return
            $lang->txt('mail_salutation_' . $gender) . ' ' .
            ($name['title'] ? $name['title'] . ' ' : '') .
            ($name['firstname'] ? $name['firstname'] . ' ' : '') .
            $name['lastname'] . ',';
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getSaveInSentbox()

ilMail::getSaveInSentbox

(

)

Definition at line 147 of file class.ilMail.php.

References $save_in_sentbox.

Referenced by enqueue(), and sendMail().

                                      : bool
    {
        return $this->save_in_sentbox;
    }

Here is the caller graph for this function:

getSubjectSentFolderId()

ilMail::getSubjectSentFolderId ( )

private

Definition at line 1179 of file class.ilMail.php.

References isSystemMail().

Referenced by saveInSentbox(), and sendInternalMail().

                                             : int
    {
        $send_folder_id = 0;
        if (!$this->isSystemMail()) {
            $send_folder_id = $this->mailbox->getSentFolder();
        }

        return $send_folder_id;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getUserIds()

ilMail::getUserIds ( array  $recipients )

private

Parameters

list<string>

$recipients

Returns

list<int>

Definition at line 848 of file class.ilMail.php.

References parseAddresses().

Referenced by distributeMail().

                                                  : array
    {
        $parsed_usr_ids = [];

        $joined_recipients = implode(',', array_filter(array_map('trim', $recipients)));

        $addresses = $this->parseAddresses($joined_recipients);
        foreach ($addresses as $address) {
            $address_type = $this->mail_address_type_factory->getByPrefix($address);
            $parsed_usr_ids[] = $address_type->resolve();
        }

        return array_unique(array_merge(...$parsed_usr_ids));
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getUserInstanceById()

ilMail::getUserInstanceById ( int  $usr_id )

private

Definition at line 1408 of file class.ilMail.php.

References null.

Referenced by createRecipient(), formatNamesForOutput(), and replacePlaceholders().

                                                     : ?ilObjUser
    {
        if (!array_key_exists($usr_id, $this->user_instances_by_id_map)) {
            try {
                $user = new ilObjUser($usr_id);
            } catch (Exception) {
                $user = null;
            }

            $this->user_instances_by_id_map[$usr_id] = $user;
        }

        return $this->user_instances_by_id_map[$usr_id];
    }

Here is the caller graph for this function:

isSystemMail()

ilMail::isSystemMail ( )

private

Definition at line 126 of file class.ilMail.php.

References ANONYMOUS_USER_ID.

Referenced by enqueue(), getSubjectSentFolderId(), sendChanneledMails(), sendMail(), and sendMimeMail().

                                   : bool
    {
        return $this->user_id === ANONYMOUS_USER_ID;
    }

Here is the caller graph for this function:

markRead()

ilMail::markRead

(

array

$mail_ids

)

Parameters

list<int>

$mail_ids

Definition at line 299 of file class.ilMail.php.

References $user_id.

                                             : void
    {
        $values = [];
        $types = [];

        $query = "UPDATE $this->table_mail SET m_status = %s WHERE user_id = %s ";
        $types[] = 'text';
        $types[] = 'integer';
        $values[] = 'read';
        $values[] = $this->user_id;

        if ($mail_ids !== []) {
            $query .= ' AND ' . $this->db->in('mail_id', $mail_ids, false, 'integer');
        }

        $this->db->manipulateF($query, $types, $values);
    }

markUnread()

ilMail::markUnread

(

array

$mail_ids

)

Parameters

list<int>

$mail_ids

Definition at line 320 of file class.ilMail.php.

References $user_id.

                                               : void
    {
        $values = [];
        $types = [];

        $query = "UPDATE $this->table_mail SET m_status = %s WHERE user_id = %s ";
        $types[] = 'text';
        $types[] = 'integer';
        $values[] = 'unread';
        $values[] = $this->user_id;

        if ($mail_ids !== []) {
            $query .= ' AND ' . $this->db->in('mail_id', $mail_ids, false, 'integer');
        }

        $this->db->manipulateF($query, $types, $values);
    }

moveMailsToFolder()

ilMail::moveMailsToFolder	(	array	$mail_ids,
		int	$folder_id
	)

Parameters

list<int>

$mail_ids

Definition at line 341 of file class.ilMail.php.

References $user_id.

                                                                      : bool
    {
        $values = [];
        $types = [];

        $mail_ids = array_filter(array_map(intval(...), $mail_ids));

        if ([] === $mail_ids) {
            return false;
        }

        $query =
            "UPDATE $this->table_mail " .
            'INNER JOIN mail_obj_data ' .
            'ON mail_obj_data.obj_id = %s AND mail_obj_data.user_id = %s ' .
            "SET $this->table_mail.folder_id = mail_obj_data.obj_id " .
            "WHERE $this->table_mail.user_id = %s";
        $types[] = 'integer';
        $types[] = 'integer';
        $types[] = 'integer';
        $values[] = $folder_id;
        $values[] = $this->user_id;
        $values[] = $this->user_id;

        $query .= ' AND ' . $this->db->in('mail_id', $mail_ids, false, 'integer');

        $affected_rows = $this->db->manipulateF($query, $types, $values);

        return $affected_rows > 0;
    }

parseAddresses()

ilMail::parseAddresses ( string  $addresses )

private

Explode recipient string, allowed separators are ',' ';' ' '.

Returns

list<ilMailAddress>

Definition at line 1280 of file class.ilMail.php.

References ILIAS\Repository\logger().

Referenced by checkRecipients(), existsRecipient(), getCountRecipient(), getEmailRecipients(), and getUserIds().

                                                      : array
    {
        if ($addresses !== '') {
            $this->logger->debug(sprintf(
                'Started parsing of recipient string: %s',
                $addresses
            ));
        }

        $parser = $this->mail_address_parser_factory->getParser($addresses);
        $parsed_addresses = $parser->parse();

        if ($addresses !== '') {
            $this->logger->debug(sprintf(
                'Parsed addresses: %s',
                implode(',', array_map(static fn(ilMailAddress $address): string => (string) $address, $parsed_addresses))
            ));
        }

        return $parsed_addresses;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

persistToStage()

ilMail::persistToStage	(	int	$a_user_id,
		array	$a_attachments,
		string	$a_rcp_to,
		string	$a_rcp_cc,
		string	$a_rcp_bcc,
		string	$a_m_subject,
		string	$a_m_message,
		bool	$a_use_placeholders = false,
		?string	$a_tpl_context_id = null,
		?array	$a_tpl_ctx_params = []
	)

Parameters

list<string>

$a_attachments

Definition at line 918 of file class.ilMail.php.

References retrieveFromStage().

Referenced by retrieveFromStage().

     : bool {
        $this->db->replace(
            $this->table_mail_saved,
            [
                'user_id' => ['integer', $this->user_id],
            ],
            [
                'attachments' => ['clob', serialize($a_attachments)],
                'rcp_to' => ['clob', $a_rcp_to],
                'rcp_cc' => ['clob', $a_rcp_cc],
                'rcp_bcc' => ['clob', $a_rcp_bcc],
                'm_subject' => ['text', $a_m_subject],
                'm_message' => ['clob', $a_m_message],
                'use_placeholders' => ['integer', (int) $a_use_placeholders],
                'tpl_ctx_id' => ['text', $a_tpl_context_id],
                'tpl_ctx_params' => ['blob', json_encode((array) $a_tpl_ctx_params, JSON_THROW_ON_ERROR)],
            ]
        );

        $this->retrieveFromStage();

        return true;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

readMailObjectReferenceId()

ilMail::readMailObjectReferenceId ( )

private

Definition at line 152 of file class.ilMail.php.

References ilMailGlobalServices\getMailObjectRefId().

Referenced by __construct().

                                                : void
    {
        $this->mail_obj_ref_id = ilMailGlobalServices::getMailObjectRefId();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

replacePlaceholders()

ilMail::replacePlaceholders ( string  $message, int  $usr_id = 0  )

private

Definition at line 556 of file class.ilMail.php.

References $context, Vendor\Package\$e, $message, ilMailTemplateContextService\getTemplateContextById(), getUserInstanceById(), ILIAS\Repository\logger(), and null.

Referenced by sendInternalMail(), sendMail(), and sendMailWithReplacedPlaceholder().

     : string {
        try {
            if ($this->context_id) {
                $context = ilMailTemplateContextService::getTemplateContextById($this->context_id);
            } else {
                $context = new ilMailTemplateGenericContext();
            }

            $user = $usr_id > 0 ? $this->getUserInstanceById($usr_id) : null;
            $message = $this->placeholder_resolver->resolve(
                $context,
                $message,
                $user,
                $this->context_parameters
            );
        } catch (Exception $e) {
            $this->logger->error(sprintf(
                '%s has been called with invalid context: %s / %s',
                __METHOD__,
                $e->getMessage(),
                $e->getTraceAsString()
            ));
        }

        return $message;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

replacePlaceholdersEmpty()

ilMail::replacePlaceholdersEmpty ( string  $message )

private

Definition at line 586 of file class.ilMail.php.

Referenced by sendMailWithReplacedEmptyPlaceholder().

                                                              : string
    {
        return $this->placeholder_to_empty_resolver->resolve($message);
    }

Here is the caller graph for this function:

retrieveFromStage()

ilMail::retrieveFromStage

(

)

Definition at line 953 of file class.ilMail.php.

References $mail_data, $res, fetchMailData(), and persistToStage().

Referenced by ilObjUserFolderGUI\mailObject(), and persistToStage().

                                       : array
    {
        $res = $this->db->queryF(
            "SELECT * FROM $this->table_mail_saved WHERE user_id = %s",
            ['integer'],
            [$this->user_id]
        );

        $this->mail_data = $this->fetchMailData($this->db->fetchAssoc($res));
        if (!is_array($this->mail_data)) {
            $this->persistToStage($this->user_id, [], '', '', '', '', '', false);
        }

        return $this->mail_data;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

saveAttachments()

ilMail::saveAttachments

(

array

$attachments

)

Parameters

list<string>

$attachments

Definition at line 1263 of file class.ilMail.php.

                                                       : void
    {
        $this->db->update(
            $this->table_mail_saved,
            [
                'attachments' => ['clob', serialize($attachments)],
            ],
            [
                'user_id' => ['integer', $this->user_id],
            ]
        );
    }

saveInSentbox()

ilMail::saveInSentbox ( array  $attachment, string  $to, string  $cc, string  $bcc, string  $subject, string  $message  )

private

Parameters

list<string>

$attachment

Definition at line 1192 of file class.ilMail.php.

References getSubjectSentFolderId(), and sendInternalMail().

Referenced by sendMail().

     : int {
        return $this->sendInternalMail(
            $this->getSubjectSentFolderId(),
            $this->user_id,
            $attachment,
            $to,
            $cc,
            $bcc,
            'read',
            $subject,
            $message,
            $this->user_id
        );
    }

Here is the call graph for this function:

Here is the caller graph for this function:

sendChanneledMails()

ilMail::sendChanneledMails ( MailDeliveryData  $mail_data, array  $recipients, string  $message  )

private

Parameters

list<Recipient>

$recipients

Definition at line 679 of file class.ilMail.php.

References $message, delegateExternalEmails(), MailDeliveryData\getAttachments(), MailDeliveryData\getCc(), MailDeliveryData\getInternalMailId(), getMailOptionsByUserId(), MailDeliveryData\getSubject(), MailDeliveryData\getTo(), isSystemMail(), ILIAS\Repository\logger(), and sendInternalMail().

Referenced by sendMailWithoutReplacedPlaceholder(), sendMailWithReplacedEmptyPlaceholder(), and sendMailWithReplacedPlaceholder().

     : void {
        $usr_id_to_external_email_addresses_map = [];

        foreach ($recipients as $recipient) {
            if (!$recipient->isUser()) {
                $this->logger->critical(sprintf(
                    'Skipped recipient with id %s (User not found)',
                    $recipient->getUserId()
                ));
                continue;
            }

            $can_read_internal = $recipient->evaluateInternalMailReadability();
            if ($this->isSystemMail() && !$can_read_internal->isOk()) {
                $this->logger->debug(sprintf(
                    'Skipped recipient with id %s and reason: %s',
                    $recipient->getUserId(),
                    is_string($can_read_internal->error()) ? $can_read_internal->error() : $can_read_internal->error()->getMessage()
                ));
                continue;
            }

            if ($recipient->isUserActive() && !$recipient->isUserExpired()) {
                if (!$can_read_internal->isOk() || $recipient->userWantsToReceiveExternalMails()) {
                    $email_addresses = $recipient->getExternalMailAddress();
                    $usr_id_to_external_email_addresses_map[$recipient->getUserId()] = $email_addresses;

                    if ($recipient->onlyToExternalMailAddress()) {
                        $this->logger->debug(sprintf(
                            'Recipient with id %s will only receive external emails sent to: %s',
                            $recipient->getUserId(),
                            implode(', ', $email_addresses)
                        ));
                        continue;
                    }

                    $this->logger->debug(sprintf(
                        'Recipient with id %s will additionally receive external emails ' .
                        '(because the user wants to receive it externally, or the user cannot did not accept ' .
                        'the legal documents) sent to: %s',
                        $recipient->getUserId(),
                        implode(', ', $email_addresses)
                    ));
                } else {
                    $this->logger->debug(sprintf(
                        'Recipient with id %s does not want to receive external emails',
                        $recipient->getUserId()
                    ));
                }
            } else {
                $this->logger->debug(sprintf(
                    'Recipient with id %s is inactive or expired and will not receive external emails',
                    $recipient->getUserId()
                ));
            }

            $mbox = clone $this->mailbox;
            $mbox->setUsrId($recipient->getUserId());
            $recipient_inbox_id = $mbox->getInboxFolder();

            $internal_mail_id = $this->sendInternalMail(
                $recipient_inbox_id,
                $this->user_id,
                $mail_data->getAttachments(),
                $mail_data->getTo(),
                $mail_data->getCc(),
                '',
                'unread',
                $mail_data->getSubject(),
                $message,
                $recipient->getUserId()
            );

            $this->auto_responder_service->enqueueAutoresponderIfEnabled(
                $recipient->getUserId(),
                $recipient->getMailOptions(),
                $this->getMailOptionsByUserId($this->user_id),
            );

            if ($mail_data->getAttachments() !== []) {
                $this->mail_file_data->assignAttachmentsToDirectory($internal_mail_id, $mail_data->getInternalMailId());
            }
        }

        $this->delegateExternalEmails(
            $mail_data->getSubject(),
            $mail_data->getAttachments(),
            $message,
            $usr_id_to_external_email_addresses_map
        );
    }

Here is the call graph for this function:

Here is the caller graph for this function:

sendInternalMail()

ilMail::sendInternalMail ( int  $folder_id, int  $sender_usr_id, array  $attachments, string  $to, string  $cc, string  $bcc, string  $status, string  $subject, string  $message, int  $usr_id = 0, bool  $use_placeholders = false, ?string  $template_contenxt_id = null, array  $template_context_parameters = []  )

private

Definition at line 491 of file class.ilMail.php.

References $user_id, getSubjectSentFolderId(), and replacePlaceholders().

Referenced by saveInSentbox(), and sendChanneledMails().

     : int {
        $usr_id = $usr_id ?: $this->user_id;

        if ($use_placeholders) {
            $message = $this->replacePlaceholders($message, $usr_id);
        }
        $message = str_ireplace(['<br />', '<br>', '<br/>'], "\n", $message);

        $next_id = $this->db->nextId($this->table_mail);
        $this->db->insert($this->table_mail, [
            'mail_id' => ['integer', $next_id],
            'user_id' => ['integer', $usr_id],
            'folder_id' => ['integer', $folder_id],
            'sender_id' => ['integer', $sender_usr_id],
            'attachments' => ['clob', serialize($attachments)],
            'send_time' => ['timestamp', date('Y-m-d H:i:s')],
            'rcp_to' => ['clob', $to],
            'rcp_cc' => ['clob', $cc],
            'rcp_bcc' => ['clob', $bcc],
            'm_status' => ['text', $status],
            'm_subject' => ['text', $subject],
            'm_message' => ['clob', $message],
            'tpl_ctx_id' => ['text', $template_contenxt_id],
            'tpl_ctx_params' => ['blob', json_encode($template_context_parameters, JSON_THROW_ON_ERROR)],
        ]);

        $sender_equals_reveiver = $usr_id === $this->mailbox->getUsrId();
        $is_sent_folder_of_sender = false;
        if ($sender_equals_reveiver) {
            $current_folder_id = $this->getSubjectSentFolderId();
            $is_sent_folder_of_sender = $folder_id === $current_folder_id;
        }

        $raise_event = !$sender_equals_reveiver || !$is_sent_folder_of_sender;

        if ($raise_event) {
            $this->event_handler->raise('components/ILIAS/Mail', 'sentInternalMail', [
                'id' => $next_id,
                'subject' => $subject,
                'body' => $message,
                'from_usr_id' => $sender_usr_id,
                'to_usr_id' => $usr_id,
                'rcp_to' => $to,
                'rcp_cc' => $cc,
                'rcp_bcc' => $bcc,
            ]);
        }

        return $next_id;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

sendMail()

ilMail::sendMail

(

MailDeliveryData

$mail_data

)

This method is used to finally send internal messages and external emails To use the mail system as a consumer, please use ilMail::enqueue.

Parameters

list<string>

$attachments

Returns

list<ilMailError>

See also

ilMail::enqueue()

Definition at line 1085 of file class.ilMail.php.

References deleteMails(), distributeMail(), MailDeliveryData\getAttachments(), MailDeliveryData\getBcc(), MailDeliveryData\getCc(), getCountRecipients(), getEmailRecipients(), MailDeliveryData\getMessage(), getSaveInSentbox(), MailDeliveryData\getSubject(), MailDeliveryData\getTo(), isSystemMail(), ILIAS\Repository\logger(), replacePlaceholders(), saveInSentbox(), sendMimeMail(), and MailDeliveryData\withInternalMailId().

Referenced by enqueue().

     : array {
        $internal_message_id = $this->saveInSentbox(
            $mail_data->getAttachments(),
            $mail_data->getTo(),
            $mail_data->getCc(),
            $mail_data->getBcc(),
            $mail_data->getSubject(),
            $mail_data->getMessage()
        );
        $mail_data = $mail_data->withInternalMailId($internal_message_id);

        if ($mail_data->getAttachments() !== []) {
            $this->mail_file_data->assignAttachmentsToDirectory($internal_message_id, $internal_message_id);
            $this->mail_file_data->saveFiles($internal_message_id, $mail_data->getAttachments());
        }

        $num_external_email_addresses = $this->getCountRecipients(
            $mail_data->getTo(),
            $mail_data->getCc(),
            $mail_data->getBcc()
        );

        if ($num_external_email_addresses > 0) {
            $external_mail_recipients_to = $this->getEmailRecipients($mail_data->getTo());
            $external_mail_recipients_cc = $this->getEmailRecipients($mail_data->getCc());
            $external_eail_recipients_bcc = $this->getEmailRecipients($mail_data->getBcc());

            $this->logger->debug(
                'Parsed external email addresses from given recipients /' .
                ' To: ' . $external_mail_recipients_to .
                ' | CC: ' . $external_mail_recipients_cc .
                ' | BCC: ' . $external_eail_recipients_bcc .
                ' | Subject: ' . $mail_data->getSubject()
            );

            $this->sendMimeMail(
                $external_mail_recipients_to,
                $external_mail_recipients_cc,
                $external_eail_recipients_bcc,
                $mail_data->getSubject(),
                $mail_data->isUsePlaceholder() ?
                    $this->replacePlaceholders($mail_data->getMessage(), 0) :
                    $mail_data->getMessage(),
                $mail_data->getAttachments()
            );
        } else {
            $this->logger->debug('No external email addresses given in recipient string');
        }

        $errors = [];
        if (!$this->distributeMail($mail_data)) {
            $errors['mail_send_error'] = new ilMailError('mail_send_error');
        }

        if (!$this->getSaveInSentbox()) {
            $this->deleteMails([$internal_message_id]);
        }

        if ($this->isSystemMail()) {
            $random = new Random\Randomizer();
            if ($random->getInt(0, 50) === 2) {
                (new ilMailAttachmentStageCleanup(
                    $this->logger,
                    $this->mail_file_data
                ))->run();
            }
        }

        return array_values($errors);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

sendMailWithoutReplacedPlaceholder()

ilMail::sendMailWithoutReplacedPlaceholder ( MailDeliveryData  $mail_data, array  $to_usr_ids, array  $cc_bcc_recipients  )

private

Parameters

list<int>	$to_usr_ids
list<Recipient>	$cc_bcc_recipients

Definition at line 659 of file class.ilMail.php.

References createRecipient(), MailDeliveryData\getMessage(), and sendChanneledMails().

Referenced by distributeMail().

     : void {
        $to_recipients = array_map(
            $this->createRecipient(...),
            $to_usr_ids
        );

        $this->sendChanneledMails(
            $mail_data,
            array_merge($to_recipients, $cc_bcc_recipients),
            $mail_data->getMessage()
        );
    }

Here is the call graph for this function:

Here is the caller graph for this function:

sendMailWithReplacedEmptyPlaceholder()

ilMail::sendMailWithReplacedEmptyPlaceholder ( MailDeliveryData  $mail_data, array  $recipients  )

private

Parameters

list<Recipient>

$recipients

Definition at line 644 of file class.ilMail.php.

References MailDeliveryData\getMessage(), replacePlaceholdersEmpty(), and sendChanneledMails().

Referenced by distributeMail().

     : void {
        $this->sendChanneledMails(
            $mail_data,
            $recipients,
            $this->replacePlaceholdersEmpty($mail_data->getMessage()),
        );
    }

Here is the call graph for this function:

Here is the caller graph for this function:

sendMailWithReplacedPlaceholder()

ilMail::sendMailWithReplacedPlaceholder ( MailDeliveryData  $mail_data, array  $to_usr_ids  )

private

Parameters

list<int>

$to_usr_ids

Definition at line 626 of file class.ilMail.php.

References $user_id, createRecipient(), MailDeliveryData\getMessage(), replacePlaceholders(), and sendChanneledMails().

Referenced by distributeMail().

     : void {
        foreach ($to_usr_ids as $user_id) {
            $recipient = $this->createRecipient($user_id);

            $this->sendChanneledMails(
                $mail_data,
                [$recipient],
                $this->replacePlaceholders($mail_data->getMessage(), $user_id),
            );
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

sendMimeMail()

ilMail::sendMimeMail ( string  $to, string  $cc, string  $bcc, string  $subject, string  $message, array  $attachments  )

private

Parameters

list<string>

$attachments

Definition at line 1217 of file class.ilMail.php.

References isSystemMail().

Referenced by delegateExternalEmails(), and sendMail().

     : void {
        $mailer = new ilMimeMail();
        $mailer->From($this->sender_factory->getSenderByUsrId($this->user_id));
        $mailer->To($to);
        $mailer->Subject(
            $subject,
            true,
            (string) ($this->context_parameters[self::PROP_CONTEXT_SUBJECT_PREFIX] ?? '')
        );

        if (!$this->isSystemMail()) {
            $message .= $this->signature_service->user($this->user_id);
        }
        $mailer->Body($message);

        if ($cc !== '') {
            $mailer->Cc($cc);
        }

        if ($bcc !== '') {
            $mailer->Bcc($bcc);
        }


        foreach ($attachments as $attachment) {
            $mailer->Attach(
                $this->mail_file_data->getAbsoluteAttachmentPoolPathByFilename($attachment),
                '',
                'inline',
                $attachment
            );
        }

        $mailer->Send();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

setMailOptionsByUserIdMap()

ilMail::setMailOptionsByUserIdMap

(

array

$mail_options_by_usr_id_map

)

Parameters

ilMailOptions[]

$mail_options_by_usr_id_map

Definition at line 1443 of file class.ilMail.php.

References $mail_options_by_usr_id_map.

                                                                                : void
    {
        $this->mail_options_by_usr_id_map = $mail_options_by_usr_id_map;
    }

setSaveInSentbox()

ilMail::setSaveInSentbox

(

bool

$save_in_sentbox

)

Definition at line 142 of file class.ilMail.php.

References $save_in_sentbox.

Referenced by __construct().

                                                           : void
    {
        $this->save_in_sentbox = $save_in_sentbox;
    }

Here is the caller graph for this function:

setUserInstanceById()

ilMail::setUserInstanceById

(

array

$user_instances_by_id_map

)

Parameters

array<int,ilObjUser>

$user_instances_by_id_map

Definition at line 1426 of file class.ilMail.php.

References $user_instances_by_id_map.

                                                                        : void
    {
        $this->user_instances_by_id_map = $user_instances_by_id_map;
    }

updateDraft()

ilMail::updateDraft	(	int	$a_folder_id,
		array	$a_attachments,
		string	$a_rcp_to,
		string	$a_rcp_cc,
		string	$a_rcp_bcc,
		string	$a_m_subject,
		string	$a_m_message,
		int	$a_draft_id = 0,
		bool	$a_use_placeholders = false,
		?string	$a_tpl_context_id = null,
		array	$a_tpl_context_params = []
	)

Parameters

list<string>

$a_attachments

Definition at line 454 of file class.ilMail.php.

     : int {
        $this->db->update(
            $this->table_mail,
            [
                'folder_id' => ['integer', $a_folder_id],
                'attachments' => ['clob', serialize($a_attachments)],
                'send_time' => ['timestamp', date('Y-m-d H:i:s')],
                'rcp_to' => ['clob', $a_rcp_to],
                'rcp_cc' => ['clob', $a_rcp_cc],
                'rcp_bcc' => ['clob', $a_rcp_bcc],
                'm_status' => ['text', 'read'],
                'm_subject' => ['text', $a_m_subject],
                'm_message' => ['clob', $a_m_message],
                'use_placeholders' => ['integer', (int) $a_use_placeholders],
                'tpl_ctx_id' => ['text', $a_tpl_context_id],
                'tpl_ctx_params' => ['blob', json_encode($a_tpl_context_params, JSON_THROW_ON_ERROR)],
            ],
            [
                'mail_id' => ['integer', $a_draft_id],
            ]
        );

        return $a_draft_id;
    }

validateRecipients()

ilMail::validateRecipients	(	string	$to,
		string	$cc,
		string	$bcc
	)

Returns

list<ilMailError>

Definition at line 1161 of file class.ilMail.php.

References Vendor\Package\$e, and checkRecipients().

Referenced by enqueue().

                                                                           : array
    {
        try {
            $errors = [];
            $errors = array_merge($errors, $this->checkRecipients($to));
            $errors = array_merge($errors, $this->checkRecipients($cc));
            $errors = array_merge($errors, $this->checkRecipients($bcc));

            if ($errors !== []) {
                return array_merge([new ilMailError('mail_following_rcp_not_valid')], $errors);
            }
        } catch (ilMailException $e) {
            return [new ilMailError('mail_generic_rcp_error', [$e->getMessage()])];
        }

        return [];
    }

Here is the call graph for this function:

Here is the caller graph for this function:

withContextId()

ilMail::withContextId

(

string

$context_id

)

Definition at line 108 of file class.ilMail.php.

References $context_id.

                                                     : self
    {
        $clone = clone $this;

        $clone->context_id = $context_id;

        return $clone;
    }

withContextParameters()

ilMail::withContextParameters

(

array

$parameters

)

Definition at line 117 of file class.ilMail.php.

                                                            : self
    {
        $clone = clone $this;

        $clone->context_parameters = $parameters;

        return $clone;
    }

Field Documentation

$append_installation_signature

bool ilMail::$append_installation_signature = false

private

Definition at line 39 of file class.ilMail.php.

Referenced by appendInstallationSignature().

$append_user_signature

bool ilMail::$append_user_signature = false

private

Definition at line 40 of file class.ilMail.php.

$context_id

string ilMail::$context_id = null

private

Definition at line 42 of file class.ilMail.php.

Referenced by withContextId().

$context_parameters

array ilMail::$context_parameters = []

private

Definition at line 43 of file class.ilMail.php.

$legal_documents

readonly Conductor ilMail::$legal_documents

private

Definition at line 51 of file class.ilMail.php.

$mail_data

array ilMail::$mail_data = []

protected

Definition at line 37 of file class.ilMail.php.

Referenced by ilFormatMail\appendSearchResult(), getMail(), getNextMail(), getPreviousMail(), and retrieveFromStage().

$mail_options_by_usr_id_map

array ilMail::$mail_options_by_usr_id_map = []

private

Definition at line 46 of file class.ilMail.php.

Referenced by setMailOptionsByUserIdMap().

$max_recipient_character_length

int ilMail::$max_recipient_character_length = 998

private

Definition at line 50 of file class.ilMail.php.

$save_in_sentbox

bool ilMail::$save_in_sentbox

private

Definition at line 38 of file class.ilMail.php.

Referenced by getSaveInSentbox(), and setSaveInSentbox().

$signature_service

MailSignatureService ilMail::$signature_service

private

Definition at line 32 of file class.ilMail.php.

$table_mail

string ilMail::$table_mail

private

Definition at line 34 of file class.ilMail.php.

$table_mail_saved

string ilMail::$table_mail_saved

private

Definition at line 35 of file class.ilMail.php.

$user_id

int ilMail::$user_id

Definition at line 33 of file class.ilMail.php.

Referenced by markRead(), markUnread(), moveMailsToFolder(), sendInternalMail(), and sendMailWithReplacedPlaceholder().

$user_instances_by_id_map

array ilMail::$user_instances_by_id_map = []

private

Definition at line 49 of file class.ilMail.php.

Referenced by setUserInstanceById().

ILIAS_HOST

const string ilMail::ILIAS_HOST = 'ilias'

Definition at line 29 of file class.ilMail.php.

Referenced by ilMailAddressTypeFactory\__construct(), ilUtil\is_email(), and ilRoleMailboxSearch\searchRoleIdsByAddressString().

PROP_CONTEXT_SUBJECT_PREFIX

const string ilMail::PROP_CONTEXT_SUBJECT_PREFIX = 'subject_prefix'

Definition at line 30 of file class.ilMail.php.

Referenced by ilMailMemberSearchGUI\generateContextArray(), ilCourseMembershipGUI\getMailContextOptions(), ilGroupMembershipGUI\getMailContextOptions(), ilCourseMembershipMailNotification\initMail(), and ilGroupMembershipMailNotification\initMail().

---

The documentation for this class was generated from the following file:

• components/ILIAS/Mail/classes/class.ilMail.php