Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/xpersonas/simple_mailchimp
Drupal 8 module allowing for an easy way to add a subscription option at the end of existing forms so that users can be added to your MailChimp list from any form on the site.
https://github.com/xpersonas/simple_mailchimp
d8 drupal drupal8 mailchimp
Last synced: about 1 month ago
JSON representation
Drupal 8 module allowing for an easy way to add a subscription option at the end of existing forms so that users can be added to your MailChimp list from any form on the site.
- Host: GitHub
- URL: https://github.com/xpersonas/simple_mailchimp
- Owner: xpersonas
- Created: 2020-07-29T13:15:16.000Z (over 4 years ago)
- Default Branch: 8.x-1.x
- Last Pushed: 2020-08-25T18:52:35.000Z (over 4 years ago)
- Last Synced: 2024-11-08T00:06:28.440Z (3 months ago)
- Topics: d8, drupal, drupal8, mailchimp
- Language: PHP
- Homepage: https://www.drupal.org/project/simple_mailchimp
- Size: 29.3 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Simple MailChimp #
This module allows users to select existing forms for which they want to add a
subscription signup option. It is not meant in any way to be as robust as the
standard [MailChimp module](https://www.drupal.org/project/mailchimp).
This module works with:
1. Contact forms (core)
2. Webforms (contrib)
3. Custom module forms (custom)
## Installation ##
Module page: https://www.drupal.org/project/simple_mailchimp
```
composer require drupal/simple_mailchimp
```
1. Install "Simple MailChimp" from the module list page.
2. Configure Simple MailChimp on your site at
admin/config/simple-mailchimp/config, under the Configuration menu.
3. Add MailChimp API key and list ID.
4. Enable forms and map fields.
## Settings ##
* Each form should be on a separate line.
* Separate sections by a pipe.
* Separate properties with a colon.
### Basic Format ###
**Structure:**
```
d8_form_id|email:d8_field|MC_MERGE_TAG:mc_field_type:d8_field
```
**Example:**
```
warranty_form|email:d8_field|FNAME:text:field_fname,MMERGE5:phone:field_phone
```
MailChimp Field Types:
* text
* zip_code
* number
* address
* date
* phone
* birthday
* website
### MailChimp Address Field ###
The MailChimp address field is not very flexible, and can only be used with US
postal addresses. Therefore it is not recommended. However, this module can map
form fields to each part of the MailChimp address field.
MailChimp address field parts:
* addr1
* addr2
* city
* state
* zip
* country
Formatting is similar to before except now we must account for multiple address
parts. Separate MailChimp field and form field with a dash. Separate each part
of the address with two dashes.
**Example:**
```
MMERGE3:address:addr1-thoroughfare--addr2-premise--city-locality...
```