Docs For Class Email

Comments: on this page. Click to read or post your own.

Class Email

Description

Class to support sending emails.

Located in /sapphire/email/Email.php (line 26)

Object
   |
   --ViewableData
      |
      --Email

Direct descendents

Class	Description
Member_SignupEmail	Class used as template to send an email to new members
Member_ChangePasswordEmail	Class used as template to send an email saying that the password has been
Member_ForgotPasswordEmail	Class used as template to send the forgot password email
Order_ReceiptEmail	This class handles the receipt email which gets sent once an order is made.
Order_StatusEmail	This class handles the status email which is sent after changing the attributes in the report (eg. status changed to 'Shipped').

Variable Summary

static mixed $admin_email_address

static mixed $bcc_all_emails_to

static mixed $cc_all_emails_to

static mixed $mailer

static mixed $send_all_emails_to

mixed $attachments

mixed $bcc

mixed $body

mixed $bounceHandlerURL

mixed $cc

mixed $customHeaders

mixed $from

mixed $parseVariables_done

mixed $plaintext_body

mixed $ss_template

mixed $subject

mixed $template_data

mixed $to

Method Summary

static void bcc_all_emails_to ( $emailAddress)

static void cc_all_emails_to ( $emailAddress)

static void getAdminEmail ()

static void mailer ()

static string obfuscate (string $email, [string $method = 'visible'])

static void send_all_emails_to ( $emailAddress)

static void setAdminEmail (string $newEmail)

static void set_mailer (Mailer $mailer)

static void validEmailAddress ( $address)

Email __construct ([ $from = null], [ $to = null], [ $subject = null], [ $body = null], [ $bounceHandlerURL = null], [ $cc = null], [ $bcc = null])

void addCustomHeader ( $headerName, $headerValue)

void attachFile ( $filename, [ $attachedFilename = null], [ $mimetype = null])

void attachFileFromString ( $data, $filename, [ $mimetype = null])

void BaseURL ()

void Bcc ()

void Body ()

void Cc ()

void debug ()

void From ()

void IsEmail ()

boolean is_valid_address ( $email, string $str)

void parseVariables ([ $isPlain = false])

void populateTemplate ( $data)

void send ([ $messageID = null])

void sendPlain ([ $messageID = null])

void setBcc ( $val)

void setBody ( $val)

void setBounceHandlerURL ( $bounceHandlerURL)

void setCc ( $val)

void setFormat ( $format)

void setFrom ( $val)

void setSubject ( $val)

void setTo ( $val)

void Subject ()

void templateData ()

void To ()

Variables

static mixed $admin_email_address = '' (line 62)

The default administrator email address. This will be set in the config on a site-by-site basis

static mixed $bcc_all_emails_to = null (line 64)

access: protected

static mixed $cc_all_emails_to = null (line 65)

access: protected

static mixed $mailer (line 29)

access: protected

static mixed $send_all_emails_to = null (line 63)

access: protected

mixed $attachments = array() (line 52)

access: protected

mixed $bcc (line 27)

access: protected

mixed $body (line 27)

access: protected

Redefined in descendants as:

Member_SignupEmail::$body

mixed $bounceHandlerURL = null (line 57)

access: protected

mixed $cc (line 27)

access: protected

mixed $customHeaders (line 50)

A map of header-name -> header-value

access: protected

mixed $from (line 27)

access: protected

Redefined in descendants as:

mixed $parseVariables_done = false (line 53)

access: protected

mixed $plaintext_body (line 27)

access: protected

mixed $ss_template = "GenericEmail" (line 55)

access: protected

Redefined in descendants as:

mixed $subject (line 27)

access: protected

Redefined in descendants as:

mixed $template_data = null (line 56)

access: protected

mixed $to (line 27)

access: protected

Redefined in descendants as:

Inherited Variables

Inherited from ViewableData

ViewableData::$casting
ViewableData::$castingHelperPair_cache
ViewableData::$customisedObj
ViewableData::$failover
ViewableData::$iteratorPos
ViewableData::$iteratorTotalItems
ViewableData::$namedAs
ViewableData::$parent
ViewableData::$_natural_cache
ViewableData::$_object_cache
ViewableData::$_xml_cache

Inherited from Object

