Joomla! API

Download
Launch

Mail

Extends PHPMailer

Email Class. Provides a common interface to send email from the Joomla! Platform

since

1.7.0
package

Joomla CMS

Methods

__construct

Constructor

__construct(bool exceptions = true) : mixed
since

1.7.0

Arguments

exceptions

boolFlag if Exceptions should be thrown

Response

mixed

add

Add recipients to the email.

add(mixed recipient, mixed name = '', string method = 'addAddress') : \Joomla\CMS\Mail\Mail|bool
since

1.7.0
throws

\InvalidArgumentException

Arguments

recipient

mixedEither a string or array of strings [email address(es)]

name

mixedEither a string or array of strings [name(s)]

method

stringThe parent method's name.

Response

\Joomla\CMS\Mail\Mail|boolReturns this object for chaining on success or boolean false on failure.

addAttachment

Add file attachment to the email

addAttachment(mixed path, mixed name = '', mixed encoding = 'base64', mixed type = 'application/octet-stream', string disposition = 'attachment') : \Joomla\CMS\Mail\Mail|bool
since

3.0.1
throws

\InvalidArgumentException

Arguments

path

mixedEither a string or array of strings [filenames]

name

mixedEither a string or array of strings [names]. N.B. if this is an array it must contain the same number of elements as the array of paths supplied.

encoding

mixedThe encoding of the attachment

type

mixedThe mime type

disposition

stringThe disposition of the attachment

Response

\Joomla\CMS\Mail\Mail|boolReturns this object for chaining on success or boolean false on failure.

addBcc

Add blind carbon copy recipients to the email

addBcc(mixed bcc, mixed name = '') : \Joomla\CMS\Mail\Mail|bool
since

1.7.0

Arguments

bcc

mixedEither a string or array of strings [email address(es)]

name

mixedEither a string or array of strings [name(s)]

Response

\Joomla\CMS\Mail\Mail|boolReturns this object for chaining on success or boolean false on failure.

addCc

Add carbon copy recipients to the email

addCc(mixed cc, mixed name = '') : \Joomla\CMS\Mail\Mail|bool
since

1.7.0

Arguments

cc

mixedEither a string or array of strings [email address(es)]

name

mixedEither a string or array of strings [name(s)]

Response

\Joomla\CMS\Mail\Mail|boolReturns this object for chaining on success or boolean false on failure.

addRecipient

Add recipients to the email

addRecipient(mixed recipient, mixed name = '') : \Joomla\CMS\Mail\Mail|bool
since

1.7.0

Arguments

recipient

mixedEither a string or array of strings [email address(es)]

name

mixedEither a string or array of strings [name(s)]

Response

\Joomla\CMS\Mail\Mail|boolReturns this object for chaining.

addReplyTo

Add Reply to email address(es) to the email

addReplyTo(mixed replyto, mixed name = '') : \Joomla\CMS\Mail\Mail|bool
since

1.7.0

Arguments

replyto

mixedEither a string or array of strings [email address(es)]

name

mixedEither a string or array of strings [name(s)]

Response

\Joomla\CMS\Mail\Mail|boolReturns this object for chaining on success or boolean false on failure.

clearAttachments

Unset all file attachments from the email

clearAttachments() : \Joomla\CMS\Mail\Mail
since

3.0.1

Response

\Joomla\CMS\Mail\MailReturns this object for chaining.

getInstance

Returns the global email object, only creating it if it doesn't already exist.

getInstance(string id = 'Joomla', bool exceptions = true) : \Joomla\CMS\Mail\Mail
static

NOTE: If you need an instance to use that does not have the global configuration values, use an id string that is not 'Joomla'.

since

1.7.0

Arguments

id

stringThe id string for the Mail instance [optional]

exceptions

boolFlag if Exceptions should be thrown [optional]

Response

\Joomla\CMS\Mail\MailThe global Mail object

isHtml

Sets message type to HTML

isHtml(bool ishtml = true) : \Joomla\CMS\Mail\Mail
since

3.1.4

Arguments

ishtml

boolBoolean true or false.

