nswdpc/silverstripe-structured-email

Structured email for Silverstripe

Maintainers

Details

github.com/nswdpc/silverstripe-structured-email

Source

Issues

Installs: 314

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 1

Forks: 0

Open Issues: 0

Type:silverstripe-vendormodule

v1.0.4 2025-04-23 08:14 UTC

Requires

Requires (Dev)

Suggests

  • ext-tidy: Use tidy to process HTML documents
  • ext-xml: Use DOMDocument to process HTML documents

BSD-3-Clause 2b57b38eff7e61898aefdfeae01b70b160e439b2

  • James

emailsilverstripeschema.orgemail templates

This package is auto-updated.

Last update: 2025-04-23 08:15:29 UTC

README

The goal of this module is to produce simple and easy-to-digest emails (more) using a consistent template. The templates used are based on the Postmark Transactional Email Templates.

For specific core emails, it will attempt to detect the purpose of the email based on the template name:

  • SilverStripe/Control/Email/ForgotPasswordEmail - the forgot password email
  • SilverStripe/Control/Email/ChangePasswordEmail - the changed password email

TODO:

  • SilverStripe/MFA/Email/* - MFA emails
  • SilverStripe/ContentReview/* - Content review emails
  • SubmittedFormEmail - user defined form generic email
  • SubmittedFormEmailPlain - user defined form generic email (plain text)

Existing templates

If the class encounters a complete HTML document in the email, it will use HTML contained within the <body> tag of that document as the email content.

Schema.org

Reference

Resources

Usage

  1. Create emails in the standard way
  2. The MailerSubscriber extension will catch emails prior to being sent
  3. Email content is updated based on the default template and decorator provided
  4. Emails will then be sent out with the updated template and a plain text part

More documentation

Installation

The only supported way of installing this module is via composer

composer require nswdpc/silverstripe-structured-email

License

BSD-3-Clause

Maintainers

The source of the HTML email templates is the Postmark templates project

Bugtracker

We welcome bug reports, pull requests and feature requests on the Github Issue tracker for this project.

Please review the code of conduct prior to opening a new issue.

Security

If you have found a security issue with this module, please email digital[@]dpc.nsw.gov.au in the first instance, detailing your findings.

Development and contribution

If you would like to make contributions to the module please ensure you raise a pull request and discuss with the module maintainers.

Please review the code of conduct prior to completing a pull request.