diff --git a/.github/workflows/php.yml b/.github/workflows/php.yml index 91d8ebeb..e47aedb4 100755 --- a/.github/workflows/php.yml +++ b/.github/workflows/php.yml @@ -5,7 +5,7 @@ jobs: runs-on: ubuntu-20.04 strategy: matrix: - php-versions: [ '7.4', '8.0', '8.1' ] + php-versions: [ '8.0', '8.1', '8.3' ] steps: - uses: actions/checkout@v3 - uses: shivammathur/setup-php@v2 diff --git a/readme.txt b/readme.txt index 6b675af0..ce653a70 100644 --- a/readme.txt +++ b/readme.txt @@ -1,190 +1,192 @@ -=== MC4WP: Mailchimp for WordPress === -Contributors: Ibericode, DvanKooten, hchouhan, lapzor -Donate link: https://www.mc4wp.com/contribute/#utm_source=wp-plugin-repo&utm_medium=mailchimp-for-wp&utm_campaign=donate-link -Tags: mailchimp, mc4wp, email, marketing, newsletter, subscribe, widget, mc4wp, contact form 7, woocommerce, buddypress, ibericode, mailchimp form -Requires at least: 4.6 -Tested up to: 6.3 +=== MC4WP: Mailchimp for WordPress === +Contributors: Ibericode, DvanKooten, hchouhan, lapzor +Donate link: https://www.mc4wp.com/contribute/#utm_source=wp-plugin-repo&utm_medium=mailchimp-for-wp&utm_campaign=donate-link +Tags: mailchimp, mc4wp, email, marketing, newsletter, subscribe, widget, mc4wp, contact form 7, woocommerce, buddypress, ibericode, mailchimp form +Requires at least: 4.6 +Tested up to: 6.3 Stable tag: 4.9.7 -License: GPLv3 or later -License URI: http://www.gnu.org/licenses/gpl-2.0.html -Requires PHP: 5.3 - -The #1 (unofficial) Mailchimp plugin. Allows you to add various sign-up methods to your WordPress site. - -== Description == - -*Allowing your visitors to subscribe to your newsletter should be easy. With this plugin, it finally is.* - -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. - -[youtube https://www.youtube.com/watch?v=fZCYPnFybqU] - -#### Some (but not all) features - -- Connect with your Mailchimp account in seconds. - -- 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. - -- Seamless integration with the following plugins: - - Default WordPress Comment Form - - Default WordPress Registration Form - - Contact Form 7 - - WooCommerce - - Gravity Forms - - Ninja Forms 3 - - WPForms - - BuddyPress - - MemberPress - - Events Manager - - Easy Digital Downloads - - Give - - UltimateMember - - HTML Forms - - AffiliateWP - -- Is the plugin you want to integrate with not listed above? You can probably still use our [custom integration](https://www.mc4wp.com/kb/add-subscribe-checkbox-custom-form/) feature. Alternatively, the plugin comes with a PHP API to programmatically add a new subscriber to Mailchimp. - -- Send your WooCommerce orders to Mailchimp so you can see exactly what each subscriber purchased and how much revenue your email campaigns are generating. - -- A multitude of available add-on plugins and integrations: - - [Mailchimp for WordPress Premium](https://www.mc4wp.com/#utm_source=wp-plugin-repo&utm_medium=mailchimp-for-wp&utm_campaign=add-on-list) - - [Mailchimp Top Bar](https://wordpress.org/plugins/mailchimp-top-bar/) - - [Boxzilla Pop-ups](https://wordpress.org/plugins/boxzilla/) - - [WPBruiser anti-spam](https://wordpress.org/plugins/goodbye-captcha/) - -- Well documented through our [knowledge base](https://www.mc4wp.com/kb/). - -- Developer friendly. For some inspiration, check out our [repository of example code snippets](https://github.com/ibericode/mailchimp-for-wordpress/tree/master/sample-code-snippets). - -#### What is Mailchimp? - -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. - -If you are not yet using Mailchimp, [creating an account is 100% free and only takes you about 30 seconds](http://eepurl.com/igOGeX). - -== 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 API key](https://admin.mailchimp.com/account/api) in the plugin settings. - -#### Configuring Sign-Up Form(s) -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 form in pages or posts using the `[mc4wp_form]` shortcode or Gutenberg block. -5. Show a sign-up form in your widget areas using the "Mailchimp Sign-Up Form" widget. -6. Show a sign-up form from your theme files by using the `mc4wp_show_form()` PHP function. - -#### Need help? -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. - -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. - -== Frequently Asked Questions == - -#### Where can I find my Mailchimp API key? -You can [find your API key here](http://kb.mailchimp.com/accounts/management/about-api-keys#Find-or-Generate-Your-API-Key) - -#### How to display a form in posts or pages? -Use the `[mc4wp_form]` shortcode or the Gutenberg block. - -#### How to display a form in widget areas like the sidebar or footer? -Go to **Appearance > Widgets** and use the **Mailchimp for WP Form** widget that comes with the plugin. - -#### How to add a sign-up checkbox to my Contact Form 7 form? -Use the following shortcode in your CF7 form to display a newsletter sign-up checkbox. - -` -[mc4wp_checkbox "Subscribe to our newsletter?"] -` - -Our knowledge base has more information on [connecting Contact Form 7 and Mailchimp](https://www.mc4wp.com/kb/connecting-contact-form-7-and-mailchimp/). - -#### The form shows a success message but subscribers are not added to my list(s)? -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. - -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/). - -#### How can I style the sign-up form? -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. - -` -.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 */ -` - -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) - -#### How do I show a sign-up form in a pop-up? - -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. - -### How do I subscribe from my WooCommerce checkout form? - -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/). - -### How to connect my WooCommerce store with Mailchimp? - -You can find instructions for [connecting your WooCommerce store with Mailchimp](https://www.mc4wp.com/kb/connect-woocommerce-store-mailchimp/) on our website. - -#### I'm getting an "HTTP Error" when trying to connect to Mailchimp. - -the "HTTP Error" type is usually because of a firewall configuration issue or outdated software on your web server. - -Please contact your webhost and ask them to check the following: - -- Whether remote HTTP requests to `https://api.mailchimp.com` are allowed. -- Whether cURL and the PHP-cURL extension are installed and updated to a recent version. - -#### My question is not listed here. - -Please search through our [knowledge base](https://www.mc4wp.com/kb/#utm_source=wp-plugin-repo&utm_medium=mailchimp-for-wp&utm_campaign=faq). - - -== Other Notes == - -#### Support - -If you need some help in setting up the plugin, you have various options: - -- Search through our [knowledge base](https://www.mc4wp.com/kb/#utm_source=wp-plugin-repo&utm_medium=mailchimp-for-wp&utm_campaign=description). -- Open a topic in the [WordPress.org plugin support forums](https://wordpress.org/support/plugin/mailchimp-for-wp) -- If you're a premium user, send am email to the email address listed inside the plugin. - -#### Translations - -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. - -#### Development - -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). - -#### Customizing the plugin - -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/master/sample-code-snippets). - -== Screenshots == - -1. Example sign-up form in the TwentyTwenty theme. -2. Example sign-up integration with a contact form. -3. Settings page to connect with your Mailchimp account. -4. Overview of sign-up integrations. -5. Overview of sign-up forms. -6. Settings page to configure an integration. -7. Page where you edit your sign-up forms. -8. Page where you modify your form messages. - -== Changelog == +License: GPLv3 or later +License URI: http://www.gnu.org/licenses/gpl-2.0.html +Requires PHP: 5.3 + +The #1 Mailchimp plugin for WordPress. Allows you to add a multitude of newsletter sign-up methods to your site. + +== Description == + +*Allowing your visitors to subscribe to your newsletter should be easy. With this plugin, it finally is.* + +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. + +[youtube https://www.youtube.com/watch?v=fZCYPnFybqU] + +#### Some (but not all) features + +- Connect with your Mailchimp account in seconds. + +- 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. + +- Seamless integration with the following plugins: + - Default WordPress Comment Form + - Default WordPress Registration Form + - Contact Form 7 + - WooCommerce + - Gravity Forms + - Ninja Forms 3 + - WPForms + - BuddyPress + - MemberPress + - Events Manager + - Easy Digital Downloads + - Give + - UltimateMember + - HTML Forms + - AffiliateWP + +- Is the plugin you want to integrate with not listed above? You can probably still use our [custom integration](https://www.mc4wp.com/kb/add-subscribe-checkbox-custom-form/) feature. Alternatively, the plugin comes with a PHP API to programmatically add a new subscriber to Mailchimp. + +- Send your WooCommerce orders to Mailchimp so you can see exactly what each subscriber purchased and how much revenue your email campaigns are generating. + +- A multitude of available add-on plugins and integrations: + - [Mailchimp for WordPress Premium](https://www.mc4wp.com/#utm_source=wp-plugin-repo&utm_medium=mailchimp-for-wp&utm_campaign=add-on-list) + - [Mailchimp Top Bar](https://wordpress.org/plugins/mailchimp-top-bar/) + - [Boxzilla Pop-ups](https://wordpress.org/plugins/boxzilla/) + - [WPBruiser anti-spam](https://wordpress.org/plugins/goodbye-captcha/) + +- Well documented through our [knowledge base](https://www.mc4wp.com/kb/). + +- Developer friendly. For some inspiration, check out our [repository of example code snippets](https://github.com/ibericode/mailchimp-for-wordpress/tree/master/sample-code-snippets). + +- Ready for PHP 8.3, but backwards-compatible all the way down to PHP 5.6. + +#### What is Mailchimp? + +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. + +If you are not yet using Mailchimp, [creating an account is 100% free and only takes you about 30 seconds](http://eepurl.com/igOGeX). + +== 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 API key](https://admin.mailchimp.com/account/api) in the plugin settings. + +#### Configuring Sign-Up Form(s) +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 form in pages or posts using the `[mc4wp_form]` shortcode or Gutenberg block. +5. Show a sign-up form in your widget areas using the "Mailchimp Sign-Up Form" widget. +6. Show a sign-up form from your theme files by using the `mc4wp_show_form()` PHP function. + +#### Need help? +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. + +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. + +== Frequently Asked Questions == + +#### Where can I find my Mailchimp API key? +You can [find your API key here](http://kb.mailchimp.com/accounts/management/about-api-keys#Find-or-Generate-Your-API-Key) + +#### How to display a form in posts or pages? +Use the `[mc4wp_form]` shortcode or the Gutenberg block. + +#### How to display a form in widget areas like the sidebar or footer? +Go to **Appearance > Widgets** and use the **Mailchimp for WP Form** widget that comes with the plugin. + +#### How to add a sign-up checkbox to my Contact Form 7 form? +Use the following shortcode in your CF7 form to display a newsletter sign-up checkbox. + +` +[mc4wp_checkbox "Subscribe to our newsletter?"] +` + +Our knowledge base has more information on [connecting Contact Form 7 and Mailchimp](https://www.mc4wp.com/kb/connecting-contact-form-7-and-mailchimp/). + +#### The form shows a success message but subscribers are not added to my list(s)? +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. + +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/). + +#### How can I style the sign-up form? +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. + +` +.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 */ +` + +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) + +#### How do I show a sign-up form in a pop-up? + +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. + +### How do I subscribe from my WooCommerce checkout form? + +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/). + +### How to connect my WooCommerce store with Mailchimp? + +You can find instructions for [connecting your WooCommerce store with Mailchimp](https://www.mc4wp.com/kb/connect-woocommerce-store-mailchimp/) on our website. + +#### I'm getting an "HTTP Error" when trying to connect to Mailchimp. + +the "HTTP Error" type is usually because of a firewall configuration issue or outdated software on your web server. + +Please contact your webhost and ask them to check the following: + +- Whether remote HTTP requests to `https://api.mailchimp.com` are allowed. +- Whether cURL and the PHP-cURL extension are installed and updated to a recent version. + +#### My question is not listed here. + +Please search through our [knowledge base](https://www.mc4wp.com/kb/#utm_source=wp-plugin-repo&utm_medium=mailchimp-for-wp&utm_campaign=faq). + + +== Other Notes == + +#### Support + +If you need some help in setting up the plugin, you have various options: + +- Search through our [knowledge base](https://www.mc4wp.com/kb/#utm_source=wp-plugin-repo&utm_medium=mailchimp-for-wp&utm_campaign=description). +- Open a topic in the [WordPress.org plugin support forums](https://wordpress.org/support/plugin/mailchimp-for-wp) +- If you're a premium user, send am email to the email address listed inside the plugin. + +#### Translations + +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. + +#### Development + +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). + +#### Customizing the plugin + +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/master/sample-code-snippets). + +== Screenshots == + +1. Example sign-up form in the TwentyTwenty theme. +2. Example sign-up integration with a contact form. +3. Settings page to connect with your Mailchimp account. +4. Overview of sign-up integrations. +5. Overview of sign-up forms. +6. Settings page to configure an integration. +7. Page where you edit your sign-up forms. +8. Page where you modify your form messages. + +== Changelog == #### 4.9.7 - Aug 29, 2023 @@ -234,7 +236,7 @@ The plugin provides various filter and action hooks that allow you to modify or - When renewing lists, renew cached marketing permissions too. -#### 4.9.0 - Jan 13, 2023 +#### 4.9.0 - Jan 13, 2023 - Removed deprecated filter hook `mc4wp_settings_cap`, use `mc4wp_admin_required_capability` instead. - Removed deprecated filter hook `mc4wp_merge_vars`, use `mc4wp_form_data` or `mc4wp_integration_data` instead. @@ -1799,8 +1801,8 @@ Minor improvements and additions for compatibility with the [Mailchimp User Sync - Added sign-up checkbox integration for [Easy Digital Downloads](https://wordpress.org/plugins/easy-digital-downloads/) checkout. - The entered email will now be appended to the URL when redirecting to another page -== Upgrade Notice == - -= 3.0.3 = - -Minor improvements and re-added support for Goodbye Captcha integration. +== Upgrade Notice == + += 3.0.3 = + +Minor improvements and re-added support for Goodbye Captcha integration.