Mailchimp for WordPress

Allowing your visitors to subscribe to your newsletter should be easy. With this plugin, information technology finally is.

This plugin helps you lot grow your Mailchimp lists and write improve newsletters through various methods. You tin create adept looking opt-in forms or integrate with any existing form on your site, like your comment, contact or checkout form.

Some (but not all) features

  • Connect with your Mailchimp account in seconds.

  • Sign-up forms which are adept looking, convenient and mobile optimized. You have complete control over the course fields and tin can ship annihilation you similar to Mailchimp.

  • Seamless integration with the post-obit plugins:

    • Default WordPress Comment Form
    • Default WordPress Registration Form
    • Contact Class 7
    • WooCommerce
    • Gravity Forms
    • Ninja Forms 3
    • WPForms
    • BuddyPress
    • MemberPress
    • Events Manager
    • Easy Digital Downloads
    • Give
    • UltimateMember

  • A multitude of available add-on plugins and integrations:

    • Mailchimp for WordPress Premium
    • Mailchimp Top Bar
    • Mailchimp Activity
    • Boxzilla Pop-ups
    • Google reCAPTCHA
    • WPBruiser anti-spam

  • Well documented. Our knowledge base is updated daily.

  • Developer friendly. For inspiration, check out our repository of example code snippets.

Get a Premium user

Mailchimp for WordPress has a Premium add-on which comes with several additional benefits.

  • Multiple forms
  • Advanced e-commerce integration for WooCommerce
  • Email notifications
  • An easy way to style your forms
  • Detailed reports & statistics

View more Premium features

What is Mailchimp?

Mailchimp is a newsletter service that allows you to send out email campaigns to a list of electronic mail subscribers. It is free for lists up to 2000 subscribers, which is why it is the newsletter-service of choice for thousands of businesses.

This plugin allows you to tightly integrate your WordPress site with your Mailchimp account.

If y'all are non yet using Mailchimp, creating an account is 100% free and only takes y'all virtually 30 seconds.

Support

Use the WordPress.org plugin forums for community support where nosotros endeavour to help all of our users. If yous found a bug, please create an issue on Github where we can act upon them more efficiently.

If you're a premium user, delight apply the e-mail address within the plugin for support as that volition guarantee a faster response time.

Please have a look at the Mailchimp for WordPress knowledge base besides.

Add-on plugins

There are several add-on plugins available, which help you become even more out of your site.

Translations

You tin help interpret Mailchimp for WordPress into your language using your WordPress.org account.

Development

This plugin is existence adult on GitHub. If y'all want to collaborate, please look at ibericode/mailchimp-for-wordpress.

Customizing the plugin

The plugin provides various filter & action hooks that allow y'all to modify or extend default behavior. Nosotros're as well maintaining a collection of sample lawmaking snippets.

This plugin provides one cake.

  • Mailchimp for WordPress Form

Installing the plugin

  1. In your WordPress admin panel, get to Plugins > New Plugin, search for Mailchimp for WordPress and click "Install at present"
  2. Alternatively, download the plugin and upload the contents of mailchimp-for-wp.cipher to your plugins directory, which usually is /wp-content/plugins/.
  3. Activate the plugin
  4. Set your API key in the plugin settings.

Configuring Sign-Upwards Form(due south)

  1. Go to Mailchimp for WP > Forms
  2. Select at least one list to subscribe people to.
  3. (Optional) Add more fields to your form.
  4. Embed a sign-up course in pages or posts using the [mc4wp_form] shortcode.
  5. Show a sign-up form in your widget areas using the "Mailchimp Sign-Up Form" widget.

  6. Show a sign-upwardly class from your theme files by using the following PHP part.

    <?php

    if( function_exists( 'mc4wp_show_form' ) ) {
    mc4wp_show_form();
    }

Demand help?

Please have a look at the Mailchimp for WordPress knowledge base outset.

If you can't observe an respond there, please look through the plugin support forums or start your own topic.

More documentation

More detailed documentation can exist found in the Mailchimp for WordPress noesis base.

How to brandish a course in posts or pages?

Use the [mc4wp_form] shortcode.

Go to Appearance > Widgets and utilize the Mailchimp for WP Grade widget that comes with the plugin.

Where can I find my API fundamental to connect to Mailchimp?

You lot can find your API key here

How to add together a sign-up checkbox to my Contact Course 7 form?

Use the post-obit shortcode in your CF7 form to brandish a newsletter sign-upwardly checkbox.

                      [mc4wp_checkbox "Subscribe to our newsletter?"]

The course shows a success message but subscribers are not added to my list(southward)?

If the form shows a success message, there is no doubtfulness that the sign-up asking succeeded. Mailchimp could have a slight delay sending the confirmation electronic mail though, please only be patient and make certain to cheque your SPAM binder.

When you lot accept double opt-in disabled, new subscribers volition be seen equally imports by Mailchimp. They will non show up in your daily digest emails or statistics. We always recommend leaving double opt-in enabled.

How tin can I mode the sign-up class?

You tin can use custom CSS to mode the sign-upward form if y'all practice not similar the themes that come with the plugin. The post-obit selectors can be used to target the various class elements.

                      .mc4wp-form { ... } /* the form element */ .mc4wp-grade p { ... } /* form paragraphs */ .mc4wp-form characterization { ... } /* labels */ .mc4wp-form input { ... } /* input fields */ .mc4wp-class input[type="checkbox"] { ... } /* checkboxes */ .mc4wp-form input[blazon="submit"] { ... } /* submit button */ .mc4wp-alert { ... } /* success & error messages */ .mc4wp-success { ... } /* success message */ .mc4wp-mistake { ... } /* fault messages */

Yous can add together your custom CSS to your theme stylesheet or (easier) by using a plugin like Simple Custom CSS

I'm getting an "HTTP Error" when trying to connect to Mailchimp

If you're getting an HTTP Error subsequently entering your API key, please contact your webhost and ask them if they have PHP CURL installed and updated to the latest version (vii.58.x). Make sure requests to https://api.mailchimp.com/ are allowed also.

How exercise I show a sign-upwardly form in a pop-upwards?

Nosotros recommend the Boxzilla pop-upwardly plugin for this. You can use the class shortcode in your pop-upwards box to testify a sign-up form.

My question is not listed

Please head over to the Mailchimp for WordPress knowledge base of operations for more detailed documentation.

