A Guide to the WP Contact Chimp Plugin

The WP Contact Chimp plugin allows you to use Contact Form 7 to get signups to your Mailchimp lists.

As anyone who's used MailChimp knows, the quality of service and features are awesome - it's hard to believe it's free! I wanted to be able to use MailChimp transparently within my WordPress sites while keeping the flexibility of my favorite WP forms plugin, Contact Form 7. WP Contact Chimp is the solution I came up with - connecting to multiple MailChimp lists or even across multiple accounts is as simple as checking a few boxes!

The Plugin Documentation

Use the links below to navigate to a specific section in the documentation:

How to Install the Plugin

      1. Unzip the wp-contact-chimp.zip file into the wp-plugins folder.
      2. In your WordPress dashboard, head over to the Plugins section.
      3. Activate Wp Contact Chimp.
      4. Go to Settings → Wp Contact Chimp and set your defaults.

Default Settings

The default settings section allows you to define some settings that will be the default when you create a new list. This is especially handy if you're only working with one account and your mailing options largely remain the same. The default settings can be easily overridden on each new list created.

Mailchimp Api Key

Every MailChimp account can have one or more Api keys. The keys allow other programs such as this one to access your MailChimp account in a secure way. Once you have generated an api key, you can add it to the default settings section to save you entering it every time you create a new list.

Double Opt In

Subscribers complete the double opt-in process by filling out the signup form first and then confirming subscription to your list. Confirmation is usually done through one or more emails sent to the email address they signed up with. If you set this on the default settings page it can be easily overridden on each new list you create. Defaults to Yes

When you use the double opt-in method, you're targeting only those subscribers who really want to hear from you. Abusing this may cause your MailChimp account to be suspended.

Welcome Email

This option allows you control whether or not new subscribers should receive a welcome email upon signing up. It is generally good practice to do this. If you set this on the default settings page, it can be easily overridden on each new list you create. If your double opt-in is Yes and this is Yes, we will send your lists Welcome Email if this subscribe succeeds. If double opt-in is No, this has no effect. Defaults to No.

Email Format

This option decides the format in which emails will be sent to your list signups. The options are 'Text' and 'HTML'. The text format is better if you think signups email clients may be old school. Generally the HTML format is accepted widely, therefore the default setting is Html.

Email Field ID

This is the ID that you will apply to your Contact Form 7's email field. For example, if I set this value to your-email, a Contact Form 7 I create should look something like this:

[email* your-email]

Firstname Field ID

This is the ID that you will apply to your Contact Form 7's first name field. For example, if I set this value to your-first-name, a Contact Form 7 I create should look something like this:

[text* your-first-name]
Often times the first name field is the only one used - or it acts as the Firstname and Lastname. If this is so, then the last name field will simply be ignored by the plugin.

Lastname Field ID

This is the ID that you will apply to your Contact Form 7's last name field. For example, if I set this value to your-last-name, a Contact Form 7 I create should look something like this:

[text* your-last-name]
Important! Be sure to use the names you set here for the corresponding fields in your Contact Form 7 forms or they won't be detected by the plugin!

How to create a list

When you create a new list from your admin panel, you're effectively creating a mapping between it and a list that you created on MailChimp. This means that any forms that you've included with the "Contact Form 7" checkboxes will be added to your MailChimp list when a user submits their data.

      • View All MailChimp Lists You can view all the lists that have been created by clicking the "MailChimp Lists" link in the admin menu sidebar.

      • Add New MailChimp ListYou add a new list by clicking the "Add New" link in the "MailChimp Lists" submenu. This will present you with a screen not unlike you see when creating a regular post. You can give the new list a title - using the name of the MailChimp list you're mapping to is a good idea - and a description also.

      • MailChimp API Key If not set, the default value will be used.

      • Use Double Opt In If not set, the default value will be used.

      • Email Format If not set, the default value will be used.

      • Send Welcome Email If not set, the default value will be used.

      • Mailchimp list ID

        The Mailchimp list ID is a unique identifier for a given list in your MailChimp account. By entering a list ID, you're telling the plugin to send the selected forms to that list.

        If you don't add a list ID, the forms won't send to MailChimp!
      • Contact 7 Forms

        This is a list of all currently defined Contact Form 7 forms. By checking a form from this section, you're telling the plugin that "every time someone submits this form on the website - send the email to this MailChimp List". Since you can create as many lists as you like, technically you can direct one Contact Form 7 to as many different lists as you like. This isn't recommended, but it's entirely possible!

Adding a Contact 7 Form to Your Website

Contact Form 7 forms are added in the usual manner, this plugin doesn't affect it directly in any way. As usual, a form may be added using a short-code.

[contact-form-7 id="99" title="My Contact Form Name"]

Or within your template code...

<?php echo do_shortcode('[contact-form-7 id="99" title="My Contact Form Name"]'); ?>

Plugin Support

This plugin has been developed at Nichetheme.net, where I fully support all of my WordPress projects, themes, and plugins.

Wp Contact Chimp is licensed under the GNU General Public License, version 2 (GPL).

This plugin is copyrighted to Nichetheme.net.

2012 – 2013 © Nichetheme.net

63,637

total customer downloads. Wow!! That's a lot.

Thanks for all the love! :)

Get Our Newsletter!

Get 20% off our Nice Bundle when you sign-up for our free newsletter!

Get Our Downloads!

Checkout our other fantastic downloads

We have spent a lot of time building a bunch of great downloads for you. Take a few minutes and check out some of our fantastic downloads now.