Object::$builtInMethods
Object::$class
Object::$classConstructed
Object::$extensions
Object::$extension_instances
Object::$extraMethods
Object::$extraStatics
Object::$statics
Object::$static_cached

Methods

static method bcc_all_emails_to (line 405)

BCC every email generated by the Email class to the given address.

It won't affect the original delivery in the same way that send_all_emails_to does. It just adds a BCC header with the given email address. Note that you can only call this once - subsequent calls will overwrite the configuration variable.

This can be used when you have a system that relies heavily on email and you want someone to be checking all correspondence.

if(Director::isLive()) Email::cc_all_emails_to("supportperson@example.com")

access: public

static void bcc_all_emails_to ( $emailAddress)

$emailAddress

static method cc_all_emails_to (line 391)

CC every email generated by the Email class to the given address.

It won't affect the original delivery in the same way that send_all_emails_to does. It just adds a CC header with the given email address. Note that you can only call this once - subsequent calls will overwrite the configuration variable.

This can be used when you have a system that relies heavily on email and you want someone to be checking all correspondence.

if(Director::isLive()) Email::cc_all_emails_to("supportperson@example.com")

access: public

static void cc_all_emails_to ( $emailAddress)

$emailAddress

static method getAdminEmail (line 366)

access: public

static void getAdminEmail ()

static method mailer (line 42)

Get the mailer.

static void mailer ()

static method obfuscate (line 452)

Encode an email-address to protect it from spambots.

At the moment only simple string substitutions, which are not 100% safe from email harvesting.

todo: Integrate javascript-based solution
access: public

static string obfuscate (string $email, [string $method = 'visible'])

