外掛說明
WP WooCommerce Mailchimp provides simple and flexible Mailchimp integration for WooCommerce.
Automatically subscribe customers to a designated Mailchimp list and, optionally, Mailchimp interest groups and tags upon order creation or order completion.
This can be done quietly or based on the user’s consent with several opt-in settings that support international opt-in laws.
Upgrade to WP WooCommerce Mailchimp Pro for more advanced features including WooCommerce Subscriptions support and the ability to set product-specific lists, groups and tags.
Features
WooCommerce Event Selection
- Subscribe customers to Mailchimp after order creation
- Subscribe customers to Mailchimp after order processing
- Subscribe customers to Mailchimp after order completion
Works with Mailchimp Interest Groups and Tags
- Set one or more interest groups to add users to based on the selected Mailchimp list.
- Set one or more tags to add users to based on the selected Mailchimp list.
Opt-In Settings
- MailChimp double opt-in support (control whether a double opt-in email is sent to the customer)
- Optionally, display an opt-in checkbox on the checkout page (this is required in some countries)
- Control the label displayed next to the opt-in checkbox
- Control whether or not the opt-in checkbox is checked or unchecked by default
- Control the placement of the opt-in checkbox on the checkout page
Translation Support
Would you like to help translate the plugin into more languages? Join our Translations Community at https://translate.wordpress.org/projects/wp-plugins/woocommerce-mailchimp.
WooCommerce Mailchimp translation is managed through WordPress language packs here: https://translate.wordpress.org. This allows WooCommerce Mailchimp to be translated into other languages. The preferred tool for translating plugins is called GlotPress. You can read about how GlotPress works in the WordPress Translator’s Handbook.
Thanks in advance for your help on any translation efforts!
We also support bundled translations via:
- Included woocommerce-mailchimp.pot file
- WPML support via wpml-config.xml
Included Translations:
- English (US) (default)
- French.
Custom Translations
If you don’t want to use WordPress language packs or bundled translations, you can use your own custom translations.
- Place custom translations in
/wp-content/languages/woocommerce-mailchimp/woocommerce-mailchimp_{lang}_{country}.mo
. This ensures they won’t get overwritten by plugin updates.
Translation Loading
If no custom translations are present, languages will be loaded in the following order:
- From WordPress language packs in:
/wp-content/languages/plugins/woocommerce-mailchimp/woocommerce-mailchimp_{lang}_{country}.mo
- From the plugin bundled in:
/wp-content/plugins/woocommerce-mailchimp/languages/woocommerce-mailchimp_{lang}_{country}.mo
Multisite
- All features should work for each blog in multisite installations.
Requirements
WP WooCommerce Mailchimp requires PHP 5.6+ (PHP 7.0+ recommended). You’ll also need to be running WordPress 4.7.0+ and have WooCommerce 3.5.0+.
Documentation & Support
Online documentation and code samples are available via our Help Center.
Please visit the
WP WooCommerce MailChimp support forum on WordPress.org for basic support and help from other users. Since this is a free plugin, we respond to these as we have time.
Dedicated support will is available for WP WooCommerce MailChimp Pro customers.
Contribute
All development for WP WooCommerce MailChimp is handled via GitHub. Opening new issues and submitting pull requests are welcome.
Our public roadmap is available on Trello. We’d love it if you vote and comment on your favorite ideas.
You can also keep up to date with WooCommerce MailChimp Pro development by subscribing to our newsletter.
Also, if you enjoy using the software we’d love it if you could give us a review!
螢幕擷圖
安裝方式
- Upload or extract the
woocommerce-mailchimp
folder to your site’s/wp-content/plugins/
directory. You can also use the *Add new- option found in the *Plugins- menu in WordPress. - Enable the plugin from the *Plugins- menu in WordPress.
Usage
- Go to WooCommerce > Settings > Mailchimp
- First, paste your MailChimp API Key to get started.
- Select whether you want customers to be subscribed to your Mailchimp list after order creation, order processing or order completion (there’s a difference in WooCommerce).
- Next, select your Mailchimp list and select any interest groups (optional).
- Select your opt-in, double opt-in settings and hit
Save changes
. - That’s it, your WooCommerce store is now integrated with Mailchimp!
使用者評論
參與者及開發者
變更記錄
2.4.14 – Sep 5, 2024
- Bump WC tested version up to 9.2.3.
- Bump WP tested version up to 6.6.1.
2.4.13 – Apr 11, 2024
- Bump WC tested version up to 8.7.0.
- Bump WP tested version up to 6.5.2.
2.4.12 – Aug 10, 2023
- Support for WooCommerce HPOS (High Performance Order Storage).
- Bump WC tested version up to 8.0.1.
- Bump WP tested version up to 6.3.
2.4.11 – Jul 20, 2023
- PHP 8+ exception bug fix – check if array key exists.
2.4.10 – Jul 19, 2023
- Bump WC tested version up to 7.9.0.
- Bump WP tested version up to 6.2.2.
2.4.9 – Mar 10, 2022
- Bug fix for to check for WP_Error.
2.4.8 – Oct 12, 2021
- Bug fix for tags not passing to Mailchimp.
2.4.7 – Oct 6, 2021
- Update to pass skip_merge_validation argument when subscribing users.
2.4.6 – Oct 5, 2021
- Enhance error logging.
2.4.5 – Oct 5, 2021
- Only send merge fields if not empty.
- Bump WC tested version up to 5.7.1.
- Bump WP tested version up to 5.8.1.
2.4.4 – May 26, 2021
- Fix typo.
2.4.3 – May 26, 2021
- Replace extract with explicit retrieval.
2.4.2 – May 24, 2021
- Tested up to WordPress 5.7.2
- Tested up to WooCommerce 5.3.0
2.4.1 – March 27, 2021
- Added new
ss_wc_mailchimp_subscribe_customer
hook to allow easier override of whether or not to subscribe the customer.
2.4.0 – March 24, 2021
- Tested up to WordPress 5.7
- Tested up to WooCommerce 5.1
2.3.13 – January 5, 2021
- Bump WP and WC tested versions.
- Fix for category interests not returning (issue #29)
2.3.12 – April 14, 2020
- Remove explicit private variable to fix integration issue with Aero Checkout.
2.3.11 – April 8, 2020
- Tested up to WordPress 5.4
- Tested up to WooCommerce 4.0.1
2.3.10 – March 3, 2020
- Increase API return limit count to 500.
- Tested up to WooCommerce 3.9.2
2.3.9 – February 1, 2020
- Fix for migration version detection.
2.3.8 – February 1, 2020
- Fix for array_map (Issue #26)
- Tested up to WordPress 5.3.2 (Issue #28)
- Tested up to WooCommerce 3.9.1 (Issue #27)
2.3.7 – October 31, 2019
- Fix for opt-in checkbox not displaying.
2.3.6 – October 30, 2019
- Fix json encode.
2.3.5 – October 30, 2019
- WordPress coding standards updates.
2.3.4 – October 29, 2019
- Change plugin display name.
- Sanitize post data.
2.3.3 – August 29, 2019
- Fix ActionScheduler 2.2.5 version.
2.3.2 – August 27, 2019
- Upgrade ActionScheduler to 2.2.5
- Fix encoding of unicode/international characters.
2.3.1 – August 26, 2019
- Fix tag retrieval to return tag IDs.
- Fix migrations.
- Tested up to WooCommerce 3.7.0
2.3.0 – July 25, 2019
- Added support for tags on main list.
- Improved integration with WooCommerce Mailchimp Pro.
2.2.0 – July 23, 2019
- Bump min WC version to 3.5.0, and min WP version to 4.7.0.
- Bump min PHP version to 5.6 in prep for WooCoommerce 3.7 requirements.
2.1.21 – July 23, 2019
- Prep for getting list tags.
2.1.20 – July 22, 2019
- Bump plugin version and min WP and WC tested versions.
2.1.19 – February 15, 2019
- Update styling of opt-in checkbox.
2.1.18 – February 15, 2019
- Add subscribe_customer param to before/after subscribe hooks.
- Use new logging action for logging.
- Update tested to WP 5.1
2.1.17 – February 14, 2019
- Allow html (hyperlinks, etc.) in Opt-In Field Label.
2.1.16 – February 5, 2019
- Force plugin version update. WordPress.org not registering the 2.1.15 release.
2.1.15 – February 5, 2019
- Fix fatal error.
2.1.14 – February 5, 2019
- Fix MailChimp interest group limit
2.1.13 – January 29, 2019
- WooCommerce tested up to 3.5.4
- WP tested up to 5.0.3
2.1.12 – May 22, 2018
- WPML Opt-in label fix.
- Plugin now loads after
plugins_loaded
action hook.
2.1.11 – April 27, 2018
- Fix erroneous error saying can’t load lists when no interest groups for list.
2.1.10 – February 12, 2018
- Added WooCommerce tested up to header
2.1.9 – February 1, 2018
- Added new opt-in checkbox location for order review above cart/product table.
2.1.8 – February 1, 2018
- Fix “Invalid argument supplied for foreach” warning in settings (Issue #21)
2.1.6 – January 26, 2018
- Restore opt-in checkbox location and add params to filter to allow easier adjustment of its placement.
2.1.5 – January 25, 2018
- Move opt-in checkbox before associated label
2.1.4 – December 20, 2017
- Tested up to WordPres 4.9.1
2.1.3 – December 19, 2017
- Small fix to show MailChimp API error message in UI.
2.1.2 – August 25, 2017
- Fix retrieval of mailchimp lists with numeric ids.
2.1.1 – July 24, 2017
- Fix settings default for older PHP versions.
2.1.0 – April 26, 2017
- Added support for WooCommerce 3.0 changes.
- Added additional options for opt-in checkbox placement.
2.0.20 – February 1, 2017
- Added
woocommerce_mailchimp_admin_email
filter to allow hooking into and overriding email where error messages are sent (defaults toget_option( 'admin_email' )
).
IMPORTANT: You must upgrade to version 2.X by December 31, 2016 as prior versions of the MailChimp API will stop working at that point.
2.0.19 – October 4, 2016
- Fix to not send double opt-in email to existing subscribers.
2.0.18 – September 23, 2016
- Fix for array_filter not working with lamda for some users.
2.0.15 – 2.0.17 – September 22, 2016
- Fix for activation error running migrations.
- Double opt-in fix.
- Added additional hooks and filters.
- Code cleanup.
2.0.13 – 2.0.14 – September 20, 2016
- Added plugin compatibility checks for minimum supported versions of WooCommerce, WordPress and PHP.
- Added explicit plugin directory to require_once calls.
2.0.9 – 2.0.12 – September 19, 2016
- Small fix for double-loading of lists on api key change.
- Small fix for lists not loading after initial save on new installs.
- Small fix for new installs not loading interest groups.
- Removed functions.php file (no longer used).
2.0.7 – 2.0.8 – September 17, 2016
- Fix for new installs to prevent trying to run upgrade process.
- Small fix to not end WooCommerce Settings section with no api key or list is present.
2.0 – 2.0.6 – September 16, 2016
WARNING: This release contains breaking changes to the plugin’s action hooks and filters. If you have custom code that hooks into the plugins action hooks and filters, please review the breaking changes below to know how to update your code appropriately.
Breaking Changes
- Action filter
ss_wc_mailchimp_subscribe_merge_vars
is nowss_wc_mailchimp_subscribe_merge_tags
- The filter no longer contains the
GROUPINGS
sub-key for MailChimp Groups due to a change with the MailChimp API v3.0. - The filter now only contains the MailChimp Merge Tags.
- The filter no longer contains the
- MailChimp Groups now have their own action filter
ss_wc_mailchimp_subscribe_interest_groups
- Action filter
ss_wc_mailchimp_subscribe_options
has changed due to changes with the MailChimp API v3.0.- The key
listid
has been changed tolist_id
in the$subscribe_options
parameter - The
vars
key has been removed from the$subscribe_options
parameter (this key previously contained the merge tags and groups together). - The
update_existing
,replace_interests
andsend_welcome
keys have been removed from the$subscribe_options
parameter since they are no longer supported by the API. - The plugin now always updates existing subscribers if they exist.
- The plugin now always appends interest groups and does not affect existing groups on subscribers.
- The send welcome email can be configured on the target list and is not required to be sent through the API.
- A new key
merge_tags
has been added and includes the$merge_tags
array to be sent to the MailChimp API - A new key
interest_groups
has been added and includes the$interest_groups
array to be sent to the MailChimp API
- The key
Improvements
- Added ability to pick MailChimp Interest Groups from drop-down list.
- Upgraded MailChimp API to v3.0
Additions
- Added
Debug Log
setting to enable/disable logging for troubleshooting purposes. - Added
System Info
setting for troubleshooting purposes. - New action hook
ss_wc_mailchimp_loaded
fired after the plugin has loaded. - New action hook
ss_wc_mailchimp_before_opt_in_checkbox
fired before opt in checkbox is rendered. - New action filter
ss_wc_mailchimp_opt_in_checkbox
allows for overriding opt in checkbox rendering - New action hook
ss_wc_mailchimp_after_opt_in_checkbox
fired after opt in checkbox is rendered.
Fixes
- Fixed issues with translations and text domains not loading properly.
- Change
list
function toget_list
to prevent PHP error - Fix issues with PHP version < 5.5
1.3.9 – September 13, 2016
Fixes
- Rename MCAPI class to prevent collisions with other plugins.
1.3.8 – September 9, 2016
Improvements
- Tested up to WordPress 4.6.1
- Tested up to WooCommerce 2.6.4
- More flexible opt_in checkbox placement
- Pass $order_id to
ss_wc_mailchimp_subscribe_options
hook
Fixes
- Use only one instance of MCAPI
- Fixed Issue #14 MCAPI constructor style
- Fixed Issue #15
mailchimp_api_error_msg
- Fixed Issue #16 where lists wouldn’t show up until you saved the settings twice
1.3.7 – December 16, 2015
Improvements
- WordPress 4.4 Compatible
- WooCommerce 2.4.12 Compatible
Fixes
- API response not shown in debug log
- Use only one instance of MCAPI
1.3.6 – February 9, 2015
Fixes
- Backout of change to use WC_Logger due to fatal error
1.3.5 – February 6, 2015
Improvements
- Change to use WC_Logger instead of error_log
- Updated pot file
- Added French translation
- General code syntax cleanup
Fixes
- Fix for undefined variable list and array_merge issue.
1.3.3 & 1.3.4 – January 16, 2016
Fixes
- Fix enabled check. Issue #6.
- Fix for transient key length.
Improvements
- Tested with WordPress 4.1
1.3.2 – November 4, 2014
**Fixes*
- Fix for headers already sent message. Tested with WordPress 4.0 and WooCommerce 2.2.*
1.3.1 – April 3, 2014
Fixes
- Fix for MailChimp merge vars bug introduced in v1.3
1.3 – April 1, 2014
Breaking Changes
- Action filer
ss_wc_mailchimp_subscribe_merge_vars
now passes $order_id param to enable retrieving additional order info/meta to use in MailChimp merge vars
Fixes
- Small fix to order_created subscribe event to work with PayPal Payment Gateway
1.2.6 – February 28, 2014
Improvements
- Added additional debug logging when WP_DEBUG is enabled
1.2.5 – February 27, 2014
Fixes
- Bug fix for subscribe when not using opt-in display field
1.2.2, 1.2.3 & 1.2.4 – February 22, 2014
Fixes
- WooCommerce 2.1 fix for order custom fields
- Fixed plugin settings link for WooCommerce 2.1
- Bug fix for subscribe
1.2.1 – February 13, 2014
Improvements
- WooCommerce 2.1 integration: Change to use wc_enqueue_js instead of add_inline_js
- WooCommerce 2.1 integration: Change to support new default checkout field filter for default opt-in checkbox status
1.2 – January 10, 2014
Improvements
- Added new setting to control whether or not the double opt-in checkbox is checked/unchecked by default on the checkout page.
- Added new setting to control display location of the double opt-in checkbox (under billing info or order info)
- Small modification to append to MailChimp interest groups for existing users so that group settings are not lost for users who were already subscribed.
- Preparations for i18n (Internationalization) support. Several users have already asked and offered to translate the plugin into other languages. We had always planned on that, but now are making that a reality.
1.1.2 & 1.1.3 – January 2, 2014
Fixes
- Update to REALLY address issue with subscriptions not occurring on order create “pending”
Additions
- Minor action hook change since order meta (needed for MailChimp API call) is not yet available on ‘woocommerce_new_order’ hook
– January 2, 2014
1.1.1 – December 31, 2013
Fixes
- Update to address issue with subscriptions not occurring on order create “pending”
1.1 – November 12, 2013
Improvements
- Add the option to display an opt-in field on checkout
1.0.2 – October 16, 2013
Additions
- Minor text and comment changes
1.0.1 – October 11, 2013
Improvements
- Added “Settings” link on the Plugins administration screen
1.0 – October 10, 2013
- This is the first public release.