header-value */ protected $customHeaders; /** * @param array $attachements Internal, use {@link attachFileFromString()} or {@link attachFile()} */ protected $attachments = array(); /** * @param boolean $ */ protected $parseVariables_done = false; /** * @param string $ss_template The name of the used template (without *.ss extension) */ protected $ss_template = "GenericEmail"; /** * @param array $template_data Additional data available in a template. * Used in the same way than {@link ViewableData->customize()}. */ protected $template_data = null; /** * @param string $bounceHandlerURL */ protected $bounceHandlerURL = null; /** * @param sring $admin_email_address The default administrator email address. * This will be set in the config on a site-by-site basis */ static $admin_email_address = ''; /** * @param string $send_all_emails_to Email-Address */ protected static $send_all_emails_to = null; /** * @param string $bcc_all_emails_to Email-Address */ protected static $bcc_all_emails_to = null; /** * @param string $cc_all_emails_to Email-Address */ protected static $cc_all_emails_to = null; /** * Create a new email. */ public function __construct($from = null, $to = null, $subject = null, $body = null, $bounceHandlerURL = null, $cc = null, $bcc = null) { $this->from = $from; $this->to = $to; $this->subject = $subject; $this->body = $body; $this->cc = $cc; $this->bcc = $bcc; $this->setBounceHandlerURL($bounceHandlerURL); } public function attachFileFromString($data, $filename, $mimetype = null) { $this->attachments[] = array( 'contents' => $data, 'filename' => $filename, 'mimetype' => $mimetype, ); } public function setBounceHandlerURL( $bounceHandlerURL ) { if( $bounceHandlerURL ) $this->bounceHandlerURL = $bounceHandlerURL; else $this->bounceHandlerURL = $_SERVER['HTTP_HOST'] . Director::baseURL() . 'Email_BounceHandler'; } public function attachFile($filename, $attachedFilename = null, $mimetype = null) { $absoluteFileName = Director::getAbsFile($filename); if(file_exists($absoluteFileName)) { $this->attachFileFromString(file_get_contents($absoluteFileName), $attachedFilename, $mimetype); } else { user_error("Could not attach '$absoluteFileName' to email. File does not exist.", E_USER_NOTICE); } } /** * @deprecated 2.3 Not used anywhere else */ public function setFormat($format) { user_error('Email->setFormat() is deprecated', E_USER_NOTICE); } public function Subject() { return $this->subject; } public function Body() { return $this->body; } public function To() { return $this->to; } public function From() { return $this->from; } public function Cc() { return $this->cc; } public function Bcc() { return $this->bcc; } public function setSubject($val) { $this->subject = $val; } public function setBody($val) { $this->body = $val; } public function setTo($val) { $this->to = $val; } public function setFrom($val) { $this->from = $val; } public function setCc($val) { $this->cc = $val; } public function setBcc($val) { $this->bcc = $val; } /** * Add a custom header to this value. * Useful for implementing all those cool features that we didn't think of. */ public function addCustomHeader($headerName, $headerValue) { if($headerName == 'Cc') $this->cc = $headerValue; else if($headerName == 'Bcc') $this->bcc = $headerValue; else { if($this->customHeaders[$headerName]) $this->customHeaders[$headerName] .= ", "; $this->customHeaders[$headerName] .= $headerValue; } } public function BaseURL() { return Director::absoluteBaseURL(); } /** * Debugging help */ public function debug() { $this->parseVariables(); return "
From: $this->from\n" . "To: $this->to\n" . "Cc: $this->cc\n" . "Bcc: $this->bcc\n" . "Subject: $this->subject
" . $this->body; } /** * Set template name (without *.ss extension). * * @param string $template */ public function setTemplate($template) { $this->ss_template = $template; } /** * @return string */ public function getTemplate() { return $this->ss_template; } protected function templateData() { if($this->template_data) { return $this->template_data->customise(array( "To" => $this->to, "Cc" => $this->cc, "Bcc" => $this->bcc, "From" => $this->from, "Subject" => $this->subject, "Body" => $this->body, "BaseURL" => $this->BaseURL(), "IsEmail" => true, )); } else { return $this; } } /** * Used by {@link SSViewer} templates to detect if we're rendering an email template rather than a page template */ public function IsEmail() { return true; } /** * Populate this email template with values. * This may be called many times. */ function populateTemplate($data) { if($this->template_data) { $this->template_data = $this->template_data->customise($data); } else { if(is_array($data)) $data = new ArrayData($data); $this->template_data = $this->customise($data); } $this->parseVariables_done = false; } /** * 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 :) */ protected function parseVariables($isPlain = false) { if(!$this->parseVariables_done) { $this->parseVariables_done = true; // Parse $ variables in the base parameters $data = $this->templateData(); foreach(array('from','to','subject','body', 'plaintext_body', 'cc', 'bcc') as $param) { $template = SSViewer::fromString($this->$param); $this->$param = $template->process($data); } // Process a .SS template file $fullBody = $this->body; if($this->ss_template && !$isPlain) { // Requery data so that updated versions of To, From, Subject, etc are included $data = $this->templateData(); $template = new SSViewer($this->ss_template); if($template->exists()) { $fullBody = $template->process($data); } } // Rewrite relative URLs $this->body = HTTP::absoluteURLs($fullBody); } } /** * @desc Validates the email address. Returns true of false */ static function validEmailAddress($address) { return ereg('^([a-zA-Z0-9_+\.\-]+)@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.)|(([a-zA-Z0-9\-]+\.)+))([a-zA-Z]{2,4}|[0-9]{1,3})(\]?)$', $address); } /** * @desc Send the email in plaintext */ function sendPlain($messageID = null) { global $project; Requirements::clear(); $this->parseVariables(true); if(empty($this->from)) $this->from = Email::getAdminEmail(); $this->setBounceHandlerURL($this->bounceHandlerURL); $headers['X-SilverStripeBounceURL'] = $this->bounceHandlerURL; if($messageID) $headers['X-SilverStripeMessageID'] = $project . '.' . $messageID; if($project) $headers['X-SilverStripeSite'] = $project; $to = $this->to; $subject = $this->subject; if(self::$send_all_emails_to) { $subject .= " [addressed to $to"; $to = self::$send_all_emails_to; if($this->cc) $subject .= ", cc to $this->cc"; if($this->bcc) $subject .= ", bcc to $this->bcc"; $subject .= ']'; } else { if($this->cc) $headers["Cc"] = $this->cc; if($this->bcc) $headers["Bcc"] = $this->bcc; } if(self::$cc_all_emails_to) { if(trim($headers['Cc'])) $headers['Cc'] .= ', '; $headers['Cc'] .= self::$cc_all_emails_to; } if(self::$bcc_all_emails_to) { if(trim($headers['Bcc'])) $headers['Bcc'] .= ', '; $headers['Bcc'] .= self::$bcc_all_emails_to; } Requirements::restore(); return self::mailer()->sendPlain($to, $this->from, $subject, $this->body, $this->attachments, $headers); } /** * Send the email. */ public function send( $messageID = null ) { Requirements::clear(); $this->parseVariables(); if( empty( $this->from ) ){ $this->from = Email::getAdminEmail(); } $this->setBounceHandlerURL( $this->bounceHandlerURL ); $headers = $this->customHeaders; $headers['X-SilverStripeBounceURL'] = $this->bounceHandlerURL; if( $messageID ) $headers['X-SilverStripeMessageID'] = project() . '.' . $messageID; if( project() ) $headers['X-SilverStripeSite'] = project(); $to = $this->to; $subject = $this->subject; if(self::$send_all_emails_to) { $subject .= " [addressed to $to"; $to = self::$send_all_emails_to; if($this->cc) $subject .= ", cc to $this->cc"; if($this->bcc) $subject .= ", bcc to $this->bcc"; $subject .= ']'; unset($headers['Cc']); unset($headers['Bcc']); } else { if($this->cc) $headers["Cc"] = $this->cc; if($this->bcc) $headers["Bcc"] = $this->bcc; } if(self::$cc_all_emails_to) { if(!empty($headers['Cc']) && trim($headers['Cc'])) { $headers['Cc'] .= ', ' . self::$cc_all_emails_to; } else { $headers['Cc'] = self::$cc_all_emails_to; } } if(self::$bcc_all_emails_to) { if(!empty($headers['Bcc']) && trim($headers['Bcc'])) { $headers['Bcc'] .= ', ' . self::$bcc_all_emails_to; } else { $headers['Bcc'] = self::$bcc_all_emails_to; } } Requirements::restore(); return self::mailer()->sendHTML($to, $this->from, $subject, $this->body, $this->attachments, $headers, $this->plaintext_body); } /** * Used as a default sender address in the {@link Email} class * unless overwritten. Also shown to users on live environments * as a contact address on system error pages. * * @usedby Email->send() * @usedby Email->sendPlain() * @usedby Debug->friendlyError() * * @param string $newEmail */ public static function setAdminEmail( $newEmail ) { self::$admin_email_address = $newEmail; } public static function getAdminEmail() { return self::$admin_email_address; } /** * 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") */ public static function send_all_emails_to($emailAddress) { self::$send_all_emails_to = $emailAddress; } /** * 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") */ public static function cc_all_emails_to($emailAddress) { self::$cc_all_emails_to = $emailAddress; } /** * 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") */ public static function bcc_all_emails_to($emailAddress) { self::$bcc_all_emails_to = $emailAddress; } /** * Checks for RFC822-valid email format. * * @param string $str * @return boolean * * @see http://code.iamcal.com/php/rfc822/rfc822.phps * @copyright Cal HendersonMember: '.$member->FirstName.' '.$member->Surname.' <'.$member->Email.'> was added to the Email Blacklist!
'; } } if( !$date ) $date = date( 'd-m-Y' ); /*else $date = date( 'd-m-Y', strtotime( $date ) );*/ if( !$time ) $time = date( 'H:i:s' ); /*else $time = date( 'H:i:s', strtotime( $time ) );*/ $record->BounceEmail = $email; $record->BounceTime = $date . ' ' . $time; $record->BounceMessage = $error; $record->write(); echo "Handled bounced email to address: $email"; } else { echo 'Sorry, this bounce report has already been logged, not logging this duplicate bounce.'; } } } /** * Database record for recording a bounced email * @package sapphire * @subpackage email */ class Email_BounceRecord extends DataObject { static $db = array( 'BounceEmail' => 'Varchar', 'BounceTime' => 'SSDatetime', 'BounceMessage' => 'Varchar' ); static $has_one = array( 'Member' => 'Member' ); static $has_many = array(); static $many_many = array(); static $defaults = array(); /** * a record of Email_BounceRecord can't be created manually. Instead, it should be * created though system. */ public function canCreate($member = null) { return false; } } ?>