COMPLETE GARBAGE! CANT LINK API gives fault tried for two days, and its sophisticated to edit subscribe class .... from code

Wonder what they do with all the emails they harvest?

Skillful and helpfull Mailprogram

Easily allows me to create custom forms that integrate with my free Mailchimp business relationship. Works with Fluent Forms or WP Mail service.

Read all one,398 reviews

"MC4WP: Mailchimp for WordPress" is open source software. The following people take contributed to this plugin.

Contributors

iv.eight.vii – Mar 2, 2022

  • Fix PHP 8.1 deprecation warnings in MC4WP_Container class.
  • Fix proper name of action hook that fires before Mailchimp settings rows are displayed on the settings page. Thanks LoonSongSoftware.
  • Meliorate WPML compatibility. Thank you Sumit Singh.
  • Set up deprecated function for AMP integration.
  • Only allow unfiltered HTML if user has unfiltered_html adequacy. Please read the below.

Despite all-encompassing testing, we may accept missed some more than obscure HTML elements or attributes from our whitelist.
If you lot notice that some of your grade HTML is stripped subsequently saving your class, please arrive touch on with our back up team and provide the HTML you attempted to salve.

4.8.6 – Jun 24, 2021

  • Add together nonce field to button for dismissing notice asking for plugin review.
  • Add together strings from config/ directory to POT file.
  • Add nonce check to AJAX endpoint for refreshing cached Mailchimp lists.
  • Add capability cheque to AJAX endpoint for retrieving list details.
  • Schedule issue to refresh buried Mailchimp list upon plugin activation.

Thank you to the team over at pluginvulnerabilities.com for bringing some of these changes to our attention.

4.eight.five – Jun one, 2021

Add nonce verification to all URL's using _mc4wp_action query parameter.
This fixes a CSRF vulnerability where a malicious website could trick a logged-in admin user in performing unwanted actions.

A special thanks to Erwan from WPScan for bringing this upshot to our attention.

4.8.4 – May vii, 2021

  • Add together defer aspect to JS file, so page parsing isn't blocked at all.
  • Rewrite plugin CSS to optimize for selector operation and get rid of some duplication.

After installing this update, make sure to also update any add-on plugins like Mailchimp for WordPress Premium and Mailchimp Acme Bar.

4.8.iii – January 21, 2021

  • Fix fatal fault on older PHP versions when submitting class without any subscriber tags set in the form settings.
  • Minor performance improvement in bootstrap method of the plugin.

4.8.ii – Jan 20, 2021

  • Allow short-circuiting mc4wp_subscriber_data filter by returning null or false.
  • Use a subdirectory for the default debug log file location, and so that information technology's easier to protect using htaccess.
  • Improved reliability for fetching lists from mailchimp when lists take loftier stats.member_count property.

4.viii.1 – Aug 25, 2020

  • Fix observe by explicitly setting permission_callback on registered REST route.
  • Pocket-size internal lawmaking improvements.

4.8 – Jul nine, 2020

  • Plugin at present requires PHP five.3 or college.
  • Prefix overlay classname to forbid styling collissions with other plugins.
  • Form sign-ups tin now add tags to both new and existing subscribers.
  • Update JavaScript dependencies.
  • Register script early to piece of work with Gutenberg preview.

four.7.eight – Jun 04, 2020

  • Add MC4WP_API_V3::add_template method.
  • Pocket-sized code hardening to ensure a default form is always set up.
  • Update JS dependencies to their latest versions.
  • Fix icon for Gutenberg block.

4.7.vii – Apr 28, 2020

  • Update JS dependencies to their latest versions.
  • API customer add_list_member method now has an boosted parameter to skip merge field validation.
  • Simplify lawmaking for updating an existing form.

4.7.6 – Apr 9, 2020

  • Update JS dependencies to their latest versions.
  • Bank check if className is of type cord, fixes a console alarm when clicking inside a SVG chemical element.
  • Pocket-size improvements to the AMP implementation to address harmless validation warnings.

4.7.five – Feb 10, 2020

  • Add AMP compatibility to sign-upwards forms, thanks to Claudiu Lodromanean. This uses the official AMP plugin for WordPress.
  • Add settings key to WPML config so settings can hands by copied over to translated versions of a grade.
  • Optimize size & performance of JavaScript code, resulting in a file that is forty% smaller.
  • Update CodeMirror to its latest version.
  • Escape all cord translations.

4.7.4 – December 7, 2019

Fixes

  • htaccess config for servers running Apache two.4 or later.

4.7.3 – Dec 4, 2019

Fixes

  • Top Bar & User Sync add-on using API v2 since version four.7.i.
  • Revert change in formatter for date fields, breaking all forms with date fields in them.

Improvements

  • Add together getter method for raw (unmodified) data on grade grade.

4.vii.2 – Nov 27, 2019

Fixes

  • Invalid .htaccess file in example there already is one in the uploads directory.

4.7.1 – November 26, 2019

Improvements

  • Update MemberPress hook names. Thanks Ian Heggaton!
  • Utilize WordPress.org translations instead of bundling translation files in plugin itself.
  • Write .htaccess to directory of debug log file, to preclude file access.
  • Add some convenient hooks for Checkout for WooCommerce.
  • Cease parsing shortcodes in text widgets as WordPress core does this since version 4.9.

4.vii – Nov 7, 2019

Improvements

  • Add part=alert to form notices.
  • Add setting to pre-check sign-upwardly checkbox for Gravity Forms integrations.
  • Add new position for WooCommerce integration: directly after the billing_email field.
  • Fix PHP notices for submitting a form and saving a form equally an ambassador.
  • Add together link to Koko Analytics plugin.

iv.6.2 – October 24, 2019

Fixes

  • Address fields in forms would always exist required (fifty-fifty if really optional).

Improvements

  • Add together proper SVG admin menu icon.
  • Minor overall performance and retentiveness usage improvements.

4.6.ane – October 7, 2019

Fixes

  • Fixed listing cache usage for WPForms, Gravity Forms and Ninja Forms integrations.

iv.half dozen.0 – Oct 7, 2019

Improvements

  • Improved fetch and cache mechanism for retrieving Mailchimp account details, fetching data only when it is required.
  • Updated Mithril and CodeMirror dependencies.
  • Decreased size of forms.js from 22KB to 9KB.
  • No longer requiring jQuery anywhere.
  • Increase API HTTP request timeout to 15 seconds.

