ilFormatMail Class Reference

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
	existsRecipient ($a_recipient, $a_existing_recipients)
	enableSOAP ($a_status)
	Define if external mails should be sent using SOAP client or not. More...
	setSaveInSentbox ($a_save_in_sentbox)
	getSaveInSentbox ()
	getMailObjectReferenceId ()
	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 $a_mail_ids, $a_folder_id)
	deleteMails (array $a_mail_ids)
	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())
	sendInternalMail ( $a_folder_id, $a_sender_id, $a_attachments, $a_rcp_to, $a_rcp_cc, $a_rcp_bcc, $a_status, $a_m_type, $a_m_email, $a_m_subject, $a_m_message, $a_user_id=0, $a_use_placeholders=0, $a_tpl_context_id=null, $a_tpl_context_params=array())
	save mail in folder @access private More...
	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 ()
	validateRecipients ($a_rcp_to, $a_rcp_cc, $a_rcp_bc)
	sendMimeMail ($a_rcp_to, $a_rcp_cc, $a_rcp_bcc, $a_m_subject, $a_m_message, $a_attachments, $a_no_soap=false)
	Send mime mail using class.ilMimeMail.php. More...
	saveAttachments ($a_attachments)
	appendInstallationSignature ($a_flag=null)
	Setter/Getter for appending the installation signarue. More...

Additional Inherited Members
Data Fields inherited from ilMail
const	ILIAS_HOST = 'ilias'
	$user_id
Protected Member Functions inherited from ilMail
	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 ($a_recipients)
	checkMail ($a_rcp_to, $a_rcp_cc, $a_rcp_bcc, $a_m_subject, $a_m_message, $a_type)
	checkRecipients ($a_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 ($a_recipients, $a_only_email=true)
	getCountRecipients ($a_to, $a_cc, $a_bcc, $a_only_email=true)
	getEmailRecipients ($a_recipients)
Static Protected Member Functions inherited from ilMail
static	getCachedUserInstance ($a_usr_id)
Protected Attributes inherited from ilMail
	$lng
	$db
	$mfile
	$mail_options
	$table_mail
	$table_mail_saved
	$mail_data = array()
	$mail_obj_ref_id
	$save_in_sentbox
	$soap_enabled = true
	$mail_to_global_roles = 0
	$appendInstallationSignature = false
	$properties = array()
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 137 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 213 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 121 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

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

        {
                $formatted = array();
 
#               debug($a_message);
                $linebreak = $this->mail_options->getLinebreak();
                // SPLIT INTO LINES returns always an array
                $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);
#               debug($formatted);
                return $formatted;
        }

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;
                }
#               debug($this->mail_data["m_message"]);
                $bodylines = explode(chr(13).chr(10), $this->mail_data["m_message"]);
#               var_dump("<pre>",$bodylines,"</pre");
                for ($i = 0; $i < count($bodylines); $i++)
                {
                        $bodylines[$i] = "> ".$bodylines[$i];
                }
                return $this->mail_data["m_message"] = implode(chr(13).chr(10), $bodylines);
        }

formatReplyRecipient()

ilFormatMail::formatReplyRecipient

(

)

get reply recipient @access public

Returns

string

Definition at line 104 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();
        }

formatReplyRecipientsForCC()

ilFormatMail::formatReplyRecipientsForCC

(

)

get reply recipients for cc @access public

Returns

string

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

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

References $ilUser.

formatReplySubject()

ilFormatMail::formatReplySubject

(

)

format a reply subject @access public

Returns

string

Definition at line 55 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 221 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