jonom/silverstripe-postmark-mailer

Postmark mailer class for SilverStripe

Notice for SilverStripe 4 users

This module is for SilverStripe v3 only. SilverStripe 4 supports many email services through configuration only by providing a wrapper for SwiftMailer. Postmark takes some extra work to set up though, because SS4 uses SwiftMailer v5, and the official Postmark adapter for that version is incomplete. Here are a couple of different approaches for working around the issue:, _(*1)

• Use patched fork through composer
• Create custom transport in project

SilverStripe Postmark Mailer

This module lets you send SilverStripe emails through the official Postmark PHP library, falling back to PHP's built-in sendmail() if Postmark is unreachable., _(*2)

Requirements

• PHP 5.5+
• SilverStripe ^3.1
• Postmark-PHP

Note: an alternative Postmark Mailer class that works with older versions of SilverStripe and PHP is available here., _(*3)

Installation

Install with Composer. Learn how, _(*4)

composer require "jonom/silverstripe-postmark-mailer:^1.0"

Documentation

You will need to provide a PostmarkAPP API key and at least one verified email address (Sender Signature) that you have set up in your Postmark account. If you try to send an email from a non-verified address, the From address will be changed to the first verified address you provided and a Reply-To field will be set with the original From address., _(*5)

Example configuration

In your project's _config.php file:, _(*6)

Email::set_mailer(new PostmarkMailer());

or:, _(*7)

// Send email through Postmark in live environment only
if (Director::isLive()) {
    Email::set_mailer(new PostmarkMailer());
}

In your project's _config/config.yml file:, _(*8)

PostmarkMailer:
  api_key: 'your-key-goes-here'
  sender_signatures:
    - 'example@yourwebsite.com'
    - 'example2@yourwebsite.com'

Maintainer contact

Jono Menz, _(*9)

Sponsorship

If you want to boost morale of the maintainer you're welcome to make a small monthly donation through GitHub, or a one time donation through PayPal. ❤️ Thank you!, _(*10)

Please also feel free to get in touch if you want to hire the maintainer to develop a new feature, or discuss another opportunity., _(*11)