WooChimp

Documentation

• created: 11/05/2013
• latest update: 01/14/2014
• by: RightPress
• www.rightpress.net/woochimp

This plugin integrates WooCommerce store with MailChimp. MailChimp is an email marketing service provider. You can read more about it on their website.

When this plugin is active, customers can be automatically added to any MailChimp mailing list on checkout. It's also possible to display an opt-in checkbox so customers can express their consent to be added to the list. This plugin comes with a standard WordPress widget that can be added to any sidebar on the webste. Widget displays a configurable newsletter signup form. This plugin also includes a shortcode that can be placed anywhere on the website (pages, posts, product description) to show a newsletter signup form.

WooChimp fully supports MailChimp's Ecommerce 360 functionality. If enabled, order data will be send to MailChimp and associated with subscribers. This allows advanced segmentation when creating email campaigns and autoresponders. Ecommerce 360 integration also allows full campaign-to-order tracking.

You can easily enable or disable any functonality that was described above from the administrator zone. Please refer to other sections of this documentation for more information.

To install WooChimp plugin simply:

• Make sure you have WordPress 3.5+ and WooCommerce 2.0.x installed
• WooCommerce does not have to be active during installation but this plugin won't do anything without WooCommerce being active
• Download the plugin from CodeCanyon
• Unzip the downloaded file and locate a file called woochimp.zip under Plugin
• Log in to your WordPress administrator zone
• Go to Plugins --> Add New --> Upload
• Upload file woochimp.zip
• Activate the uploaded plugin

• Download the plugin from CodeCanyon
• Extract the archive
• Locate a folder called woochimp under Plugin
• Upload this folder to wp-content/plugins
• In administrator zone, go to Plugins and activate this plugin

• Full WooCommerce integration with MailChimp
• Integration status displayed on admin page
• Opt-in checkbox on checkout
• Pass any order or user property as merge tag
• Signup widget and shortcode
• All signup fields are associated with MailChimp's merge tags
• Add customers automatically
• Skip customers that have previously unsubscribed
• Multiple groups supported for each signup option
• Full Ecommerce360 Support
• Advanced Campaign Targeting enabled
• Advanced Autoresponders enabled
• Campaign-to-Order Tracking
• MailChimp Webhook support
• Frontend fields can be changed from admin page
• Translation ready (.pot file included)
• Extremely flexible
• Nice admin page design

• WordPress 3.5+
• WooCommerce 2+
• PHP cURL extension enabled

You can access admin settings for this plugin by clicking on "MailChimp" under WooCommerce menu.

Integration page lets you set up MailChimp connection and control general settings for this plugin.

General

In this section you can enable integration with MailChimp and set MailChimp API key.

The following fields are available:

• Enable Integration - enable or disable integration with MailChimp. This plugin will not work without active MailChimp integration so it's important to set it up correctly.
• MailChimp API key - enter your MailChimp API key. API key is required for this plugin to communicate with MailChimp servers. You can read more about it here.

Settings

These are main settings for this plugin.

The following fields are available:

• Enable Ecommerce 360 - enable or disable Ecommerce 360 functionality. If enabled, order data will be sent to MailChimp. You can read more about it here.
• Enable Webhooks - if enabled and configured, MailChimp will send this plugin instant updates about changes on your account. This is useful as it extends functionality of this plugin. For example, you can configure this plugin not to auto-subscribe user who has just manually unsubscribed from your list. You can read more about Webhooks here.
• Your Webhook URL - (only displayed when are Webhooks enabled; non-editable) Webhook must be set up on MailChimp side as well. Login to your MailChimp account, go to one of your lists, click on Settings / Webhooks and add this URL as a Callback URL for a new Webhook. You can repeat the same process for all lists that you are going to use.

Status

This section displays current integration status and basic MailChimp account details.

On this page you can control if and how your customers are added to MailChimp lists.

Subscribe On Checkout

These are the main settings for subscriptions on checkout.

The following fields are available:

• Enable - enable or disable subscription on checkout. Choose Subscribe automatically, if you wish to subscribe all customers to one of your lists without asking for their consent. Choose Ask for permission, if you wish to add a checkbox to your Checkout page so users can opt-in to receive your newsletters.
• Label - text to display to customers next to subscription checkbox.
• Default state - select default state of the subscription checkbox. If you select Checked, customers will have to unselect the checkbox in order not to be subscribed to the list.
• Replace groups on MailChimp - if selected, interest groups provided above will replace any other interest groups for existing users. Otherwise, provided groups will be merged with existing interest groups on subscriber profile.
• Double opt-in - enable or disable standard MailChimp double opt-in functionality. If enabled, customers will be sent an email and required to confirm subscription.
• Send welcome email - if enabled, customers will receive welcome email as configured in MailChimp settings.
• Don't resubscribe unsubscribers - (displayed when automatic subscription is selected) if selected, users who have unsubscribed from the selected list in the past, will not be automatically subscribed again. This requires MailChimp Webhook integration to be active.