string $email: Email-address
string $method
: Method for obfuscating/encoding the address
- 'visible': Simple string substitution ('@' to '[at]', '.' to '[dot], '-' to [dash])
- 'hex': Hexadecimal URL-Encoding - useful for mailto: links

static method send_all_emails_to (line 377)

Send every email generated by the Email class to the given address.

It will also add " [addressed to (email), cc to (email), bcc to (email)]" to the end of the subject line This can be used when testing, by putting a command like this in your _config.php file

if(!Director::isLive()) Email::send_all_emails_to("someone@example.com")

access: public

static void send_all_emails_to ( $emailAddress)

$emailAddress

static method setAdminEmail (line 362)

Used as a default sender address in the Email class unless overwritten. Also shown to users on live environments as a contact address on system error pages.

access: public

static void setAdminEmail (string $newEmail)

string $newEmail

static method set_mailer (line 35)

Set the mailer.

This can be used to provide a mailer other than the default, for testing, for example.

static void set_mailer (Mailer $mailer)

Mailer $mailer

static method validEmailAddress (line 242)

Validates the email address. Returns true of false

static void validEmailAddress ( $address)

$address

Constructor __construct (line 70)

Create a new email.

access: public

Email __construct ([ $from = null], [ $to = null], [ $subject = null], [ $body = null], [ $bounceHandlerURL = null], [ $cc = null], [ $bcc = null])

$from
$to
$subject
$body
$bounceHandlerURL
$cc
$bcc

Redefinition of:

Object::__construct()

Redefined in descendants as:

addCustomHeader (line 137)

Add a custom header to this value.

Useful for implementing all those cool features that we didn't think of.

access: public

void addCustomHeader ( $headerName, $headerValue)

$headerName
$headerValue

attachFile (line 95)

access: public

void attachFile ( $filename, [ $attachedFilename = null], [ $mimetype = null])

$filename
$attachedFilename
$mimetype

attachFileFromString (line 80)

access: public

void attachFileFromString ( $data, $filename, [ $mimetype = null])

$data
$filename
$mimetype

BaseURL (line 146)

access: public

void BaseURL ()

Bcc (line 123)

access: public

void Bcc ()

Body (line 111)

access: public

void Body ()

Cc (line 120)

access: public

void Cc ()

debug (line 153)

Debugging help

access: public

void debug ()

From (line 117)

access: public

void From ()

IsEmail (line 185)

Used by SSViewer templates to detect if we're rendering an email template rather than a page template

access: public

void IsEmail ()

is_valid_address (line 421)

Checks for RFC822-valid email format.

copyright: Cal Henderson <cal@iamcal.com> This code is licensed under a Creative Commons Attribution-ShareAlike 2.5 License http://creativecommons.org/licenses/by-sa/2.5/
see: http://code.iamcal.com/php/rfc822/rfc822.phps

boolean is_valid_address ( $email, string $str)

string $str
$email

parseVariables (line 209)

Load all the template variables into the internal variables, including

the template into body. Called before send() or debugSend() $isPlain=true will cause the template to be ignored, otherwise the GenericEmail template will be used and it won't be plain email :)

access: protected

void parseVariables ([ $isPlain = false])

$isPlain

populateTemplate (line 193)

Populate this email template with values.

This may be called many times.

void populateTemplate ( $data)

$data

send (line 294)

Send the email.

access: public

void send ([ $messageID = null])

$messageID

sendPlain (line 249)

Send the email in plaintext

void sendPlain ([ $messageID = null])

$messageID

setBcc (line 132)

access: public

void setBcc ( $val)

$val

setBody (line 128)

access: public

void setBody ( $val)

$val

setBounceHandlerURL (line 88)

access: public

void setBounceHandlerURL ( $bounceHandlerURL)

$bounceHandlerURL

setCc (line 131)

access: public

void setCc ( $val)

$val

setFormat (line 104)

access: public

void setFormat ( $format)

$format

setFrom (line 130)

access: public

void setFrom ( $val)

$val

setSubject (line 127)

access: public

void setSubject ( $val)

$val

setTo (line 129)

access: public

void setTo ( $val)

$val

Subject (line 108)

access: public

void Subject ()

templateData (line 165)

access: protected

void templateData ()

To (line 114)

access: public

void To ()

Inherited Methods

Inherited From ViewableData

ViewableData::ATT_val()
ViewableData::BaseHref()
ViewableData::buildCastingHelperCache()
ViewableData::cachedCall()
ViewableData::castingHelper()
ViewableData::castingHelperPair()
ViewableData::castingObjectCreator()
ViewableData::castingObjectCreatorPair()
ViewableData::CSSClasses()
ViewableData::CurrentMember()
ViewableData::CurrentPage()
ViewableData::customise()
ViewableData::Debug()
ViewableData::defineMethods()
ViewableData::escapeTypeForField()
ViewableData::Even()
ViewableData::EvenOdd()
ViewableData::First()
ViewableData::FirstLast()
ViewableData::getField()
ViewableData::getIterator()
ViewableData::getXMLValues()
ViewableData::hasField()
ViewableData::HasPerm()
ViewableData::hasValue()
ViewableData::i18nLocale()
ViewableData::IsAjax()
ViewableData::iteratorProperties()
ViewableData::JS_val()
ViewableData::Last()
ViewableData::Me()
ViewableData::Middle()
ViewableData::MiddleString()
ViewableData::obj()
ViewableData::Odd()
ViewableData::Pos()
ViewableData::RAW_val()
ViewableData::renderWith()
ViewableData::SecurityID()
ViewableData::setCustomisedObj()
ViewableData::setField()
ViewableData::SQL_val()
ViewableData::ThemeDir()
ViewableData::Top()
ViewableData::TotalItems()
ViewableData::val()
ViewableData::XML_val()
ViewableData::__get()
ViewableData::__isset()
ViewableData::__set()

Inherited From Object

Object::__construct()
Object::addMethodsFrom()
Object::addStaticVars()
Object::addWrapperMethod()
Object::add_extension()
Object::allMethodNames()
Object::buildMethodList()
Object::cacheToFile()
Object::cacheToFileWithArgs()
Object::create()
Object::createMethod()
Object::defineMethods()
Object::exists()
Object::extend()
Object::extInstance()
Object::getCustomClass()
Object::hasExtension()
Object::hasMethod()
Object::invokeWithExtensions()
Object::is_a()
Object::loadCache()
Object::parentClass()
Object::sanitiseCachename()
Object::saveCache()
Object::set_stat()
Object::set_uninherited()
Object::stat()
Object::strong_create()
Object::uninherited()
Object::useCustomClass()
Object::__call()
Object::__toString()

blog comments powered by Disqus

Documentation generated on Sun, 19 Oct 2008 06:40:34 +1300 by phpDocumentor 1.3.2