Please note that installing this update requires yous to besides update whatever add-ons like Mailchimp Tiptop Bar and Mailchimp for WordPress Premium (if installed).

four.5.five – Sep 12, 2019

Fixes

  • Google reCAPTCHA script was even so loading even if no forms accept it enabled.

four.v.4 – Sep 11, 2019

Improvements

  • Removed custom color from menu particular for improved accessibility.
  • Accept altogether field format into account when sending information to Mailchimp.
  • Impress Google reCAPTCHA script in footer.

Changes

  • Changed plugin proper noun to MC4WP instead of Mailchimp for WordPress.

iv.five.iii – July 23, 2019

Fixes

  • Temporarily switch status of pending subscribers to "unsubscribe" versus deleting susbcriber before re-subscribing.
  • Deprecation notice for Gravity Forms version 2.iv and higher.

Improvements

  • Filter out empty tags when applying tags to new subscribers.
  • Show all non installed integrations.
  • Prove detect when grade doesn't have a Mailchimp list selected to subscribe people to.
  • Check role existence for compatibility with WordPress 4.seven
  • Don't submit form when Google reCAPTCHA is enabled but errors.
  • Update third-party JavaScript dependencies.

4.5.two – May 8, 2019

Improvements

  • Accept more truthy values in custom integration for improved compatibility with 3rd-party forms.
  • Update JavaScript dependencies.
  • Load Google reCaptcha script in footer (if needed).

4.5.1 – Apr viii, 2019

Additions

  • Add sign-up integration for Requite
  • Add together sign-upwards integration for UltimateMember

Improvements

  • Write to debug log if Google reCAPTCHA hugger-mugger fundamental is wrong.
  • Validate reCAPTCHA keys when savings grade settings.
  • Allow setting an empty "successfully subscribed" message.

4.5.0 – March 27, 2019

Additions

  • Born integration with Google reCAPTCHA to prevent bots from subscribing to your Mailchimp lists.

Improvements

  • Minor improvements to the JavaScript that is loaded on admin pages.

four.4.0 – March i, 2019

Fixes

  • AffiliateWP integration subscribing the wrong user if chapter ID differs from user ID.

Improvements

  • Renamed "MailChimp" to "Mailchimp" to match Mailchimp's new branding.
  • More accurate treatment of timeouts for accounts with many MailChimp lists.
  • UX improvements for integrations overview page.
  • Validate MailChimp API key format when it's entered.
  • Improved compatibility with Klarna Checkout in the WooCommerce checkout integration.
  • Bumped required PHP version to 5.iii (soft requirement for now).

Additions

  • Added Gutenberg block for hands adding a form to a mail or page.
  • Added subscriber tags setting to forms.

4.3.three – December 31, 2018

Fixes

  • Update WPForms integration to properly detect if the WPForms plugin is activated.

Improvements

  • Write API asking parameters to the debug log in case of connexion timeouts.
  • Update JavaScript dependencies.

iv.iii.2 – Dec 11, 2018

Fixes

  • Use of readonly function, which is only available in WordPress 4.9 or later.

4.3.1 – Nov 28, 2018

Fixes

  • Fatal error on PHP versions older than v.5

4.3 – November 28, 2018

Additions

  • Added MC4WP_API_KEY PHP constant which can be used to ready your Mailchimp API key.
  • Add mc4wp_mailchimp_list_limit filter hook to modify the maximum number of Mailchimp lists to fetch. Defaults to 200.

Improvements

  • Use mc4wp_integration_gravity-forms_options filter hook on Gravity Forms integration options and so the checkbox can be prechecked and the checkbox label text modified.
  • The updated_subscriber JS event is now fired forms not using AJAX also (when applicable).

iv.2.five – Sep 11, 2018

Improvements

  • Only re-add subscriber to listing if we want to re-trigger a double opt-in confirmation email.
  • Modify Gravity Forms field name to "Mailchimp for WordPress"
  • Get rid of buried result of Mailchimp API connection.

4.ii.four – July 9, 2018

Improvements

  • Ensure type-safety on some global variables.
  • End showing trashed forms immediately.
  • Pre-check Mailchimp list when creating a new form if at that place is but 1 list.
  • Send null for unknown values in usage tracking data (merely when opted-in).

Additions

  • Add methods for accessing Mailchimp's due east-commerce promo code endpoints to API class.

4.2.three – June 11, 2018

Fixes

  • Don't wrap "concur to terms" input in hyperlink element.
  • Allow [ENTER] key again after field helper overlay is airtight.

Improvements

  • Fallback to meta-refresh if redirect fails considering of "headers already sent" fault.

4.2.two – May 22, 2018

Fixes

  • Events Manager integration was not working with logged-in users.
  • Form preview URL should respect admin HTTP(Due south) scheme.
  • Removed use of PHP 5.4 function.

Improvements

  • Add "agree to terms" checkbox to field helper.

Additions

  • Add filter mc4wp_http_request_args.

4.2.1 – April 11, 2018

Fixes

  • Namespace usage warning when running PHP v.2

Improvements

  • Remove obsolete blazon aspect from all <script> tags printed by the plugin.
  • Improved tooltips on settings pages.
  • Practise not pre-check integration checkboxes past default.
  • Add textual warnings to settings that may affect GDPR compliance.
  • Update translation files.

4.ii – March 5, 2018

Additions

  • Live form preview while editing form.

Improvements

  • Improved conditional fields logic.
  • Debug log at present includes asking & response data.
  • Form JavaScript events are fired in an isolated thread now, to forbid errors in event callbacks from breaking form functionality.
  • Don't send empty field values to Mailchimp when updating subscribers.
  • Show interest group ID in list overview on settings page.

Fixes

  • Ninja Forms export checkbox would e'er land "checked" when form contained a Mailchimp sign-up checkbox.

4.1.xv – Feb 7, 2018

Fixes

  • Dropdown fields with special characters were not properly passed to Mailchimp.
  • Interest groups with an all-numeric ID were not properly passed to Mailchimp.

Improvements

  • Various small code optimizations
  • Practise non redirect when showing "already subscribed" alarm.
  • Improved coil to form treatment after a form is submitted without AJAX.

4.i.14 – Jan 8, 2018

Fixes

  • Validate method was incorrectly checking required assortment fields.

