=== MailChimp for WordPress === Contributors: DvanKooten Donate link: http://dannyvankooten.com/mailchimp-for-wordpress/ Tags: mailchimp,form,shortcode,widget,checkbox,comment,newsletter,buddypress,multisite,bbpress,woocommerce,easy digital downloads,contact form,contact form 7 Requires at least: 3.5 Tested up to: 3.9.1 Stable tag: 2.0.2 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html The best MailChimp plugin to get more email subscribers. Easily add sign-up forms and sign-up checkboxes to your WordPress website. == Description == = MailChimp for WordPress = *Adding sign-up methods for your MailChimp lists to your WordPress site should be easy. With this plugin, it is.* MailChimp for WordPress lets you create a highly customizable sign-up form which you can display wherever you want it to display using a simple shortcode, widget or template function. You can also add sign-up checkboxes to various forms on your site, like your comment or contact forms. = Sign-Up Forms = Easily create sign-up forms for your MailChimp list and display it using a simple shortcode, widget or template function. = Sign-Up Checkboxes = Add sign-up checkboxes to *any* form on your website. The plugin offers built-in integration with comment forms, registration forms, Contact Form 7, BuddyPress, bbPress and WordPress MultiSite. **MailChimp for WordPress, at a glance..** - Simple. All you need is your MailChimp API key. - Customizable. Have the form fields generated for you or use your own mark-up. - Beautiful. Choose one of the default form themes or use your own styles. - Developer friendly. [Installation](http://wordpress.org/plugins/mailchimp-for-wp/installation/) | [Frequently Asked Questions](http://wordpress.org/plugins/mailchimp-for-wp/faq/) | [Screenshots](http://wordpress.org/plugins/mailchimp-for-wp/screenshots/) > **Premium features** > > Multiple forms, AJAX, form designer, custom themes, detailed statistics, more built-in checkbox integrations and priority support. > > [More information](http://dannyvankooten.com/mailchimp-for-wordpress/#utm_source=wp-plugin-repo&utm_medium=link&utm_campaign=after-features-link) | [Form demo's](http://dannyvankooten.com/mailchimp-for-wordpress/demo/#utm_source=wp-plugin-repo&utm_medium=link&utm_campaign=after-features-link) | [Upgrade now >>](http://dannyvankooten.com/mailchimp-for-wordpress/#utm_source=wp-plugin-repo&utm_medium=link&utm_campaign=after-features-link) **Translators** - English (en_US) - Danny van Kooten - Dutch (nl_NL) - Danny van Kooten - Spanish (es_ES) - [Paul Benitez - Tecnofilos](http://www.tecnofilos.net/) If you have created your own language pack (or have an update of an existing one) you can send in your .PO and .MO files so we can bundle it into MailChimp for WordPress. You can [download the latest POT file](http://plugins.svn.wordpress.org/mailchimp-for-wp/trunk/languages/mailchimp-for-wp.po), and [PO files in each language](http://plugins.svn.wordpress.org/mailchimp-for-wp/trunk/languages/). **More information** - Other [WordPress plugins](http://dannyvankooten.com/wordpress-plugins/#utm_source=wp-plugin-repo&utm_medium=link&utm_campaign=more-info-link) by [Danny van Kooten](http://dannyvankooten.com#utm_source=wp-plugin-repo&utm_medium=link&utm_campaign=more-info-link) - Contact Danny on Twitter: [@DannyvanKooten](http://twitter.com/dannyvankooten) - If you're a dev, follow or contribute to the [MailChimp for WP plugin on GitHub](https://github.com/dannyvankooten/mailchimp-for-wordpress) == Installation == = Installing the plugin = 1. In your WordPress admin panel, go to *Plugins > New Plugin*, search for *MailChimp for WordPress* and click "Install now" 1. Alternatively, download the plugin and upload the contents of `mailchimp-for-wp.zip` to your plugins directory, which usually is `/wp-content/plugins/`. 1. Activate the plugin 1. Set your MailChimp API key in the plugin settings. = Configuring Sign-Up Checkboxes = 1. Go to *MailChimp for WP > Checkboxes* 1. Select at least one list to subscribe visitors to. 1. Select at least 1 form to add the checkbox to, eg your comment form. = Configuring Sign-Up Form(s) = 1. Go to *MailChimp for WP > Forms* 1. Select at least one list to subscribe visitors to. 1. *(Optional)* Add more fields or dynamic content to your form using the **add field** tool. 1. Show the form in pages or posts by using the `[mc4wp_form]` shortcode. 1. Show the form in your widget areas using the plugin widget. 1. Show the form from your template files by calling `mc4wp_form()` Need help? Please take a look at the [frequently asked questions](http://wordpress.org/plugins/mailchimp-for-wp/faq/) first = Upgrade to Pro = If you like the plugin, upgrade to [MailChimp for WordPress Pro](http://dannyvankooten.com/mailchimp-for-wordpress/#utm_source=wp-plugin-repo&utm_medium=link&utm_campaign=installation-instructions-link) for an even better plugin. == Frequently Asked Questions == > **Is there a premium version of this plugin?** > > Yes, you will love it. Some Pro features are: > > 1. Multiple forms, each subscribing to one or multiple MailChimp list(s). > 1. AJAX - no page reload after submitting a sign-up form. > 1. Custom color themes and a form designer (CSS Builder) > 1. Statistics & log. Learn when, where and how your visitors subscribed. > > [More Pro features](http://dannyvankooten.com/mailchimp-for-wordpress/#utm_source=wp-plugin-repo&utm_medium=link&utm_campaign=faq-link) | [Demo](http://dannyvankooten.com/mailchimp-for-wordpress/demo/#utm_source=wp-plugin-repo&utm_medium=link&utm_campaign=faq-link) = How to display a form in posts or pages? = Use the `[mc4wp_form]` shortcode. = How to display a form in widget areas like a sidebar? = Use the **MailChimp for WP Form** Widget that comes with the plugin. = How to display a form in my template files? = Use the `mc4wp_form()` function. ` if( function_exists( 'mc4wp_form' ) ) { mc4wp_form(); } ` = Oops. Something went wrong. = `Admin notice: FNAME must be provided - Please enter a value` Your selected MailChimp list requires a field named **FNAME**. Either go into your MailChimp list settings and make the FNAME field optional or add it to your form (using the *Add MailChimp field** select box). = The form shows a success message but subscribers are not added to my list(s)? = If the form shows a success message, it means MailChimp accepted the sign-up request and will take over from there. MailChimp could have a slight delay sending the confirmation email though, just be patient. = How can I style the sign-up form? = You can use CSS rules to style the sign-up form, use the following CSS selectors to target the various form elements. ` .mc4wp-form { ... } /* the form element */ .mc4wp-form p { ... } /* form paragraphs */ .mc4wp-form label { ... } /* labels */ .mc4wp-form input { ... } /* input fields */ .mc4wp-form input[type="checkbox"] { ... } /* checkboxes */ .mc4wp-form input[type="submit"] { ... } /* submit button */ .mc4wp-alert { ... } /* success & error messages */ .mc4wp-success { ... } /* success message */ .mc4wp-error { ... } /* error messages */ ` Add your custom CSS rules to the end of your theme stylesheet, **/wp-content/themes/your-theme-name/style.css**. Do not add them to the plugin stylesheet as they will be automatically overwritten on the next plugin update. [PS: With the Pro version, you can design beautiful forms easily >>](http://dannyvankooten.com/mailchimp-for-wordpress/#utm_source=wp-plugin-repo&utm_medium=link&utm_campaign=after-css-link) = Where can I find my MailChimp API key? = [Here](http://kb.mailchimp.com/article/where-can-i-find-my-api-key) = How to add a sign-up checkbox to my Contact Form 7 forms? = Use the following shortcode in your CF7 form mark-up to display a sign-up checkbox. `[mc4wp_checkbox "My custom label text"]` You can then use `[mc4wp_checkbox]` inside your CF7 email templates, it will show "yes" or "no". If you need more data for your merge fields, prefix the field name with `mc4wp-`. *Example CF7 template for MailChimp WEBSITE field* ` [text* mc4wp-WEBSITE] ` = Can I add a checkbox to third-party forms? = Yes. Just include a checkbox with name attribute `mc4wp-subscribe` and value `1` in your form. *Example HTML* ` ` If you need to send more data to your MailChimp list, prefix the name attribute with `mc4wp-`. *Example HTML code for MailChimp list field called WEBSITE* ` ` = How do I add subscribers to certain interest groups? = Use the field wizard. Or, if you know more about HTML, the following snippet should get you started. *Replace `###` with your grouping ID or grouping name.* ` ` Or, if you want to use a hidden field... ` ` = I don't see new subscribers but they are still added to my list = When you have double opt-in disabled, new subscribers will be seen as *imports* by MailChimp. They will not show up in your daily digest emails or statistics. My recommendation is to leave double opt-in enabled. = Can I add more (hidden) fields to the sign-up checkbox? = Not at the moment, but you can add more data using a filter. Here is a code snippet to [add grouping information to comment form sign-ups](https://gist.github.com/dannyvankooten/7120559). = How do I add a Captcha to my forms? = Install the [BWS Captcha](https://wordpress.org/plugins/captcha/) plugin, then use `[captcha]` inside your form mark-up. = Why does the checkbox not show up at my comment form? = Your theme probably does not support the necessary comment hook this plugin uses to add the checkbox to your comment form. You can manually place the checkbox by placing the following code snippet inside the form tags of your theme's comment form. `` Your theme folder can be found by browsing to `/wp-content/themes/your-theme-name/`. == Screenshots == 1. Simple or advanced sign-up forms that blend in with your theme. 2. A sign-up checkbox in your comment form is an amazing conversion booster. 3. A simple form in the footer of the Twenty Thirteen theme. 4. Add sign-up checkboxes to various places on your site. 5. Creating sign-up forms is easy. The Pro version allows you to create as many form as you like. 6. Write your own HTML or have it generated for you. Many (optional) customization settings are availabl. 7. **Pro only:** Gain valuable insights which method your visitors used to subscribe for any given time period using beautiful line charts. 8. **Pro only:** Create your own CSS styles with the form designer in the Pro version. == Changelog == = 2.0.2 = **Fixes** - Fix fatal error when using `mc4wp_checkbox()` function - No more double API request when integrating with Contact Form 7 **Improvements** - Template functions are now always loaded when needed - A warning will now show when required fields are missing in the form mark-up - Required form classes can no longer be accidentally removed - Various checkbox integration improvements - Various CSS improvements to colored form themes - Updated Spanish translations = 2.0.1 = **Improvements** - Allowed translation of more strings in the settings screens. - Added Spanish translations, thanks [Paul Benitez - Tecnofilos](http://www.tecnofilos.net/) - Minor code improvements **Additions** - Saving forms without an `EMAIL` field or submit button will show a notice. = 2.0 - April 29, 2014 = **Improvements** - CSS is now served as static CSS instead of being served through PHP. - The anti-spam honeypot is now added to the sign-up checkbox as well. - Improved object-oriented code architecture and better class documentation - Better CSS reset for the various form themes to increase theme compatibility - Added class autoloading to the plugin - Various minor code improvements **Additions** - You can now add a captcha field to your sign-up forms by installing the [BWS Captcha](http://wordpress.org/plugins/captcha/) plugin and using `[captcha]` inside your form mark-up. - All settings pages are now fully translatable. The plugin has just 2 translations available yet (`en_US` and `nl_NL`) so if you're good at translating, please send me your language pack for the plugin. - You can now use tab indentation in the form markup textarea = 1.5.8 - March 26, 2014 = **Fixes** - 'call to undefined function' when using Avia Layout Builder - "Already subscribed" message never showing = 1.5.7 - March 18, 2014 = **Fixes** - Fixed special characters in group names not working - Fixed BIRTHDAY field format (mm/dd) **Improvements** - Moved away from Singleton pattern - Added a code version number for upgrade routines - Better class documentation - MailChimp cached data improvements. Now showing subscriber count. - Base form CSS improvements, added vertical-align to field elements and removed padding from paragraph elements. - Updated Placeholders.js for old IE versions = 1.5.6 - March 13, 2014 = * Fixed: Honeypot textarea showing in some themes * Improved: Plugin will automatically strip duplicate `