Class UserMail this class handles user mails. More...

Inheritance diagram for ilFormatMail:

Collaboration diagram for ilFormatMail:

Public Member Functions
	__construct ($a_user_id)
	Constructor setup an mail object. More...

	formatReplyMessage ()
	format a reply message @access public More...

	formatReplySubject ()
	format a reply subject @access public More...

	formatReplyRecipientsForCC ()
	get reply recipients for cc @access public More...

	formatReplyRecipient ()
	get reply recipient @access public More...

	formatForwardSubject ()
	format a forward subject @access public More...

	appendSearchResult ($a_names, $a_type)
	append search result to recipient @access public More...

	formatLinebreakMessage ($a_message)
	format message according to linebreak option More...

	appendSignature ()
	append signature to mail body @access public More...

	prependSignature ()

Public Member Functions inherited from ilMail
	__construct ( $a_user_id, ilMailAddressTypeFactory $mailAddressTypeFactory=null, ilMailRfc822AddressParserFactory $mailAddressParserFactory=null, \ilAppEventHandler $eventHandler=null)

	withContextId (string $contextId)

	withContextParameters (array $parameters)

	__get ($name)
	Magic interceptor method __get Used to include files / instantiate objects at runtime. More...

	existsRecipient (string $newRecipient, string $existingRecipients)

	enableSOAP ($a_status)
	Define if external mails should be sent using SOAP client or not. More...

	isSOAPEnabled ()

	setSaveInSentbox ($a_save_in_sentbox)

	getSaveInSentbox ()

	getMailObjectReferenceId ()

	formatNamesForOutput ($a_recipients)
	Prepends the fullname of each ILIAS login name (if user has a public profile) found in the passed string and brackets the ILIAS login name afterwards. More...

	getPreviousMail ($a_mail_id)

	getNextMail ($a_mail_id)

	getMailsOfFolder ($a_folder_id, $filter=array())

	countMailsOfFolder ($a_folder_id)

	deleteMailsOfFolder ($a_folder_id)

	getMail ($a_mail_id)

	markRead (array $a_mail_ids)

	markUnread (array $a_mail_ids)

	moveMailsToFolder (array $mailIds, int $folderId)

	deleteMails (array $mailIds)

	getNewDraftId ($usrId, $folderId)

	updateDraft ( $a_folder_id, $a_attachments, $a_rcp_to, $a_rcp_cc, $a_rcp_bcc, $a_m_type, $a_m_email, $a_m_subject, $a_m_message, $a_draft_id=0, $a_use_placeholders=0, $a_tpl_context_id=null, $a_tpl_context_params=array())

	savePostData ( $a_user_id, $a_attachments, $a_rcp_to, $a_rcp_cc, $a_rcp_bcc, $a_m_type, $a_m_email, $a_m_subject, $a_m_message, $a_use_placeholders, $a_tpl_context_id=null, $a_tpl_ctx_params=array())
	save post data in table @access public More...

	getSavedData ()

	sendMail ($a_rcp_to, $a_rcp_cc, $a_rcp_bc, $a_m_subject, $a_m_message, $a_attachment, $a_type, $a_use_placeholders=0)
	Should be used to send notifcations over the internal or external mail channel. More...

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

	saveAttachments ($a_attachments)

	appendInstallationSignature ($a_flag=null)
	Setter/Getter for appending the installation signarue. More...

	formatLinebreakMessage ($a_message)

Additional Inherited Members
Static Public Member Functions inherited from ilMail
static	_getAutoGeneratedMessageString (ilLanguage $lang=null)
	Get auto generated info string. More...

static	_getInstallationSignature ()

static	getSubjectPrefix ()
	Get text that will be prepended to auto generated mails. More...

static	getSalutation ($a_usr_id, ilLanguage $a_language=null)

Data Fields inherited from ilMail
const	ILIAS_HOST = 'ilias'

const	MAIL_SUBJECT_PREFIX = '[ILIAS]'

	$user_id