Improvements

  • Wrap some missing strings in translate calls. Thanks morlor.
  • Make it articulate that redirecting subsequently successful grade submissions volition not show the "subscribed" message.

4.i.xiii – December 28, 2017

Fixes

  • Assortment to cord conversion in default form messages.

Additions

  • Allow marking Gravity Forms sign-up checkbox as a required field.

4.one.12 – Dec 11, 2017

Fixes

  • Ninja Forms double opt-in setting was incorrectly inversed.

Improvements

  • Simplified course processing & notice logic.
  • Preclude 404 errors past proactively replacing lowercased name="proper noun" input attributes.
  • Updated JavaScript dependencies.

Additions

  • Integration for AffiliateWP.

4.1.11 – November 2, 2017

Fixes

  • Filter out empty array values when overriding selected Mailchimp lists via _mc4wp_lists.

Improvements

  • Updated JavaScript dependencies.

Additions

  • Link to the HTML Forms from the plugin settings pages.

iv.one.10 – Oct xix, 2017

Improvements

  • Remove unused options from Ninja Forms integration.
  • Now logging all sign-ups from Ninja Forms integrations when using Mailchimp for WordPress Premium.

Additions

  • Added Gravity Forms integration. Y'all can at present integrate with Gravity Forms past adding the "Mailchimp" field to your forms.

iv.ane.ix – September xix, 2017

Improvements

  • Add <label> element to sign-upwards checkbox for WCAG compatibility.
  • Custom integration now works with Enfold theme'south contact form chemical element.

4.1.7 & 4.1.8 – September 8, 2017

Fixes

  • Properly escape the return value of add_query_arg when it is used in HTML attributes to prevent cross-site scripting. Cheers to Karim Ouerghemmi of RIPS for responsibly disclosing.
  • Now loading integrations subsequently WPML and then that String Translations work properly.

Additions

  • Add sign-upwards integration for WPForms forms.

Improvements

  • Updated internal JS dependencies.
  • Form tag {information key="foo.bar"} now allows yous to admission nested assortment values.

4.1.6 – July 31, 2017

Fixes

  • Method on API class for retrieving campaign information.

Improvements

  • Show Akamai reference number when an API request is blocked by Mailchimp's firewall.
  • Minor output buffering improvements in course previewer.

iv.1.five – June 27, 2017

Fixes

  • Failsafe confronting outputting sign-upwards checkbox twice in registration forms.
  • Properly close HTML anchor element in French translation files.
  • Fix BuddyPress sign-ups when using WordPress Multisite.

Improvements

  • Fire action hook mc4wp_form_updated_subscriber whenever a form was used to update a subscriber in Mailchimp.
  • Increment browser timeout for AJAX asking when fetching Mailchimp lists.

Additions

  • Added campaign & template methods to API client form.

iv.1.4 – June 15, 2017

Fixes

  • Some form specific JS events were not firing due to incorrect event names.
  • Registration form integration at present works with WooCommerce registration class.
  • Detect that asks for a plugin review would re-announced afterward dismissing it.

4.1.3 – May 24, 2017

Improvements

  • Randomise time of cron event that renews Mailchimp lists.
  • Always endeavour to show Mailchimp list info when API key is given.

4.1.2 – May 8, 2017

Fixes

  • Utilize before hook priority for Ninja Forms three integration so action is registered on time.

Improvements

  • Improved Mailchimp list fetching & retentivity usage for accounts with many lists.
  • Evidence mistake bulletin when fetching lists fails.
  • Updated plugin translations.

four.i.i – April 11, 2017

Fixes

  • WPML String Translation not working with the checkbox label for sign-upward integrations.

Improvements

  • Use updated order methods when using WooCommerce iii.0, thank you to Liam McArthur.
  • Updated JavaScript dependencies.

4.1.0 – March 14, 2017

Improvements

  • Updated all JavaScript dependencies in the plugin.
  • Failsafed filter hooks to prevent invalid variable types.
  • Explain that greyed out integrations means that specific plugin is not activated.
  • Conditional course elements at present uses result delegation, so it works with forms in Boxzilla pop-ups.
  • Updated language files.

Additions

  • Added back up for Ninja Forms 3.
  • Added mc4wp_integration_show_checkbox filter.

four.0.thirteen – February 8, 2017

Improvements

  • Ensure fields are HTML decoded before sending to Mailchimp.
  • Meliorate OptimizePress compatibility.
  • Testify all address-type fields as required when grade contains 1 or more fields of the same accost group.

4.0.12 – January 16, 2017

Fixes

  • Don't call stripslashes on Mail data twice.

Improvements

  • Plugin review notice is now dismissible over AJAX.
  • Improved formatting of birthday fields.
  • Updated Polish translations, thanks to Mateusz Lomber.
  • Updated German language translations, thanks to Sven de Vries.

Additions

  • Add update_ecommerce_store_product method to API class.
  • Throw form specific JavaScript events, like fifteen.subscribed to hook into "subscribed" events for course with ID fifteen.

4.0.11 – December nine, 2016

Fixes

  • Unescaped request variable on integration settings folio, allowing for authenticated XSS. Thanks to dxwsecurity for responsibly disclosing.

Improvements

  • Add $args parameter to API::get_lists_activity method. Relates to the Mailchimp Activity plugin.

4.0.10 – December 6, 2016

Improvements

  • You tin now enable or disable debug logging from the "Other" settings page.
  • No longer using deprecated part in Contact Form 7, thanks to stodorovic.
  • Improved UI for adding hidden interest groupings fields to a form.

iv.0.9 – November 23, 2016

Fixes

  • Issue with escaped HTML when using form tags introduced by previous update.

4.0.viii – November 23, 2016

Improvements

  • Improved treatment of large debug logs.
  • Improved fault letters when writing exceptions to debug log.
  • Evidence notice when form is missing required Mailchimp fields.
  • Custom class integration at present handles arrays with 1-level depth. Thanks to Mardari Igor.
  • You can at present utilize nested tags in your course code, eg {information key="utm_source" default="{current_path}"}

Additions

  • Add information-hide-if attribute logic to forms. See conditionally hide class fields. Thanks to Kurt Zenisek.
  • Add hooks for delayed BuddyPress sign-upwardly. Cheers to Christian Wach.

4.0.seven – October 25, 2016

