f500/swiftmailer-sparkpost

A SwiftMailer transport implementation for the SparkPost API.

SwiftMailer SparkPost Transport

, _(*1)

A SwiftMailer transport implementation for the SparkPost API., _(*2)

It uses the official SparkPost PHP library., _(*3)

It adds support for some SparkPost specific features to SwiftMailer messages., _(*4)

Installation

composer require f500/swiftmailer-sparkpost

Usage

$transport = SwiftSparkPost\Transport::newInstance('API-KEY');
$mailer    = Swift_Mailer::newInstance($transport);

$message = Swift_Message::newInstance()
    ->setFrom('me@domain.com', 'Me')
    ->setTo(['john@doe.com' => 'John Doe', 'jane@doe.com'])
    ->setSubject('...')
    ->setBody('...');

$sent = $mailer->send($message);

Specialized messages

$message = SwiftSparkPost\Message::newInstance()
    ->setFrom('me@domain.com', 'Me')
    ->setTo(['john@doe.com' => 'John Doe', 'jane@doe.com'])
    ->setSubject('...')
    ->setBody('...')

    ->setCampaignId('...')
    ->setPerRecipientTags('john@doe.com', ['...'])
    ->setMetadata(['...' => '...'])
    ->setPerRecipientMetadata('john@doe.com', ['...' => '...'])
    ->setSubstitutionData(['...' => '...'])
    ->setPerRecipientSubstitutionData('john@doe.com', ['...' => '...'])
    ->setOptions(['...']);

Configuration

$config    = SwiftSparkPost\Configuration::newInstance();
$transport = SwiftSparkPost\Transport::newInstance('API-KEY', $config);
$mailer    = Swift_Mailer::newInstance($transport);

Override recipients

Override all To, Cc and Bcc addresses, but leave name and per-recipient properties intact., _(*5)

john@doe.com becomes override@domain.com., _(*6)

$config = SwiftSparkPost\Configuration::newInstance()
    ->setRecipientOverride('override@domain.com');

Gmail style

john@doe.com becomes override+john-doe-com@domain.com., _(*7)

$config = SwiftSparkPost\Configuration::newInstance()
    ->setRecipientOverride('override@domain.com')
    ->setOverrideGmailStyle(true);

Options for all messages

$config = SwiftSparkPost\Configuration::newInstance()
    ->setOptions([
        SwiftSparkPost\Option::TRANSACTIONAL    => false,
        SwiftSparkPost\Option::OPEN_TRACKING    => false,
        SwiftSparkPost\Option::CLICK_TRACKING   => false,
        SwiftSparkPost\Option::SANDBOX          => true,
        SwiftSparkPost\Option::SKIP_SUPPRESSION => true,
        SwiftSparkPost\Option::INLINE_CSS       => true,
        SwiftSparkPost\Option::IP_POOL          => 'some-ip-pool',
    ]);

These options are also available for messages, where they take precedence over the configured options., _(*8)

$message = SwiftSparkPost\Message::newInstance()
    ->setOptions(['...']);

IP pool probability

Add a probability factor to enable the IP pool only for a percentage of messages sent. 0 will never use the IP pool, 1 will always use it., _(*9)

Can be used to facilitate an IP warming process., _(*10)

$config = SwiftSparkPost\Configuration::newInstance()
    ->setOptions([SwiftSparkPost\Option::IP_POOL => 'some-ip-pool'])
    ->setIpPoolProbability(0.5);

License

[Copyright 2017 Future500 B.V.][4], _(*11)