accord/mandrill-swiftmailer

A SwiftMailer transport implementation for Mandrill

Accord\MandrillSwiftMailer

, _(*1)

A SwiftMailer transport implementation for Mandrill, _(*2)

!! This library is no longer being actively maintained. We are accepting pull requests, but cannot guarantee a timeline for releases. !!, _(*3)

If possible, we recommend migrating your projects to the symfony/mailer component., _(*4)

Installation

Require the package with composer, _(*5)

composer require accord/mandrill-swiftmailer

Usage Example

$transport = new MandrillTransport($dispatcher);
$transport->setApiKey('ABCDEFG12345');
$transport->setAsync(true); # Optional
$transport->send($message);

Using Mandrill-specific Features

Asynchronous Mode

Enable a background sending mode that is optimized for bulk sending, _(*6)

$transport->setAsync(true);

Auto Text

Automatically generate a text part for messages that are not given text, _(*7)

$message->getHeaders()->addTextHeader('X-MC-Autotext', true);

Google Analytics tracking

Mandrill supports automatic Google Analytics tracking for your links. docs, _(*8)

$message->getHeaders()->addTextHeader('X-MC-GoogleAnalytics', 'example.com,www.example.com');
// optional defaults to from address
$message->getHeaders()->addTextHeader('X-MC-GoogleAnalyticsCampaign', 'campaign');

Tags

An array of string to tag the message with, _(*9)

$message->getHeaders()->addTextHeader('X-MC-Tags', 'foo, bar');

Inline CSS

Automatically inline all CSS styles provided in the message HTML - only for HTML documents less than 256KB in size, _(*10)

$message->getHeaders()->addTextHeader('X-MC-InlineCSS', true);

List Unsubscribe

Mandrill automatically adds a List-Unsubscribe header to all emails that include a Mandrill-generated unsubscribe link. If recipients use an email program that supports the List-Unsubscribe header (like Hotmail, AOL, or Yahoo), they can use the option in their email program to unsubscribe., _(*11)

$message->getHeaders()->addTextHeader('List-Unsubscribe', '<mailto:unsubscribe@example.com>');