Improvements

  • Obfuscate all electronic mail addresses in debug log. Thanks Sauli Lepola.
  • Ask for confirmation before disabling double opt-in, which nosotros practise not recommend.
  • Allow vertical resizing of debug log.
  • Failsafe against including JavaScript file twice.
  • No longer wrapping CF7 checkbox in paragraph tags.

Additions

  • Added mc4wp_form_api_error action hook for API errors encountered past forms.
  • Added element_class statement to [mc4wp_form] shortcode for calculation CSS classes.

4.0.six – October x, 2016

Fixes

  • Issue with lists non showing when using W3 Total Enshroud with APCu object cache enabled.

Improvements

  • We're no longer stripping newlines from text fields.

Additions

  • Added missing eastward-commerce related API methods to API class.

4.0.5 – September 29, 2016

Fixes

  • Allow checkbox selection for the List Choice field (again).

Improvements

  • Fetch Mailchimp lists over AJAX, to speed upwards perceived functioning (especially when your account has many lists).
  • Periodically fetch Mailchimp lists, so enshroud is always fresh.
  • Improved <characterization> element accessibility for checkbox integrations.
  • Stop using double underscore prefix in function names, as these are reserved in PHP seven.
  • {postal service} and {user} shortcodes now accept a default parameter.

Additions

  • Add MemberPress integration.
  • Add missing due east-commerce related API methods for next week's WooCommerce Mailchimp e-commerce integration release.

four.0.four – September seven, 2016

Improvements

  • Allow re-running previous migrations past visiting a certain admin URL.
  • Practise non show checkboxes option for fields that merely accept a single value.
  • Write field specific errors to debug log when Mailchimp denies a sign-upward asking.
  • Write to debug log when custom integrations tin can not find an EMAIL field.
  • Differentiate between connection & authorization errors when testing connection to Mailchimp.
  • Bump limit of number of Mailchimp lists to fetch from 100 to 500.

4.0.3 – August 24, 2016

Fixes

  • Ninja Forms integration not working when using PayPal integration.

Improvements

  • Show connection errors on Mailchimp settings page.

Additions

  • Add pre-checked option to Ninja Forms integration.
  • Yous can now conditionally hide fields or elements using the data-show-if attribute.

4.0.2 – August 10, 2016

Fixes

  • Hidden fields which referenced interest groups by proper noun were not sent to Mailchimp.
  • Adding hidden field to course would reset value on every change.

Improvements

  • Decrease file size of JavaScript for forms past about 30%.

4.0 & 4.0.1 – Baronial 9, 2016

This release updates the plugin to version 3 of the Mailchimp API. Please read through the upgrade guide before updating to make certain things keep working equally expected for y'all.

Changes

  • "Ship welcome electronic mail" is now handled from your list settings in Mailchimp.
  • Filter mc4wp_form_merge_vars is now called mc4wp_form_data.
  • Filter mc4wp_integration_merge_vars is now called mc4wp_integration_data.
  • New format for Grouping fields in forms & filter hooks.
  • Value delimiter in hidden fields is now a pipe | grapheme.

Additions

  • New filter: mc4wp_form_subscriber_data.
  • New filter: mc4wp_integration_subscriber_data.
  • New form tag: {cookie name="mycookie"}

Improvements

  • The plugin now communicates with the latest & greatest Mailchimp API.
  • Previously unsubscribed subscribers can at present be re-added without errors.
  • Add User-Agent header to all API requests.
  • Available fields in form editor are now split-upwards by category.
  • Birthday fields now take a broader range of values and delimiters.

Fixes

  • Upshot with only 10 Mailchimp lists / fields / interests being returned.
  • Incorrect form bulletin showing when double opt-in is disabled.
  • Fault in upgrade routine when API request fails.
  • Listing fields not fetched when list has but i non-default merge field.

three.one.12 – July 28, 2016

Improvements

  • Smarter scrolling later on submitting form & reloading page.
  • Format output of {subscriber_count} tag.
  • You can now apply <img> in your form messages.
  • Add together Mailchimp API fault code to debug log lines.
  • Add plugin name + version to User-Agent header for all Mailchimp API requests.
  • Make certain value of MC_LANGUAGE field is express to 2 characters.

3.one.11 – July 5, 2016

Improvements

  • Update JavaScript dependencies for admin screens.
  • Examination debug log & show notice when it'due south not writable.

Additions

  • Add together "placeholder" option for dropdown fields.

three.1.10 – June 21, 2016

Fixes

  • Styles Builder in Premium not building considering of incorrect flag in core plugin.

Improvements

  • Don't prove position option for WooCommerce integration when sign-upwardly is implicit.
  • Improvements to form previewer logic.
  • Brand sure admin notifications are always shown exactly i time.

3.i.9 – June seven, 2016

Fixes

  • Placeholder polyfill wasn't loaded (but in IE8 and beneath).

Improvements

  • Don't write to debug log if it is non writable.
  • Reset some CSS properties for unremarkably used class names in Form Editor & Debug Log.
  • Do non unnecessarily register styles which are then immediately enqueued.

Additions

  • Add "is required field" option for dropdown & radio fields in Field Helper.
  • Link to Boxzilla plugin from admin sidebar.

3.1.8 – May 23, 2016

Fixes

  • Course Preview way replaced all titles on that folio with "Form Preview".
  • API class fix for eCommerce360 functionality.

Improvements

  • Show dismissible detect when API key is not gear up.
  • Evidence empty API primal errors in plugin log.
  • Friendlier error message for re-subscribe failures.

Additions

  • Add together form.reset() method to JS API.

3.1.seven – May nine, 2016

Fixes

  • Shortcode wasn't accepting element_id as a valid attribute.
  • Take assortment way fields into account when checking if a course contains a given field.

Improvements

  • Nested fields will at present be properly validated when they're marked as required.
  • If plugin is installed using Composer, autoloader won't exist loaded (again).

3.1.6 – April 12, 2016

Fixes

  • Form consequence for starting a form was named start where it should have been started.

Improvements

  • Some preparations for the upcoming migration to the new Mailchimp API (version three).
  • Consistent claw parameters for mc4wp_form_subscribed action.
  • Improved logic for rendering form response.

Additions

  • New checkbox position for WooCommerce checkout integration.

iii.1.5 – March 22, 2016

Fixes

  • Response message was shown for unsubmitted forms when using {response} in the form mark-up with multiple forms on the aforementioned page.

