nswdpc / silverstripe-chimple
Chimple - Simple Mailchimp handling in Silverstripe
Installs: 4 103
Dependents: 1
Suggesters: 0
Security: 0
Stars: 0
Watchers: 3
Forks: 1
Open Issues: 3
Type:silverstripe-vendormodule
Requires
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3
- phpunit/phpunit: ^9.5
- vlucas/phpdotenv: ^5
This package is auto-updated.
Last update: 2024-10-09 02:48:57 UTC
README
This module allows you to create and update Mailchimp list subscriptions via a Silverstripe app/website.
Developers
It supports:
- a subscription controller
- multiple configuration records for setting multiple list/audience combinations
- multiple forms on the same page, for the same list
- a spam protection module
- a default configuration record assigned in Settings/SiteConfig
- configurable defaults in yaml
- queued jobs to handle subscription and failure checking
- a Mailchimp model admin to view current subscriptions and subscription results
- an Elemental subscription form element - documentation
- merge fields support
- tags for subscribers
- ability to submit a form with or without (via XHR) redirecting
- patch previously subscribed list/audience members
- optionally remove current subscriber tags
It doesn't support:
- Managing audience members, use the Mailchimp administration area for that.
Setup
- Configure your Mailchimp API key and list (audience). You will find this in the Mailchimp account settings and relevant audience, respectively.
- In your website, set up one or more configurations
- Assign one of those as the default for the website
- Ensure queues are running, or get a developer to do this for you.
- Test a subscription to your lists
Further documentation beyond the basics is available
Configuration
Example project configuration:
--- Name: app-mailchimp After: - '#silverstripe-chimple' --- NSWDPC\Chimple\Models\MailchimpConfig: # account API key api_key: '<api key>' # default list id list_id: '<list id>'
Spam protection
Use a spam protection module to block spammy submission attempts on the form. The NSWDPC reCAPTCHAv3 module is a good option.
If a module is installed, the subscription form will detect this and enable the default spam protector on the form.
Requirements
See composer.json
Installation
The only supported method of installation is via composer:
composer require nswdpc/silverstripe-chimple
License
BSD-3-Clause
See License
Maintainers
NSW DPC Digital
Credits
This module is a combination of work contributed to various projects over the years by the NSW DPC Digital team and Symbiote.
Bugtracker
Please raise bugs (with instructions on how to reproduce), questions and feature requests on the Github bug tracker
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.