Simple Mail Chimp Signup

A WordPress Signup Form for Mail Chimp Lists

• Created: 05/07/2012
• latest Update: 05/08/2012
• By: Pippin Williamson - mordauk
• pippinsplugins.com/
• Email: pippin@pippinsplugins.com

Display a signup form for any Mail Chimp email list in your WordPress site.

Introduction

This is a simple plugin that will allow you to display a signup form for any of your Mail Chimp email lists on your WordPress website. Signup forms can be displayed using a widget, short code, or template tag. 

With only a couple of settings, the plugin is extremely easy to use.

Installation

Installation is simple.

There are two ways you install the plugin:

1. Upload the .zip file you downloaded from Code Canyon via the WordPress plugin installer:

1. Go to your WordPress Dashboard
2. Click Plugins
3. Click Add New
4. Choose Upload at the top of the page
5. Click Choose File and locate the .zip file on your computer
6. Click Install
7. Click Activate after the installation is finished

2. Upload the "mailchimp-signup" folder to your WordPress wp-content/plugins/ directory via FTP.

1. Unzip the .zip file downloaded from Code Canyon
2. Connect to your server via FTP
3. Upload "mailchimp-signup" to wp-content/plugins/
4. Go to your WordPress Dashboard
5. Click on Plugins
6. Click "Activate" on "Simple Mail Chimp Signup"

Once the plugin is installed and activated, click on Settings > Mail Chimp. Here you will need to enter your Mail Chimp API key and your Client ID. Instructions for finding these in your Mail Chimp account are below.

Finding your API key:

1. Log into your Mail Chimp account
2. Click on "Account " in the top right corner of your screen
3. Choose "API Keys & Authorized Apps" from the "Extras" section
4. You can use any active API key on this page

Usage

Signup forms can be displayed on your site in sevarl different ways:

• A widget
• A short code
• A template tag

Instructions for using each method are below.

Using the Mail Chimp Signup widget:

1. Click on Appearance > Widgets
2. Add the "Mail Chimp Signup" widget to any available widget area
3. Enter a title for the widget. This will be displayed above the signup form
4. Choose a the email list you want to subscribe users to
5. Enter the "Success Message" text. This is the text shown to the user in place of the signup form after they have subscribed
6. Your signup form will now be displayed in the widget area you placed the widget

Using the Included Short Code:

The short code can be used to display the signup form within the content of any post, page, or custom post type. The short code takes several paramters:

• redirect - this is the URL users are sent to after successfully subscribing. Defaults to the current page.
• list - this is the email list ID that you wish to subscribe users to. The list ID can be found in Settings > Mail Chimp. The ID is the number shown to the left of the list name.
• message - this is the message that is shown to users after they have successfully subscribed (only shown when redirect is not set to a different URL than the current page).

The short code for a form that reloads the same page upon successful subscription, looks like this:

[mailchimp list="1" message="Thanks for subscribing"]

The short code for a form that redirects to a custom page after subscription, looks like this:

[mailchimp list="1" redirect="http://yoursite.com/thanks"]

The exact short code you need to use for any email list can be found on the settings page: Settings > Mail Chimp.

Using the Template Tag:

If you want add the signup form directly to your theme's template files, you can do that using the included template tag.

The template tag looks like this:

pmc_mc_form($redirect, $list_id, $message)

To show a signup form that redirects back to the current page, and shows a message (other than default), you can use this:

echo  pmc_mc_form('', 1, 'You have been subscribed!');

To show a signup form that redirects to a custom URL, use this:

echo  pmc_mc_form('http://yourcustomurl.com/thanks', 1, 'You have been subscribed!');

Support

To obtain support for this plugin, please use use the support forums located at: http://support.pippinsplugins.com/

You may also submit a support ticket via http://pippinsplugins.ticksy.com