Improvements

  • Scroll to form later form submission now uses native browser method scrollIntoView().
  • Various improvements for right-to-left (RTL) sites.
  • The Mailchimp API fundamental is now obfuscated on the settings page.
  • Contact Form 7 integration at present uses an early hook priority to ensure we run earlier whatsoever folio redirects.

Additions

  • Add position pick for WooCommerce integration.
  • Add together {post} tag whch can be used in class mark-up to fetch properties of the current page or mail service.

iii.1.four – February 29, 2016

Fixes

  • Forms with address fields never passing validation.

Improvements

  • Perform blazon checks on global variables to foreclose bug with poorly coded plugins.
  • Add Interest Category ID to list overview table for easier debugging.
  • Updated Russian translations.

3.ane.3 – February 17, 2016

Fixes

  • Consequence with API assortment responses (for the Mailchimp Activity addition, for instance).

Improvements

  • Updated Dutch, Portugese, Spanish and Italian translations.

3.1.2 – February fifteen, 2016

Fixes

  • Class JavaScript not working when some other plugins loads Dojo framework.
  • [ENTER] not submitting form settings or creating new-line.
  • Internal fields marked as required not passing form validation.
  • Deselecting all Mailchimp lists wouldn't persist after saving form settings.
  • No sign-up request firing for lists with merely an Email field.

Improvements

  • Show accepted choice values for dropdown and radio fields in lists overview.
  • Use all Mailchimp lists for Lists Selection field, instead of just the selected ones.
  • Failsafed JavaScript for when whatsoever other script loads RequireJS globally.

Additions

  • Added support for Shortcake plugin.
  • Error message for when no list is selected can at present be customized from the course message settings.

3.one.1 – February 1, 2016

Fixes

  • Field Helper not adding type aspect when building forms.
  • Field Helper not setting the correct value aspect for Hidden Groups.

Improvements

  • Add sourcemaps to minified JavaScript files.
  • Add link to article on how to enable debug logging.
  • Field Helper now ever shows both placeholder and value fields.

3.ane – January 26, 2016

Fixes

  • <input> fields existence stripped from grade when saving every bit a function other than "superadmin" on MultiSite installations.
  • Certain actions similar "renew lists" not working for users other than admin (if they have explicit access to settings pages).

Improvements

  • Testify Akamai firewall reference number when site's IP address is blocked
  • Make certain integrations have a Mailchimp list selected before trying to subscribe.
  • Move less important settings to "Other" folio.
  • When a field is required in Mailchimp, it has to be required in forms as well at present.
  • Allow including a _mc4wp_email_type field in forms to set an explicit email type.
  • Miscellaneous overall performance improvements.

Additions

  • Added debug logging, which shows all warnings & errors the plugin encountered in communicating with Mailchimp.
  • Add get_lists_for_email( $e-mail ) method to API class.
  • Add MC4WP_Queue form for better background processing of expensive operations.

3.0.12 – January 15, 2016

Fixes

  • Incorrect hooks beingness fired for successful and unsuccessful form sign-ups (which besides broke the success redirect).

three.0.11 – January xiv, 2016

Improvements

  • Permit splitting up "birthday" and "date" fields into separate fields with day, calendar month and twelvemonth index.
  • Improved algorithm for finding fields when integrating with Contact Form 7 or other custom forms.
  • Ninja Forms integration can now automatically find name-fields.
  • Ninja Forms integration tin now utilize mc4wp- prefixed admin labels.

Additions

  • add_ecommerce_order() and delete_ecommerce_order() methods to API class.

3.0.10 – January 6, 2016

Fixes

  • 500 server error for "already subscribed" on Windows servers.
  • Wrong HTML being generated for hidden fields.
  • Duplicate sign-up request when using CF7 integration.

Improvements

  • Stop logging "already subscribed" errors to PHP'south fault log.
  • Simplify pattern attribute for date fields.
  • Remove invalid autofill attribute from honeypot field.

three.0.nine – December 17, 2015

Fixes

Not being able to select a listing when creating a new form.

three.0.viii – December 15, 2015

Fixes

  • Make sure mc4wp_show_form() works without passing a grade ID.

Improvements

  • Remove UI for bulk-enabling integrations, as every integration needs specific settings anyway.
  • Do not impress inline JavaScript for forms until it's surely needed.
  • Add position key to mc4wp_admin_menu_items filter to set a bill of fare position.
  • Various minor code improvements.

3.0.7 – December x, 2015

Fixes

Workaround for SSL certification issues in WordPress four.4, affecting servers with an older versions of OpenSSL installed.

Additions

Added mc4wp_use_sslverify filter to disable or explicitly enable SSL certificate verification.

3.0.4 – Dec 7, 2015

Fixes

  • Fixes compatibility problems with improver plugins performing validation, like Goodbye Captcha and BWS Captcha.

Improvements

  • Now using grouping ID's for interest grouping fields, and then changing the group in Mailchimp does not require updating your form lawmaking.
  • Never load enabled integrations which are not installed.
  • Reintroduce support for automatically sending OPTIN_IP

Additions

  • Add filter: mc4wp_form_data, filters form data earlier information technology is candy.

3.0.iii – November xxx, 2015

Fixes

  • Added backwards compatibility for Goodbye Captcha integration.

Improvements

  • Prevented notice when saving Form widget settings for the outset time.
  • Add together autofill="off" to honeypot field.
  • Remove nonces from forms as they're not really useful for publicly available features.
  • Errors returned by Mailchimp are now logged for Forms also.
  • Pre-select Mailchimp list if there's just one listing in the continued account.
  • Added missing translation calls for Form Editor.

3.0.ii – November 25, 2015

Fixes

  • Redirect on success non working.
  • Forms overview page redirected to chief WP Admin page (edge instance).
  • Safari was always showing the leave-page confirmation dialog.

Improvements

  • Add form-specific classes to preview form element. This allows the Styles Builder to piece of work with the Form Preview.
  • Course events are at present triggered later on the page has finished loading, so all scripts are loaded & ready to use.
  • Reset background-color in Class Themes stylesheets.

iii.0.0 & 3.0.1 – Nov 23, 2015

Version three.0 is a total revamp of the plugin. For a quick overview of the changes, delight read this post on our weblog.

Before upgrading, delight get through the upgrade guide as some things accept changed.

