A Guide to the WP Contact Chimp Plugin
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
- Unzip the
wp-contact-chimp.zipfile into the wp-plugins folder.
- In your WordPress dashboard, head over to the Plugins section.
- Activate Wp Contact Chimp.
- Go to Settings → Wp Contact Chimp and set your defaults.
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
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.
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:
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:
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:
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"]'); ?>
This plugin has been developed at Nichetheme.net, where I fully support all of my WordPress projects, themes, and plugins.
Copyright & license
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