mailchimp-for-wp
Last commit date
assets
2 days ago
config
4 weeks ago
includes
2 days ago
integrations
2 days ago
languages
2 years ago
CHANGELOG.md
2 days ago
LICENSE
1 year ago
SECURITY.md
1 year ago
autoload.php
2 days ago
mailchimp-for-wp.php
2 days ago
readme.txt
15 hours ago
uninstall.php
1 year ago
wpml-config.xml
1 year ago
readme.txt
247 lines
| 1 | === MC4WP: Mailchimp for WordPress === |
| 2 | Contributors: Ibericode, DvanKooten, hchouhan, lapzor |
| 3 | Donate link: https://www.mc4wp.com/contribute/#utm_source=wp-plugin-repo&utm_medium=mailchimp-for-wp&utm_campaign=donate-link |
| 4 | Tags: mailchimp, subscribe, email, newsletter, form |
| 5 | Requires at least: 5.3 |
| 6 | Tested up to: 7.0 |
| 7 | Stable tag: 4.13.0 |
| 8 | License: GPL-3.0-or-later |
| 9 | License URI: http://www.gnu.org/licenses/gpl-3.0.html |
| 10 | Requires PHP: 7.4 |
| 11 | |
| 12 | The #1 Mailchimp plugin for WordPress. Allows you to add a multitude of newsletter sign-up methods to your site. |
| 13 | |
| 14 | == Description == |
| 15 | |
| 16 | *Allowing your visitors to subscribe to your newsletter should be easy. With this plugin, it finally is.* |
| 17 | |
| 18 | This plugins helps you grow your email list in Mailchimp. You can use it to create good looking and accessible sign-up forms or integrate with any other existing form on your WordPress site, like your contact, comment or checkout form. |
| 19 | |
| 20 | [youtube https://www.youtube.com/watch?v=fZCYPnFybqU] |
| 21 | |
| 22 | #### Some (but not all) features |
| 23 | |
| 24 | - Connect with your Mailchimp account in seconds. |
| 25 | |
| 26 | - Sign-up forms which are good looking, user-friendly and mobile optimized. You have complete control over the form fields and can build your forms using native HTML. |
| 27 | |
| 28 | - Seamless integration with the following plugins: |
| 29 | - WordPress Comment Form |
| 30 | - WordPress Registration Form |
| 31 | - Contact Form 7 |
| 32 | - WooCommerce |
| 33 | - Gravity Forms |
| 34 | - Ninja Forms 3 |
| 35 | - WPForms |
| 36 | - BuddyPress |
| 37 | - MemberPress |
| 38 | - Events Manager |
| 39 | - Easy Digital Downloads |
| 40 | - Give |
| 41 | - UltimateMember |
| 42 | - HTML Forms |
| 43 | - AffiliateWP |
| 44 | |
| 45 | - Is the plugin you want to integrate with not listed above? You can probably still use our [custom integration](https://www.mc4wp.com/kb/subscribe-mailchimp-custom-html-form/) feature. Alternatively, the plugin comes with a PHP API to programmatically add a new subscriber to Mailchimp. |
| 46 | |
| 47 | - [Mailchimp for WordPress Premium](https://www.mc4wp.com/): Send your WooCommerce orders to Mailchimp so you can see exactly what each subscriber purchased and how much revenue your email campaigns are generating. |
| 48 | |
| 49 | - A multitude of available add-on plugins and integrations: |
| 50 | - [Mailchimp for WordPress Premium](https://www.mc4wp.com/) |
| 51 | - [Mailchimp Top Bar](https://wordpress.org/plugins/mailchimp-top-bar/) |
| 52 | - [Boxzilla Pop-ups](https://wordpress.org/plugins/boxzilla/) |
| 53 | |
| 54 | - Well documented through our [knowledge base](https://www.mc4wp.com/kb/). |
| 55 | |
| 56 | - Developer friendly. For some inspiration, check out our [repository of example code snippets](https://github.com/ibericode/mailchimp-for-wordpress/tree/main/sample-code-snippets). |
| 57 | |
| 58 | - Ready for PHP 8.5, but backwards-compatible all the way down to PHP 7.4. |
| 59 | |
| 60 | #### What is Mailchimp? |
| 61 | |
| 62 | Mailchimp is a newsletter service that allows you to send out email campaigns to a list of email subscribers. It is free for lists with up to 500 email subscribers, which is why it is the newsletter-service of choice for thousands of small businesses across the globe. |
| 63 | |
| 64 | If you are not yet using Mailchimp, [creating an account is 100% free and only takes you about 30 seconds](http://eepurl.com/igOGeX). |
| 65 | |
| 66 | == Installation == |
| 67 | |
| 68 | #### Installing the plugin |
| 69 | 1. In your WordPress admin panel, go to *Plugins > New Plugin*, search for **Mailchimp for WordPress** and click "*Install now*" |
| 70 | 1. Alternatively, download the plugin and upload the contents of `mailchimp-for-wp.zip` to your plugins directory, which usually is `/wp-content/plugins/`. |
| 71 | 1. Activate the plugin |
| 72 | 1. Set [your API key](https://admin.mailchimp.com/account/api) in the plugin settings. |
| 73 | |
| 74 | #### Configuring Sign-Up Form(s) |
| 75 | 1. Go to *Mailchimp for WP > Forms* |
| 76 | 2. Select at least one list to subscribe people to. |
| 77 | 3. *(Optional)* Add more fields to your form. |
| 78 | 4. Embed a sign-up form in pages or posts using the `[mc4wp_form]` shortcode or Gutenberg block. |
| 79 | 5. Show a sign-up form in your widget areas using the "Mailchimp Sign-Up Form" widget. |
| 80 | 6. Show a sign-up form from your theme files by using the `mc4wp_show_form()` PHP function. |
| 81 | |
| 82 | #### Need help? |
| 83 | Please take a look at the [MC4WP knowledge base](https://www.mc4wp.com/kb/#utm_source=wp-plugin-repo&utm_medium=mailchimp-for-wp&utm_campaign=installation-instructions-link) first. |
| 84 | |
| 85 | If you can't find an answer there, please look through the [plugin support forums](https://wordpress.org/support/plugin/mailchimp-for-wp) or start your own topic. |
| 86 | |
| 87 | == Frequently Asked Questions == |
| 88 | |
| 89 | #### Where can I find my Mailchimp API key? |
| 90 | You can [find your API key here](http://kb.mailchimp.com/accounts/management/about-api-keys#Find-or-Generate-Your-API-Key) |
| 91 | |
| 92 | #### How to display a form in posts or pages? |
| 93 | Use the `[mc4wp_form]` shortcode or the Gutenberg block. |
| 94 | |
| 95 | #### How to display a form in widget areas like the sidebar or footer? |
| 96 | Go to **Appearance > Widgets** and use the **Mailchimp for WP Form** widget that comes with the plugin. |
| 97 | |
| 98 | #### How to add a sign-up checkbox to my Contact Form 7 form? |
| 99 | Use the following shortcode in your CF7 form to display a newsletter sign-up checkbox. |
| 100 | |
| 101 | ` |
| 102 | [mc4wp_checkbox "Subscribe to our newsletter?"] |
| 103 | ` |
| 104 | |
| 105 | Our knowledge base has more information on [connecting Contact Form 7 and Mailchimp](https://www.mc4wp.com/kb/connecting-contact-form-7-and-mailchimp/). |
| 106 | |
| 107 | #### The form shows a success message but subscribers are not added to my list(s)? |
| 108 | If the form shows a success message, there is no doubt that the sign-up request succeeded. Mailchimp could have a slight delay sending the confirmation email though. Please check again in a few minutes (sometimes hours) and don't forget to check your junk folder too. |
| 109 | |
| 110 | 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. [We always recommend leaving double opt-in enabled](http://blog.mailchimp.com/double-opt-in-vs-single-opt-in-stats/). |
| 111 | |
| 112 | #### How can I style the sign-up form? |
| 113 | You can use custom CSS to style the sign-up form if you do not like the themes that come with the plugin. The following selectors can be used to target the various form elements. |
| 114 | |
| 115 | ` |
| 116 | .mc4wp-form { ... } /* the form element */ |
| 117 | .mc4wp-form p { ... } /* form paragraphs */ |
| 118 | .mc4wp-form label { ... } /* labels */ |
| 119 | .mc4wp-form input { ... } /* input fields */ |
| 120 | .mc4wp-form input[type="checkbox"] { ... } /* checkboxes */ |
| 121 | .mc4wp-form input[type="submit"] { ... } /* submit button */ |
| 122 | .mc4wp-alert { ... } /* success & error messages */ |
| 123 | .mc4wp-success { ... } /* success message */ |
| 124 | .mc4wp-error { ... } /* error messages */ |
| 125 | ` |
| 126 | |
| 127 | You can add your custom CSS to your theme stylesheet or (easier) by using a plugin like [Simple Custom CSS](https://wordpress.org/plugins/simple-custom-css/#utm_source=wp-plugin-repo&utm_medium=mailchimp-for-wp&utm_campaign=after-css-link) |
| 128 | |
| 129 | #### How do I show a sign-up form in a pop-up? |
| 130 | |
| 131 | We recommend the [Boxzilla pop-up plugin](https://wordpress.org/plugins/boxzilla/) for this. You can use the form shortcode in your pop-up box to show a sign-up form. |
| 132 | |
| 133 | ### How do I subscribe from my WooCommerce checkout form? |
| 134 | |
| 135 | You can use our WooCommerce integration for that. [How to subscribe to Mailchimp from the WooCommerce checkout form](https://www.mc4wp.com/kb/connect-woocommerce-store-mailchimp/). |
| 136 | |
| 137 | ### How to connect my WooCommerce store with Mailchimp? |
| 138 | |
| 139 | You can find instructions for [connecting your WooCommerce store with Mailchimp](https://www.mc4wp.com/kb/connect-woocommerce-store-mailchimp/) on our website. |
| 140 | |
| 141 | #### I'm getting an "HTTP Error" when trying to connect to Mailchimp. |
| 142 | |
| 143 | the "HTTP Error" type is usually because of a firewall configuration issue or outdated software on your web server. |
| 144 | |
| 145 | Please contact your webhost and ask them to check the following: |
| 146 | |
| 147 | - Whether remote HTTP requests to `https://api.mailchimp.com` are allowed. |
| 148 | - Whether cURL and the PHP-cURL extension are installed and updated to a recent version. |
| 149 | |
| 150 | #### My question is not listed here. |
| 151 | |
| 152 | Please search through our [knowledge base](https://www.mc4wp.com/kb/#utm_source=wp-plugin-repo&utm_medium=mailchimp-for-wp&utm_campaign=faq). |
| 153 | |
| 154 | |
| 155 | == Other Notes == |
| 156 | |
| 157 | #### Support |
| 158 | |
| 159 | If you need some help in setting up the plugin, you have various options: |
| 160 | |
| 161 | - Search through our [knowledge base](https://www.mc4wp.com/kb/#utm_source=wp-plugin-repo&utm_medium=mailchimp-for-wp&utm_campaign=description). |
| 162 | - Open a topic in the [WordPress.org plugin support forums](https://wordpress.org/support/plugin/mailchimp-for-wp) |
| 163 | - If you're a premium user, send an email to the email address listed inside the plugin. |
| 164 | |
| 165 | #### Translations |
| 166 | |
| 167 | You can [help translate this plugin into your language](https://translate.wordpress.org/projects/wp-plugins/mailchimp-for-wp/stable/) using your WordPress.org account. |
| 168 | |
| 169 | #### Development |
| 170 | |
| 171 | This plugin is being developed on GitHub. If you want to collaborate, please look at [ibericode/mailchimp-for-wordpress](https://github.com/ibericode/mailchimp-for-wordpress). |
| 172 | |
| 173 | #### Customizing the plugin |
| 174 | |
| 175 | The plugin provides various filter and action hooks that allow you to modify or extend the default behavior. We're also maintaining a [collection of sample code snippets](https://github.com/ibericode/mailchimp-for-wordpress/tree/main/sample-code-snippets). |
| 176 | |
| 177 | == Screenshots == |
| 178 | |
| 179 | 1. Example sign-up form in the TwentyTwenty theme. |
| 180 | 2. Example sign-up integration with a contact form. |
| 181 | 3. Settings page to connect with your Mailchimp account. |
| 182 | 4. Overview of sign-up integrations. |
| 183 | 5. Overview of sign-up forms. |
| 184 | 6. Settings page to configure an integration. |
| 185 | 7. Page where you edit your sign-up forms. |
| 186 | 8. Page where you modify your form messages. |
| 187 | 9. Settings page for e-commerce integration with Mailchimp. Requires [Mailchimp for WordPress Premium](https://www.mc4wp.com/). |
| 188 | == Upgrade Notice == |
| 189 | |
| 190 | = 3.0.3 = |
| 191 | |
| 192 | Minor improvements and re-added support for Goodbye Captcha integration. |
| 193 | |
| 194 | == Changelog == |
| 195 | |
| 196 | = 4.13.0 = |
| 197 | |
| 198 | _Release date: Jun 1, 2026_ |
| 199 | |
| 200 | - Improve performance by preloading core plugin classes and skipping dynamic content tag parsing when no tags are present. |
| 201 | - Improve security for admin AJAX requests by adding a nonce check and stricter audience ID handling. |
| 202 | - Improve dynamic content tag replacement by removing broken regular expressions. |
| 203 | - Improve form preview output by disabling PHP error display during preview rendering. |
| 204 | - Update JavaScript dependencies and pass admin script data using `wp_add_inline_script()`. |
| 205 | |
| 206 | |
| 207 | = 4.12.6 = |
| 208 | |
| 209 | _Release date: May 26, 2026_ |
| 210 | |
| 211 | - Fix integrations losing runtime options like double opt-in when sign-up attempts are processed asynchronously. Thanks [Jon Parker](https://github.com/jnpkr)! |
| 212 | - Fix Site Tracking Pixel setting not being saved when disabling it. |
| 213 | - Improve accessibility of generated form fields by wrapping inputs in labels and using fieldsets for checkbox and radio fields. |
| 214 | - Improve validation and sanitization of submitted form data. |
| 215 | - Improve debug log safety by truncating overly long messages and improving email address obfuscation. Thanks [Jack Felcher](https://github.com/jjf404)! |
| 216 | |
| 217 | |
| 218 | = 4.12.5 = |
| 219 | |
| 220 | _Release date: May 8, 2026_ |
| 221 | |
| 222 | - Fix fatal error on plugin activation in some cases when wp_rand() returns a value below 10 for the minute part. Thanks [Tim Carr](https://www.wpzinc.com/)! |
| 223 | |
| 224 | |
| 225 | = 4.12.3 = |
| 226 | |
| 227 | _Release date: May 5, 2026_ |
| 228 | |
| 229 | - Improved Mailchimp Site Tracking Pixel support. Site is now automatically discovered or registered in Mailchimp when feature is enabled. |
| 230 | - Sign-up attempts for integrations are now processed asynchronously (via a scheduled event). |
| 231 | - Ensure mc4wp_refresh_mailchimp_lists is scheduled in site's local timezone. |
| 232 | - Added missing translator comments to all translatable strings. |
| 233 | - General code hardening and minor improvements as reported by the Plugin Check tool. |
| 234 | |
| 235 | |
| 236 | = 4.12.2 = |
| 237 | |
| 238 | _Release date: Apr 20, 2026_ |
| 239 | |
| 240 | - Add Mailchimp Campaign Archive block and [mc4wp_campaigns] shortcode to show an archive Mailchimp email campaigns. Thanks to [Faisal Ahammad](https://faisalahammad.com/)! |
| 241 | - WooCommerce: Allow "after email" position for sign-up checkbox when using Checkout Block. |
| 242 | - WooCommerce: Detect use of Checkout Block and only show available positions. |
| 243 | - Show warning when cron is behind schedule. Thanks to [Faisal Ahammad](https://faisalahammad.com/)! |
| 244 | - Add preliminary support for [Mailchimp Site Tracking Pixel](https://mailchimp.com/help/about-mailchimp-site-tracking-pixel/). Thanks to [Faisal Ahammad](https://faisalahammad.com/)! |
| 245 | |
| 246 | [View the full changelog on GitHub](https://github.com/ibericode/mailchimp-for-wordpress/blob/main/CHANGELOG.md) |
| 247 |