Breaking Changes

  • Captcha fields: {captcha} field is now handled by the Captcha add together-on plugin.
  • New dynamic content tags syntax: {data_NAME} is now {data cardinal="NAME"}
  • Event binding: jQuery(certificate).on('subscribe.mc4wp','.mc4wp-course', function(){ ... }) is now mc4wp.forms.on('subscribed', function(course) { ... })
  • Removed integrations: MultiSite & bbPress.

Improvements

  • New form editor with syntax highlighting, more avant-garde field options & better visual feedback.
  • Improve support for Mailchimp address fields.
  • Amend support for choice fields (eg groupings, list choice & country fields).
  • All fields marked as required are now validated server-side equally well (instead of just Mailchimp required fields).
  • All integrations have their own settings page now.
  • Events Manager: checkbox is at present automatically added to booking forms.
  • Tons of usability & accessibility improvements.
  • Tons of code improvements: improved retentiveness usage, 100+ new unit of measurement tests & ameliorate usage of various best practices.
  • The premium plugin is now an addition of this plugin.

Additions

  • New "Preview Course" option, showing unsaved form changes.
  • Integrations tin now be "implicit", thus no longer showing a checkbox option to visitors.
  • New JavaScript API, replacing jQuery event hooks.
  • Ninja Forms integration
  • Introduced various new filter & activity hooks, please see the new code reference for developers for more data.

2.3.xviii – November 2, 2015

Fixes

  • Incorrect number of parameters for error_log statement in integrations grade.

Improvements

  • Usage tracking is now scheduled one time a week (instead of daily).
  • Preparations for the upcoming Mailchimp for WordPress version iii.0 release.
  • Tested compatibility with WordPress 4.4

2.3.17 – October 22, 2015

Fixes

  • Honeypot field beingness autofilled in Chrome, causing a form error.

Improvements

  • Updated Portugese translations.

2.three.sixteen – October fourteen, 2015

Fixes

  • Error in Russian translation, causing a broken link on the Mailchimp settings page.

Improvements

  • Textual improvements to Mailchimp settings page.
  • Connectivity bug with Mailchimp will at present always bear witness an error message.
  • Renewing Mailchimp lists will now likewise update the output of the {subscriber_count} tag.

ii.iii.15 – October 9, 2015

Fixes

  • Fixes JS fault when form contains no submit push

Improvements

  • Simply prefix url fields with http:// if it is filled.
  • Updated Spanish & Catalan translations, thank you to Xavier Gimeno Torrent.
  • Fix mc4wp_form_before_fields being applied twice.
  • Position honeypot field to the right for Right-To-Left sites.
  • _mc4wp_lists can now be a comma-separated string of Mailchimp list ID'southward to subscribe to (or an array).
  • Pocket-size other defensive coding improvements to foreclose clashes with other plugins.

Additions

  • Added opt-in usage tracking to help us make the plugin better. No sensitive data is tracked.

2.three.14 – September 25

Fixes

  • Use of undefined constant in previous update.

two.3.xiii – September 25, 2015

Fixes

  • Honeypot causing horizontal scrollbar on RTL sites.
  • List choice fields not showing when using one of the default grade themes.

Improvements

  • Minor styling improvements for RTL sites.
  • Mailchimp list fields of blazon "website" will now get HTML5 url type fields.
  • Machine-prefix fields of type url with http://

2.3.12 – September 21, 2015

Fixes

  • Issue with involvement groupings non being fetched later on updating to version 2.3.11

2.3.11 – September 21, 2015

Fixes

  • Honeypot field being filled by browser's autocomplete.
  • Styling issue for submit buttons in Mobile Safari.
  • Empty response from Mailchimp API

Improvements

  • Do not query Mailchimp API for interest groupings if listing has none.
  • Integration errors are now logged to PHP'due south error log for easier debugging.

Additions

  • Y'all tin now use shortcodes in the class content.

2.3.x – September 7, 2015

Fixes

  • Showing "non connected" when the plugin was actually connected to Mailchimp.
  • Issue with address fields when addr1 was non given.
  • Annotate form checkbox not outputted for some older themes.

Improvements

  • Exercise non affluent Mailchimp enshroud on every settings save.
  • Add default CSS styles for number fields.
  • Placeholders will at present piece of work in older version of IE besides.

2.iii.9 – September i, 2015

Improvements

  • Mailchimp lists cache is now automatically flushed later on irresolute your API key setting.
  • Better field population subsequently submitting a form with errors.
  • More helpful error message when no listing is selected.
  • Translate options when installing plugin from a language other than English.
  • Add form mark-up to WPML configuration file.
  • Sign-up checkbox in comment form is now shown earlier the "submit comment" push.
  • URL-encode variables in "Redirect URL" setting.
  • Better mistake bulletin when connected to Mailchimp just account has no lists.

Additions

  • Add mc4wp_form_action filter to set a custom activeness attribute on the course chemical element.

2.3.8 – August 18, 2015

Fixes

  • Prevented JS fault when outputting forms with no submit push button.
  • Using 0 as a Redirect URL resulted in a bare page.
  • Sign-up checkbox was showing twice in the Easy Digital Downloads checkout when showing registration fields, thanks Daniel Espinoza.
  • Default form was not automatically translated for languages other than English.

Improvements

  • Better way to hide the honeypot field, which stops bots from subscribing to your lists.
  • function="class" is no longer needed, cheers XhmikosR!
  • Filter mc4wp_form_animate_scroll now disables just the curl animation, not the curlicue itself.
  • Revamped UI for Mailchimp lists overview
  • Updated German & Greek translations.

Additions

  • Added mc4wp_form_is_submitted() and mc4wp_form_get_response_html() functions.

2.three.7 – July thirteen, 2015

Improvements

  • Use the aforementioned guild as Mailchimp.com, which is useful when you accept over 100 Mailchimp lists.
  • Use /* ... */ for inline JavaScript comments to prevent errors with minified HTML – props Ed Gifford

Additions

  • Filter: mc4wp_form_animate_scroll to disable animated scroll-to later submitting a course.
  • Add {current_path} variable to employ in course templates.
  • Add default attribute to {data_name} variables, usage: {data_something default="The default value"}

2.iii.6 – July 6, 2015

Fixes

  • Undefined index detect when visitor'southward USER_AGENT is non set.

