innoweb / silverstripe-mailchimp-signup
Adds page type for a MailChimp signup form. Form fields are read automatically from the MailChimp list.
Installs: 6 779
Dependents: 0
Suggesters: 0
Security: 0
Stars: 4
Watchers: 4
Forks: 6
Open Issues: 1
Type:silverstripe-vendormodule
- dev-master
- 5.2.1
- 5.2.0
- 5.1.1
- 5.1.0
- 5.0.1
- 5.0.0
- 4.x-dev
- 4.8.1
- 4.8.0
- 4.7.10
- 4.7.9
- 4.7.8
- 4.7.7
- 4.7.6
- 4.7.5
- 4.7.4
- 4.7.3
- 4.7.2
- 4.7.1
- 4.7.0
- 4.6.3
- 4.6.2
- 4.6.1
- 4.6.0
- 4.5.0
- 4.4.0
- 4.3.1
- 4.3.0
- 4.2.7
- 4.2.6
- 4.2.5
- 4.2.4
- 4.2.3
- 4.2.2
- 4.2.1
- 4.2.0
- 4.1.2
- 4.1.1
- 4.1.0
- 4.0.1
- 4.0.0
- 3.3.1
- 3.3.0
- 3.2.3
- 3.2.2
- 3.2.1
- 3.2.0
- 3.1.0
- 3.0.x-dev
- 3.0.4
- 3.0.3
- 3.0.2
- 3.0.1
- 3.0.0
- 2.4.1
- 2.4.0
- 2.3.1
- 2.3.0
- 2.2.0
- 2.1.4
- 2.1.3
- 2.1.2
- 2.1.1
- 2.1.0
- 2.0.2
- 2.0.1
- 2.0.0
- 1.1.2
- 1.1.1
This package is auto-updated.
Last update: 2024-10-31 23:48:07 UTC
README
Overview
Adds page type for a MailChimp signup form. Form fields are read automatically from the MailChimp list.
The submissions need to be confirmed by the user, they receives a confirmation email from MailChimp.
Requirements
- SilverStripe CMS 5
- symbiote/silverstripe-multivaluefield ^6
- drewm/mailchimp-api ~2.0
Note: this version is compatible with SilverStripe 5. For SilverStripe 4, please see the 4 release line. For SilverStripe 3, please see the 3.x release line.
Installation
Install the module using composer:
composer require innoweb/silverstripe-mailchimp-signup dev-master
Then run dev/build.
Configuration
To disable SSL verfication (e.g. for your local dev environment) you can add the following to your _config.php file:
Config::inst()->update('DrewM\MailChimp\MailChimp', 'verify_ssl', false);
MailChimpSignupPage
The page type has a 'MailChimp' tab where the MailChimp API Key and the AudienceID can be configured.
Once the page is saved it will automatically read the fields from the MailChimp list and display a generated signup form based on these fields.
You can block the loading of jQuery and jQuery validate by using the following config option:
Innoweb\MailChimpSignup\Pages\SignupPageController:
block_default_jquery_and_validate: true
You can block the loading of the form validation script by using the following config option:
Innoweb\MailChimpSignup\Pages\SignupPageController:
block_form_validation: true
If you keep this enabled, you need to have jQuery/validate enabled as well or load these libraries by other means before this form validation script.
The forms fields loaded from MailChimp are cached for 5 minutes by default. You can change the cache time in the config:
Innoweb\MailChimpSignup\MailchimpDataLoader:
field_cache_seconds: 300
Whenever the signup page is published, the cache is deleted.
MailChimpCampaignListPage
The page type has a 'MailChimp' tab where the MailChimp API Key, as well as the campaign filters and limitscan be configured.
The following configuration options are available:
Innoweb\MailChimpSignup\Pages\CampaignListPage:
auto_update: true
update_interval: 3600
If auto_update is enabled, the campaigns are read from MailChimp when the page is displayed, using the update_interval (seconds) as a limit.
The campaigns are always updated when the page is saved.
License
BSD 3-Clause License, see License