Response

\Joomla\CMS\Mail\MailReturns this object for chaining.

isSendmail

Send messages using $Sendmail.

isSendmail() : void

This overrides the parent class to remove the restriction on the executable's name containing the word "sendmail"

since

1.7.0

removeAttachment

Unset file attachments specified by array index.

removeAttachment(int index) : \Joomla\CMS\Mail\Mail
since

3.0.1

Arguments

index

intThe numerical index of the attachment to remove

Response

\Joomla\CMS\Mail\MailReturns this object for chaining.

Send

Send the mail

Send() : bool|\JException
since

1.7.0
throws

\RuntimeException

Response

bool|\JExceptionBoolean true if successful, boolean false if the mailonline configuration is set to 0, or a JException object if the mail function does not exist or sending the message fails.

sendAdminMail

Sends mail to administrator for approval of a user submission

sendAdminMail(string adminName, string adminEmail, string email, string type, string title, string author, string url = null) : bool
deprecated
since

1.7.0
deprecated

4.0 Without replacement please implement it in your own code

Arguments

adminName

stringName of administrator

adminEmail

stringEmail address of administrator

email

string[NOT USED TODO: Deprecate?]

type

stringType of item to approve

title

stringTitle of item to approve

author

stringAuthor of item to approve

url

stringA URL to included in the mail

Response

boolTrue on success

sendMail

Function to send an email

sendMail(string from, string fromName, mixed recipient, string subject, string body, bool mode = false, mixed cc = null, mixed bcc = null, mixed attachment = null, mixed replyTo = null, mixed replyToName = null) : bool
since

1.7.0

Arguments

from

stringFrom email address

fromName

stringFrom name

recipient

mixedRecipient email address(es)

subject

stringemail subject

body

stringMessage body

mode

boolfalse = plain text, true = HTML

cc

mixedCC email address(es)

bcc

mixedBCC email address(es)

attachment

mixedAttachment file name(s)

replyTo

mixedReply to email address(es)

replyToName

mixedReply to name(s)

Response

boolTrue on success

setBody

Set the email body

setBody(string content) : \Joomla\CMS\Mail\Mail
since

1.7.0

Arguments

content

stringBody of the email

Response

\Joomla\CMS\Mail\MailReturns this object for chaining.

setFrom

Set the From and FromName properties.

setFrom(string address, string name = '', bool auto = true) : bool
since

1.7.0

Arguments

address

stringThe sender email address

name

stringThe sender name

auto

boolWhether to also set the Sender address, defaults to true

Response

bool

setSender

Set the email sender

setSender(mixed from) : \Joomla\CMS\Mail\Mail|bool
since

1.7.0
throws

\UnexpectedValueException

Arguments

from

mixedemail address and Name of sender array([0] => email Address, [1] => Name) or as a string

Response

\Joomla\CMS\Mail\Mail|boolReturns this object for chaining on success or boolean false on failure.

setSubject

Set the email subject

setSubject(string subject) : \Joomla\CMS\Mail\Mail
since

1.7.0

Arguments

subject

stringSubject of the email

Response

\Joomla\CMS\Mail\MailReturns this object for chaining.

useSendmail

Use sendmail for sending the email

useSendmail(string sendmail = null) : bool
since

1.7.0

Arguments

sendmail

stringPath to sendmail [optional]

Response

boolTrue on success

useSmtp

Use SMTP for sending the email

useSmtp(string auth = null, string host = null, string user = null, string pass = null, string secure = null, int port = 25) : bool
since

1.7.0

Arguments

auth

stringSMTP Authentication [optional]

host

stringSMTP Host [optional]

user

stringSMTP Username [optional]

pass

stringSMTP Password [optional]

secure

stringUse secure methods

port

intThe SMTP port

Response

boolTrue on success

Properties

instances

Mail instances container.

static
since

1.7.3

Type(s)

\Joomla\CMS\Mail\Mail[]

CharSet

Charset of the message.

since

1.7.0

Type(s)

string
  • \ Joomla
  • \ CMS
  • \ Mail
  • \ Mail