Protected Member Functions inherited from ilMail
	isSystemMail ()

	readMailObjectReferenceId ()
	Read and set the mail object ref id (administration node) More...

	fetchMailData ($a_row)

	replacePlaceholders ($a_message, $a_user_id=0, $replace_empty=true)

	distributeMail ($a_rcp_to, $a_rcp_cc, $a_rcp_bcc, $a_subject, $a_message, $a_attachments, $sent_mail_id, $a_type, $a_action, $a_use_placeholders=0)

	getUserIds (array $recipients)

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

	checkRecipients (string $recipients)
	Check if recipients are valid. More...

	saveInSentbox ($a_attachment, $a_rcp_to, $a_rcp_cc, $a_rcp_bcc, $a_type, $a_m_subject, $a_m_message)
	Stores a message in the sent bod of the current user. More...

	parseAddresses ($addresses)
	Explode recipient string, allowed separators are ',' ';' ' ' Returns an array with recipient ilMailAddress instances. More...

	getCountRecipient (string $recipients, $onlyExternalAddresses=true)

	getCountRecipients (string $toRecipients, string $ccRecipients, string $bccRecipients, $onlyExternalAddresses=true)

	getEmailRecipients (string $recipients)

Static Protected Member Functions inherited from ilMail
static	getCachedUserInstance ($a_usr_id)

Protected Attributes inherited from ilMail
	$lng

	$db

	$mfile

	$mail_options

	$mailbox

	$table_mail

	$table_mail_saved

	$mail_data = array()

	$mail_obj_ref_id

	$save_in_sentbox

	$soap_enabled = true

	$appendInstallationSignature = false

	$properties = array()

	$contextId = null

	$contextParameters = []

Static Protected Attributes inherited from ilMail
static	$userInstances = array()

Detailed Description

Class UserMail this class handles user mails.

Author: Stefan Meyer meyer.nosp@m.@lei.nosp@m.fos.c.nosp@m.om

Version: $Id$

Definition at line 15 of file class.ilFormatMail.php.

Constructor & Destructor Documentation

◆ __construct()

ilFormatMail::__construct ( $a_user_id )

Constructor setup an mail object.

Parameters

int	user_id @access public

Definition at line 24 of file class.ilFormatMail.php.

    {
        parent::__construct($a_user_id);
    }

Member Function Documentation

◆ appendSearchResult()

ilFormatMail::appendSearchResult	(	$a_names,
		$a_type
	)

append search result to recipient @access public

Parameters

array	names to append
string	rcp type ('to','cc','bc')

Returns: string

Definition at line 129 of file class.ilFormatMail.php.

    {
        if (empty($this->mail_data)) {
            return false;
        }
        $name_str = implode(',', $a_names);
        switch ($a_type) {
            case 'to':
                $this->mail_data["rcp_to"] = trim($this->mail_data["rcp_to"]);
                if ($this->mail_data["rcp_to"]) {
                    $this->mail_data["rcp_to"] = $this->mail_data["rcp_to"] . ",";
                }
                $this->mail_data["rcp_to"] = $this->mail_data["rcp_to"] . $name_str;
                break;
 
            case 'cc':
                $this->mail_data["rcp_cc"] = trim($this->mail_data["rcp_cc"]);
                if ($this->mail_data["rcp_cc"]) {
                    $this->mail_data["rcp_cc"] = $this->mail_data["rcp_cc"] . ",";
                }
                $this->mail_data["rcp_cc"] = $this->mail_data["rcp_cc"] . $name_str;
                break;
 
            case 'bc':
                $this->mail_data["rcp_bcc"] = trim($this->mail_data["rcp_bcc"]);
                if ($this->mail_data["rcp_bcc"]) {
                    $this->mail_data["rcp_bcc"] = $this->mail_data["rcp_bcc"] . ",";
                }
                $this->mail_data["rcp_bcc"] = $this->mail_data["rcp_bcc"] . $name_str;
                break;
 
        }
        return $this->mail_data;
    }

References $a_type, and ilMail\$mail_data.

◆ appendSignature()

ilFormatMail::appendSignature ( )

append signature to mail body @access public

Returns: string

Definition at line 195 of file class.ilFormatMail.php.

    {
        return $this->mail_data["m_message"] .= chr(13) . chr(10) . $this->mail_options->getSignature();
    }

