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 public More...

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

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

	formatReplyRecipient ()
	get reply recipient public More...

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

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

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

	appendSignature ()
	append signature to mail body 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 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 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 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 public

Parameters

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

Returns: string

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

References $a_type, and ilMail\$mail_data.

         {
                 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;
         }

◆ appendSignature()

ilFormatMail::appendSignature ( )

append signature to mail body 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 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 public

Returns: string formatted message

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

References array.

         {
                 $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 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 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 public

Returns: string

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

References $ilUser, and array.

         {
                 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));
         }

◆ formatReplySubject()

ilFormatMail::formatReplySubject ( )

format a reply subject 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

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ appendSearchResult()

◆ appendSignature()

◆ formatForwardSubject()

◆ formatLinebreakMessage()

◆ formatReplyMessage()

◆ formatReplyRecipient()

◆ formatReplyRecipientsForCC()

◆ formatReplySubject()

◆ prependSignature()