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.3.2 use MailChimp Integration v1.3.2. Tested up to PHP 8.0.
AbanteCart v1.3.1 use MailChimp Integration v1.3.1. Tested up to PHP 8.0.
AbanteCart v1.3.0 use MailChimp Integration v1.3.0.1. Tested up to PHP 8.0.
AbanteCart v1.2.16 use MailChimp Integration v1.2.16.5. Tested up to PHP 7.4.
AbanteCart v1.2.15 use MailChimp Integration v1.2.15.5.
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.

Setup

Extension Setup

1. Turn ON to to use the extension.

Important Notes: If you already have an account in our support system and you are using multiple WHY2 extensions, you do NOT need to create another account in the support system.

2. Enter your WHY2 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.

Note: If using MailChimp Embedded forms – skip No 6 and 7

5. Fill this field with MailChimp Embedded Forms code. Refer here for how to obtain the embedded forms code.

6. Choose Yes if you want customer to fill their First Name.
7. Choose Yes if you want customer to fill their Last Name.

IMPORTANT NOTES:
1. You can use MailChimp Pop Up Form along with the built in form or the embedded form.
2. Pop Up form is controlled from within MailChimp, there are no blocks for it.

8. Show Pop Up Form: Turn ON if you want to use MailChimp Pop Up Form.
9. MailChimp Pop Up Form code: Enter the MailChimp Pop Up Form code here. Refer here for how to obtain the Pop Up form code.
10. Pop Up Signup Form re-show time: Enter the desired days to re-show the Pop Up Signup Form.<
Finally Click the Save button.

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

Obtain Embedded Forms Code

1. Click the Audience Menu.
2. Click Signup forms.
3. Click Select button.

4. Copy the code here into field number 5 in the settings page above.

Obtain Pop Up Form Code

1. Click Audience menu.
2. Click Signup forms.
3. Click Select button.

4. Click Connect Site.

5. Enter your website without https:// or http:// if your cart is installed in subfolder.
6. Click Get started right after you have enter your website URL.

7. Copy the code here to field number 9 in settings page above.
8. Click Check Connection after you have copy the code and save the extension settings page.

9. Enable the toggl button to publish your Pop Up Form and your site will show the Pop Up form now.

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.

Additional Settings

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.

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.

Extension Updater

To assist you in always having the most current and correct version of your extension we have added a feature to notify you in the message section of your admin panel. And directly allow you to update this extension.

After you have installed MailChimp Integration Extension v1.2.15.1 or v1.2.16 or higher the feature will be available.

For details on how the Extension Updater works click here.

For information on support and updates fees check our KB here.

Changelog

v1.3.2

2022 – 01 – 16

Support AbanteCart v1.3.1

v1.3.1

2021 – 08 – 16

Support AbanteCart v1.3.1

v1.3.0.1

2021 – 06 – 03

bug-fixFix incorrect available extension version checker.

v1.3.0

2021 – 05 – 07

Support AbanteCart v1.3.0

v1.2.16.5

2021 – 06 – 03

bug-fixFix incorrect available extension version checker.

v1.2.16.4

2021 – 05 – 07

changesEnable version checker in the extension to recognize the new version series v 1.3.x introduced to AbanteCart.

v1.2.16.3

2021 – 01 – 19

featureImplement MailChimp Pop Up form.

v1.2.16.2

2021 – 01 – 14

bug-fixFix error when installed in cart that was not using ac_ as the table prefix.

v1.2.16.1

2020 – 12 – 23

featureImplement support expiration date.

v1.2.16

2020 – 08 – 27

Support AbanteCart v1.2.16.

v1.2.15.5

2021 – 06 – 03

bug-fixFix incorrect available extension version checker.

v1.2.15.4

2021 – 01 – 19

featureImplement MailChimp Pop Up form.

v1.2.15.3

2021 – 01 – 14

bug-fixFix error when installed in cart that was not using ac_ as the table prefix.

v1.2.15.2

2020 – 12 – 23

featureImplement support expiration date.

v1.2.15.1

2020 – 08 – 27

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.

featureImplement built in extension updater.

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.