jonom/silverstripe-postmark-mailer

Postmark mailer class for SilverStripe

Fund package maintenance!
jonom
www.paypal.me/jmnz

Installs: 8 095

Dependents: 0

Suggesters: 0

Security: 0

Stars: 3

Watchers: 3

Forks: 6

Open Issues: 0

Type:silverstripe-module

v2.0.0 2018-02-13 17:51 UTC

This package is auto-updated.

Last update: 2024-03-28 01:28:11 UTC


README

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:

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.

Requirements

Note: an alternative Postmark Mailer class that works with older versions of SilverStripe and PHP is available here.

Installation

Install with Composer. Learn how

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.

Example configuration

In your project's _config.php file:

Email::set_mailer(new PostmarkMailer());

or:

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

In your project's _config/config.yml file:

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

Maintainer contact

Jono Menz

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!

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