◆ formatForwardSubject()

ilFormatMail::formatForwardSubject ( )

format a forward subject @access public

Returns: string

Definition at line 114 of file class.ilFormatMail.php.

    {
        if (empty($this->mail_data)) {
            return false;
        }
        return $this->mail_data["m_subject"] = "[FWD: " . $this->mail_data["m_subject"] . "]";
    }

◆ formatLinebreakMessage()

ilFormatMail::formatLinebreakMessage ( $a_message )

format message according to linebreak option

Parameters

string message @access public

Returns: string formatted message

Reimplemented from ilMail.

Definition at line 169 of file class.ilFormatMail.php.

    {
        $formatted = array();
 
        $linebreak = $this->mail_options->getLinebreak();
 
        $lines = explode(chr(10), $a_message);
        for ($i = 0;$i < count($lines);$i++) {
            if (substr($lines[$i], 0, 1) != '>') {
                $formatted[] = wordwrap($lines[$i], $linebreak, chr(10));
            } else {
                $formatted[] = $lines[$i];
            }
        }
        $formatted = implode(chr(10), $formatted);
 
        return $formatted;
    }

References $i.

◆ formatReplyMessage()

ilFormatMail::formatReplyMessage ( )

format a reply message @access public

Returns: string

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

    {
        if (empty($this->mail_data)) {
            return false;
        }
 
        $bodylines = preg_split("/\r\n|\n|\r/", $this->mail_data["m_message"]);
        for ($i = 0; $i < count($bodylines); $i++) {
            $bodylines[$i] = "> " . $bodylines[$i];
        }
 
        return $this->mail_data["m_message"] = implode(chr(10), $bodylines);
    }

References $i.

◆ formatReplyRecipient()

ilFormatMail::formatReplyRecipient ( )

get reply recipient @access public

Returns: string

Definition at line 98 of file class.ilFormatMail.php.

    {
        if (empty($this->mail_data)) {
            return false;
        }
 
        require_once './Services/User/classes/class.ilObjUser.php';
 
        $user = new ilObjUser($this->mail_data["sender_id"]);
        return $this->mail_data["rcp_to"] = $user->getLogin();
    }

References $user.

◆ formatReplyRecipientsForCC()

ilFormatMail::formatReplyRecipientsForCC ( )

get reply recipients for cc @access public

Returns: string

Definition at line 66 of file class.ilFormatMail.php.

    {
        global $DIC;
 
        if (empty($this->mail_data)) {
            return '';
        }
 
        $newCC = array();
 
        $currentUserLogin = $DIC->user()->getLogin();
 
        foreach (explode(',', $this->mail_data['rcp_to']) as $to) {
            if (trim($to) != '' && $currentUserLogin != trim($to)) {
                $newCC[] = trim($to);
            }
        }
 
        foreach (explode(',', $this->mail_data['rcp_cc']) as $cc) {
            if (trim($cc) != '' && $currentUserLogin != trim($cc)) {
                $newCC[] = trim($cc);
            }
        }
 
        return ($this->mail_data['rcp_cc'] = implode(', ', $newCC));
    }

References $DIC.

◆ formatReplySubject()

ilFormatMail::formatReplySubject ( )

format a reply subject @access public

Returns: string

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

    {
        if (empty($this->mail_data)) {
            return false;
        }
        return $this->mail_data["m_subject"] = "RE: " . $this->mail_data["m_subject"];
    }

◆ prependSignature()

ilFormatMail::prependSignature ( )

Returns: string

Definition at line 203 of file class.ilFormatMail.php.

    {
        return $this->mail_options->getSignature() . chr(13) . chr(10) . chr(13) . chr(10) . $this->mail_data["m_message"];
    }

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

Services/Mail/classes/class.ilFormatMail.php

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ appendSearchResult()

◆ appendSignature()

◆ formatForwardSubject()

◆ formatLinebreakMessage()

◆ formatReplyMessage()

◆ formatReplyRecipient()

◆ formatReplyRecipientsForCC()

◆ formatReplySubject()

◆ prependSignature()