Lists, Groups And Fields

This section allows you to set up multiple sets of list, group and field selection. You can control which set will be selected and used by setting up conditions.

To add a new set, click on the "Add Set" button. To delete a set, click on the "times" icon on the set header.

On this page you can controll all the settings related to subscription widget.

Subscription Widget

In this section you can change main settings for the subscription widget.

The following fields are available:

• Enable - enable or disable subscription widget. If enabled, a subscription form will be displayed in a widget. You must add MailChimp Subscription widget to one of your sidebars for the subscription form to appear.
• Mailing list - select a MailChimp list to subscribe users to. You must choose a valid list to enable this feature. Values for this field are fetched from MailChimp when the admin page loads, so allow a few seconds for them to appear.
• Groups - select one or multiple MailChimp groups to add subscribers to. Mailing list must be chosen for a list of groups to appear.
• Replace groups on MailChimp - if selected, interest groups provided above will replace any other interest groups for existing users. Otherwise, provided groups will be merged with existing interest groups on subscriber profile.
• Double opt-in - enable or disable standard MailChimp double opt-in functionality. If enabled, customers will be sent an email and required to confirm subscription.
• Send welcome email - if enabled, customers will receive welcome email as configured in MailChimp settings.

List & Groups

This section allows you to set list that users will be subscribed to and groups that they will be added to.

Fields

Fields let you configure what fields will be available on the signup form. All fields are linked to MailChimp's merge tags. Tags are loaded when a list containing merge tags is selected.

Widget Style

Use this section to change the layout and style of the signup form.

The following fields are available:

• Show field labels inline - if enabled, field labels will be shown as placeholders for fields. Otherwise, they will be displayed separately before fields.
• Signup form style - select a style to apply to your signup form. If you choose to inherit the style from your current theme, styling will completely depend on it - in some cases you may get undesired results.
• Custom CSS - using this field, you can further customize the appearance of the subscription form by adding custom CSS to this field. Subscription form is displayed within a table which has a style class woochimp_wg defined. You must use this class as a parent for changes to take effect.

Usage

This section displays basic instructions of how to activate a subscription form widget.

On this page you can controll all the settings related to subscription form shortcode.

Subscription Shortcode

In this section you can change main settings for the subscription shortcode.

The following fields are available:

• Enable - enable or disable subscription shortcode. If enabled, a subscription form will be displayed wherever you place a shortcode.
• Mailing list - select a MailChimp list to subscribe users to. You must choose a valid list to enable this feature. Values for this field are fetched from MailChimp when the admin page loads, so allow a few seconds for them to appear.
• Groups - select one or multiple MailChimp groups to add subscribers to. Mailing list must be chosen for a list of groups to appear.
• Replace groups on MailChimp - if selected, interest groups provided above will replace any other interest groups for existing users. Otherwise, provided groups will be merged with existing interest groups on subscriber profile.
• Double opt-in - enable or disable standard MailChimp double opt-in functionality. If enabled, customers will be sent an email and required to confirm subscription.
• Send welcome email - if enabled, customers will receive welcome email as configured in MailChimp settings.

List & Groups

This section allows you to set list that users will be subscribed to and groups that they will be added to.

Shortcode Style

Use this section to change the layout and style of the signup form.

The following fields are available:

• Show field labels inline - if enabled, field labels will be shown as placeholders for fields. Otherwise, they will be displayed separately before fields.
• Signup form style - select a style to apply to your signup form. If you choose to inherit the style from your current theme, styling will completely depend on it - in some cases you may get undesired results.
• Custom CSS - using this field, you can further customize the appearance of the subscription form by adding custom CSS to this fielqd. Subscription form is displayed within a table which has a style class woochimp_sc defined. You must use this class as a parent for changes to take effect.

Usage

This section displays basic instructions of how to use subscription form shortcode.

On this page, you can translate all titles / labels that are displayed on frontend.

Simply change the value and submit the form to make changes.

If you wish to translate the plugin itself, use .pot file that comes with this plugin under /languages directory (requires some technical knowledge).

If you have any questions, feel free to visit the support center or submit a support ticket.