MailChimp Integration – WHY2 Extensions Manual

Overview

MailChimp Integration Extension for Abantecart – enables you to have two way sync between your MailChimp Audience and your Cart Newsletter List.
1. Export existing newsletter list to MailChimp Audience
2. Keep synchronized between MailChimp Audience and Cart newsletter list.
Example Scenarios:
– If customer unsubscribes via email instead via cart user panel.
– Customer re-subscribes via email instead via cart signup form.
– You’re using MailChimp generated form as the signup form.

AbanteCart v1.2.16 use MailChimp Integration v1.2.16. Tested up to PHP 7.4.
AbanteCart v1.2.15 use MailChimp Integration v1.2.15.1.
AbanteCart v1.2.0 – v1.2.13 use MailChimp Integration v1.2.8.3.

Important Notes:
1. Starting with extension v1.2.15 we have adopted a license key for all our extensions. Your extension will only work if you have a validated license key entered for the location where your extension is installed. Refer to here for more details on how license keys work.
2. AbanteCart v1.2.14 is extremely problematic. Install Patch files or better to update to 1.2.15.

Notes:
When you login into MailChimp from other computer/devices, MailChimp may ask you to send a verification code to your email and then enter the verification code in their verification code field.

Mailchimp Setup

Extension Setup

1. Turn ON to to use the extension.
2. Enter you license code.
3. You need a MailChimp account to use this extension.
A. If you don’t have an account register new account on MailChimp.
B. After you logged into your MailChimp account click on Account name -> Account ->Extras->API Keys
Click “Create A Key” button and copy “API Key” column of your key and paste to My MailChimp API Key field.

4. Choose the desired Audience name you want subscribers added to.

IMPORTANT NOTES:
There are two different contact forms that can be used. You must use only one at a time. Use a form that is designed within your MailChimp account — see No. 5 for details. OR use an extension generated form following the instructions in No. 6 & 7 fields. You can change your form choice at any time.

5. Fill this field with Copy/paste onto your site code which was obtained from MailChimp Sign up Form tools.

If using this form – skip No 6 and 7
6. Choose Yes if you want customer to fill their First Name.
7. Choose Yes if you want customer to fill their Last Name.

Finally Click the Save button.

Notes: You can add Extension generated form by adding Integration_mailchimp block into your layout.

Setup Mailchimp Webhooks

Note: Webhooks are needed to automatically sync your MailChimp subscribers into your cart that subscribe via other places or if you are using MailChimp embedded form instead of our extension generated form. You will only need to setup a webhook once.

Notes for Callback URL:

If you are using “https:”, please use that instead of using “http:” as the prefix of your URL.
If you install AbanteCart in a subfolder then add it into your URL e.g. https://your_url.com/store (store is the subfolder name).
Append /index.php?rt=mc_integration/webhooks after your complete URL.

So it will be like https://your_url.com/store/index.php?rt=mc_integration/webhooks if you’re using HTTPS and subfolder or http://your_url.com/store/index.php?rt=mc_integration/webhooks if you’re not using https.

MailChimp Additional Settings

Mailchimp Tools

Export Newsletter list to MailChimp audience

Click this button to export subscribed customers list to MailChimp Audience.
This is usually only needed if you have not had MailChimp signup form on your cart webpages previously. There is a duplication check made preventing an email being added if already in the MailChimp audience.

Note: Only subscribed customers will be exported. The export is batched and NO welcome email will be sent.

Import MailChimp audience to cart

Click this button to import MailChimp Audience to cart newsletter list.
This is only needed if you are using MailChimp service before using Abantecart script and you want to import existing MailChimp audience to cart newsletter list.

Content

Edit Top And Bottom block content for signup form that comes with extension
You can add additional information above and/or below your signup form display area using the Content tab. This uses the standard block editor, one for each section; top content and bottom content.

Notes:
1. You must add space to the end of the content as this extension doesn’t add html <br> automatically.
2. In case you previously inserted content above or below your signup form and you want to delete the content, make sure that the content is remove completely. You can click on the source button and remove completely.

Select the top content or bottom content, then click on the text Click Here to edit.., that will show the standard editor. Add the content that you wish to display and click SAVE to finish. You have to save each of the content independently.

MailChimp Storefront

MailChimp Signup Form

If you’re using MailChimp Signup Form you will see:

Extension Signup Form

And if you’re using MailChimp extension Signup Form you will see:

Change text

Go to Language Definitions under System->Localization to change the wording according to your desired text.

Changelog

v1.2.16

2020 – 05 – 31

Support AbanteCart v1.2.16.

v1.2.15.1

2020 – 05 – 31

changes1.Change manual location.
2. Change newsletter subscription for both customer signup and extension form from requires customer confirmation to directly add to MailChimp audience.

v1.2.15

2019 – 06 – 15

Initial release for AbanteCart v1.2.15

v1.2.8.3

2018 – 08 – 25

bug-fixFix inline editor mode in mailchimp content page.

Support Php v5.3 – v7.2.
Support AbanteCart v1.2.10 – v1.2.13.

v1.2.8.2

2018 – 08 – 21

bug-fixFix:
1. Use cacert.pem if site is not using HTTPS.
2. Missing firstname and lastname when customer unsubscribe and resubscribe.

v1.2.8.1

2017 – 01 – 07

bug-fixFix:
1. Customer quick view sync newsletter status with MailChimp.
2. Unable to get MailChimp list if Quick View extension is turned on.

Support AbanteCart v1.2.9.

v1.2.8

2016 – 12 – 19

featureMailChimp List name are now available as a dropdown option in admin settings page. So admin doesn’t need to manually input the List ID.

changesUsing MailChimp API v3.

bug-fixFix:
1. Missing extension Newsletter signup block style.
2. Unsubscribing via account notification page for AbanteCart v1.2.6 – v1.2.8.
3. Missing Sign Up button language definition in Newsletter block.

v1.2.7

2016 – 08 – 20

Support AbanteCart v1.2.7 – v1.2.8

v1.2.6

2016 – 04 – 08

Support AbanteCart v1.2.6.

v1.2.0

2015 – 04 – 24

Initial Release.