[] (http://travis-ci.org/Hipaway-Travel/HipMandrillBundle)
Send transactional mail through mandrill.com. This bundle provides an easy api for Symfony2 Projects.
All settings inside message class represent attributes of Mandrill's API. Please refer to their API documentation for Details:
https://mandrillapp.com/api/docs/messages.html
Before you're able to use this bundle you must sign up with Mandrill.
Mandrill is a great way to send your transactional emails and provides detailed advances reports.
Mandrill is free for limited number of email per day, please read through pricing section on the website for more information:
Add the bundle to your composer.json
# composer.json
{
"require": {
"hipaway-travel/mandrill-bundle": "dev-master",
}
}
Run composer install
php ./composer.phar install
Enable the bundle in the kernel
<?php
// app/AppKernel.php
public function registerBundles()
{
$bundles = array(
// ...
new Hip\MandrillBundle\HipMandrillBundle(),
);
}
Add configuration to config.yml.
Log in to Mandrill and go to "Settings" -> "SMTP and API Credentials". Create an API Key and use it in your Symfony2 Configuration.
# config.yml
hip_mandrill:
api_key: xxxxx
disable_delivery: true # useful for dev/test environment. Default value is 'false'
default:
sender: [email protected]
sender_name: John Doe # Optionally define a sender name (from name)
subaccount: Project # Optionally define a subaccount to use
proxy:
use: true # when you are behing a proxy. Default value is 'false'
host: example.com
port: 80
user: john
password: doe123
Now you're all set, send your first transactional mails:
Simple controller Example:
<?php
// src/Hip/ExampleBundle/Controller/ExampleController.php
namespace Hip\ExampleBundle\Controller;
use Symfony\Bundle\FrameworkBundle\Controller\Controller;
use Symfony\Component\HttpFoundation\Response;
use Hip\MandrillBundle\Message;
use Hip\MandrillBundle\Dispatcher;
class ExampleController extends Controller
{
public function indexAction()
{
$dispatcher = $this->get('hip_mandrill.dispatcher');
$message = new Message();
$message
->setFromEmail('[email protected]')
->setFromName('Customer Care')
->addTo('[email protected]')
->setSubject('Some Subject')
->setHtml('<html><body><h1>Some Content</h1></body></html>')
->setSubaccount('Project');
$result = $dispatcher->send($message);
return new Response('<pre>' . print_r($result, true) . '</pre>');
}
}