Improvements

  • Relayed the browser'southward Accept-Language header to Mailchimp for auto-detecting a subscriber'due south language.
  • Ameliorate CSS for form reset
  • Updated HTML5 placeholder polyfill

2.3.v – June 24, 2015

Fixes

  • Faulty update for v3.0 appearing for people running GitHub updater plugin.

Improvements

  • Updated language files.
  • Now passing the form as a parameter to mc4wp_form_css_classes filter.

ii.3.four – May 29, 2015

Fixes

  • Result with GROUPINGS not being sent to Mailchimp

Improvements

  • Code preview in Field Builder is now read-just

2.3.3 – May 27, 2015

Fixes

  • Get correct IP address when using proxy like Cloudflare or Sucuri WAF.
  • Employ strict type check for printing inline CSS that hides honeypot field

Improvements

  • Add together contactemail and contactname to field proper noun guesses when integrating with tertiary-party grade.
  • Re-enable sslverify

ii.3.2 – May 12, 2015

Fixes

  • Groupings not beingness sent to Mailchimp
  • Upshot when using more than than one {data_xx} replacement

Improvements

  • IE8 compatibility for honeypot fallback script.

2.iii.1 – May 6, 2015

Fixes

  • PHP notice in includes/grade-tools.php, introduced by version two.3.

2.3 – May vi, 2015

Fixes

  • The email address is no longer automatically added to the Redirect URL as this is against Google Analytics policy. To add it over again, use ?email={email} in your Redirect URL setting.
  • Registration type integrations were non correctly picking up on offset- and last names.
  • JavaScript error in IE8 because of setAttribute telephone call on honeypot field.
  • API class subscribe method at present always returns a boolean.

Improvements

  • Add role attribute to form elements
  • Major code refactoring for easier unit testing and improved lawmaking readability.
  • Employ Composer for autoloading all plugin classes (PHP five.2 compatible)
  • Yous can now use course variables in both forms, messages as checkbox label texts.

Additions

  • You lot tin now handle unsubscribe calls with our forms too.
  • Added Portugese, Indonesian, High german (CH) and Spanish (PR) translations.

2.2.9 – April xv, 2015

Fixes

  • Menu detail for settings folio not appearing on Google App Engine (#88)

Improvements

  • Updated Italian, Russian & Turkish translations.

2.2.8 – March 24, 2015

Fixes

  • API key field value was not properly escaped.
  • Background images were stripped from submit buttons.

Improvements

  • Ameliorate sanitising of all settings
  • Updated all translations

Additions

  • Added mc4wp_before_checkbox and mc4wp_after_checkbox filters to hands add more fields to sign-up checkbox integrations.
  • Added some helper methods related to interest groupings to MC4WP_MailChimp class.
  • Allow setting custom Mailchimp lists to subscribe to using lists attribute on shortcode.

2.2.7 – March 11, 2015

Fixes

  • Honeypot field was visible for themes or templates non calling wp_head() and wp_footer()

Improvements

  • Various minor code improvements
  • Updated German, Spanish, Brazilian, French, Hungarian and Russian translations.

Additions

  • Added mc4wp_form_success action hook to hook into successful sign-ups
  • Added mc4wp_form_data filter hook to modify all form data earlier processing

2.2.six – Feb 26, 2015

Fixes

  • CSS reset wasn't working for WooCommerce checkout sign-up checkbox.
  • mc4wp-submitted class was not added in IE8
  • Incorrect action attribute on form element for some server configurations

Improvements

  • Anti-SPAM improvements: a better honeypot field and a timestamp field to preclude instant form submissions.
  • Reset background-image on submit buttons when using CSS themes
  • Smarter email detection when integrating with third-political party forms
  • Updated all translations

Additions

  • Custom fallback for browsers non supporting input[type="appointment"]

ii.2.five – February 13, 2015

Fixed

  • Effect where WooCommerce checkout sign-up was not working for cheque payments.
  • Translation were loaded too late to properly translate some strings, similar the admin bill of fare items.

Improvements

  • The presence of required list fields in class mark-up is at present checked as yous type.
  • Number fields volition now repopulate if an fault occurred.
  • Updated all translations.
  • Make sure there is only ane plugin instance.
  • Various other lawmaking improvements.

Additions

  • Added support for GitHub Updater Plugin.
  • You can now specify whether you want to send a welcome email (only with double opt-in disabled).

A huge thank you lot to Stefan Oderbolz for various stock-still and improvements related to translations in this release.

two.2.4 – Feb 4, 2015

Fixed

  • Textual set up as entering "0" for no redirection does non work.

Improvements

  • Moved third-party scripts to their ain directory for easier exclusion
  • All code is now adhering to the WP Code Standards
  • Updated Dutch, German, Spanish, Hungarian, French, Italian and Turkish translations.

Additions

  • Now showing a heads upward when at limit of 100 Mailchimp lists. (#71)
  • Added wpml-config.xml file for better WPML compatibility
  • Added filter mc4wp_menu_items for adding & removing menu items from add-ons

2.two.3 – January 24, 2015

Minor improvements and additions for compatibility with the Mailchimp User Sync plugin.

two.2.2 – January xiii, 2015

Fixes

  • Plugin wasn't connecting to Mailchimp for users on Mailchimp server us10 (API keys catastrophe in -us10)

2.two.1 – January 12, 2015

Improvements

  • Use JS object to transfer lists data to Field Sorcerer.
  • Field Magician strings are now translatable
  • Add is_spam method to checkbox integration to battle spam sign-ups
  • Modest code & code fashion improvements
  • Updated Danish, German, Castilian, French, Italian and Portugese (Brazil) translations

Additions

  • You can now set MC_LOCATION, MC_NOTES and MC_LANGUAGE from your form HTML
  • The submit button at present has a default value when generating HTML for it

2.2 – December ix, 2014

Fixes

  • "Select at to the lowest degree ane list" notice appearing when unselecting any Mailchimp list in Grade settings
  • If an error occurs, textareas volition no longer lose their value

Improvements

  • Improved the mode form submissions are handled
  • Minor code & documentation improvements
  • Updated Dutch, French, Portugese and Spanish translations

Additions

  • Added sign-up checkbox integration for WooCommerce checkout.
  • Added sign-up checkbox integration for Like shooting fish in a barrel Digital Downloads checkout.
  • The entered email will now be appended to the URL when redirecting to another page