Kohana Email v2

Kohana Email provides a standardized email interface for sending emails (including attachments) in the Kohana 3.2+ framework. It also provides a Spam Assassin score based on the excellent SpamChecker provided by Postmark (available to non-customers as well). This module does not use switfmailer out of personal distaste.

Features

• Build emails using the common Kohana object format
• Support for HTML and/or plain text emails
• Support for attachments (thanks Josip)
• Support for multiple transports
• Does not require swiftmailer

Current Transports

• PHP mail()
• Postmark (http://postmarkapp.com/)

Additional transports can be added by simply making a new file in /classes/email and extending Email_Transport.

Installation Instructions

1. Copy Kohana Email to your modules directory (e.g. /modules/email)
2. Add Kohana Email to your modules array in bootstrap.php
3. Create a config file at /application/config/email.php and enter your details if necessary.
4. You're ready to start sending emails!

Example Email

$email = Email::compose('my_config_group')
    ->to('newmember@mysite.com')
    ->cc('another-person@mysite.com')
    ->cc('someone-else@mysite.com')
    ->from('hello@mysite.com')
    ->reply('reply@mysite.com')
    ->subject('Welcome to My Site')
    ->body('Plain text welcome message')
    ->body(View::factory('emails/welcome'), 'html')
    ->attachment('files/report.pdf');

try {
    $email->send();
} catch(Email_Exception) {
    echo $e->getMessage();
}

Methods

• to('username@domain.com') *
• cc(array('Proper Name', 'username@domain.com')) *
• bcc('username@domain.com') *
• from('username@domain.com') *
• reply('username@domain.com') *
• subject('My Subject Line')
• body('My body'[, type = 'html'])
• header('Message-ID', 'my.message@id.com') *
• attachment('file/path.pdf')
• send()
• spam_score([verbose = false])

Notes

* This method can be called multiple times.

Email addresses can be in the form 'username@domain.com' or array('Proper Name', 'username@domain.com') and will be expanded to be "Proper Name username@domain.com".

If a file attachment path does not begin with a slash, the Kohana DOCROOT is automatically prepended.

Thanks

• Kohana (http://kohanaframework.org/)
• Postmark (http://postmarkapp.com)
• Josip Lazic (http://lazic.info/josip/)