nswdpc/silverstripe-taggable-notifications

Add tagging to notifications going out of a Silverstripe project

v1.0.1 2025-04-17 05:34 UTC

Requires

• silverstripe/framework: ^5
• silverstripe/tagfield: ^3
• silverstripe/taxonomy: ^3

Requires (Dev)

• cambis/silverstan: ^1
• cambis/silverstripe-rector: ^1
• nswdpc/ci-files: dev-v-3
• phpunit/phpunit: ^9.5

Suggests

• silverstripe/userforms: Install this module to get tagging of notifications from a user form

BSD-3-Clause

• James Ellis

• notifications
• tags
• tagging
• silverstripe
• nsw

README

A simple module supporting notification services that provide message tagging options (eg. Mailgun).

Depending on the service used, message tags be be used for message analytics, bottlenecks, rejection tracking and other failures (or successes).

Features

• Project-level notification tags defined in configuration (optional)
• Tag limits (optional)
• A Trait for notification clients to use
• Userform extension to tag messages from a form, using silverstripe/taxonomy

Requirements

There are no special requirements for using this module beyond the composer requirements and a configuration required for your notification service.

To set tags on a notification that uses the Taggable trait:

$message = \My\App::getNotificationMessage($name, $number);
$tags = ['tag1','tag2','tag3'];
$message->setNotificationTags( $tags );
$message->deliver();

Email

See the Email section for email configuration and examples.

User forms

If your project uses userforms, each Email recipient will get a tag field allowing per-recipient message tagging.

Installation

composer require silverstripe-taggable-notifications

License

BSD-3-Clause

Documentation

• Documentation

Maintainers

• PD Web Team

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.