Add support for Mailchimp webhooks to enable 2-way synchronizing.<\/p>"},"ratings":{"1":0,"2":"1","3":0,"4":0,"5":"17"},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":"1224634","resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":"1224634","resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-772x250.jpg":{"filename":"banner-772x250.jpg","revision":"1092151","resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.1.1","0.1.2","1.0","1.0.2","1.1","1.1.1","1.1.3","1.2","1.2.1","1.2.2","1.2.3","1.3","1.3.1","1.3.2","1.3.3","1.4","1.4.1","1.4.2","1.4.3","1.4.4","1.4.5","1.4.6","1.4.7","1.5","1.5.1","1.5.2","1.5.3","1.5.4","1.6","1.6.1","1.6.2","1.6.3","1.6.4","1.7","1.7.1","1.7.2","1.7.3","1.7.4","1.7.5","1.7.6","1.7.7","1.8.0","1.8.1"],"block_files":[],"assets_screenshots":{"screenshot-1.jpg":{"filename":"screenshot-1.jpg","revision":"1074752","resolution":"1","location":"assets","locale":""},"screenshot-2.jpg":{"filename":"screenshot-2.jpg","revision":"1074752","resolution":"2","location":"assets","locale":""}},"screenshots":{"1":"Synchronization settings","2":"Status overview"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[1029,41874,1558,9756,1917],"plugin_category":[41,45],"plugin_contributors":[77662,77663,77661,77664],"plugin_business_model":[],"class_list":["post-34150","plugin","type-plugin","status-closed","hentry","plugin_tags-mailchimp","plugin_tags-mailchimp-list","plugin_tags-sync","plugin_tags-synchronize","plugin_tags-users","plugin_category-communication","plugin_category-ecommerce","plugin_contributors-dvankooten","plugin_contributors-hchouhan","plugin_contributors-ibericode","plugin_contributors-lapzor","plugin_committers-dvankooten","plugin_committers-hchouhan","plugin_committers-ibericode"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/mailchimp-sync_cfeefa.svg","icon_2x":false,"generated":true},"screenshots":[{"src":"https:\/\/ps.w.org\/mailchimp-sync\/assets\/screenshot-1.jpg?rev=1074752","caption":"Synchronization settings"},{"src":"https:\/\/ps.w.org\/mailchimp-sync\/assets\/screenshot-2.jpg?rev=1074752","caption":"Status overview"}],"raw_content":"\n
Synchronize your registered WordPress users with a Mailchimp list of your choice.<\/p>\n\n
\nTo use Mailchimp User Sync, please install either the free or premium version of the Mailchimp for WordPress plugin<\/a>.<\/p>\n<\/blockquote>\n\n
MC4WP: User Sync, at a glance..<\/h4>\n\n
Mailchimp User Sync will monitor your WordPress user base and automatically synchronize any changes with a selected Mailchimp list. This allows you to keep a Mailchimp list of subscribers\nthat is an exact mirror of your WordPress user base.<\/p>\n\n
\n
- Automatically subscribe new users to your Mailchimp list.<\/li>\n
- Sync all profile changes with Mailchimp, even when a user's email address changes.<\/li>\n
- When a user is deleted, the associated Mailchimp subscriber will be unsubscribed as well.<\/li>\n
- Synchronize all user roles or a specific one, eg all users with the \"customer\" role.<\/li>\n
- Synchronize all existing users<\/li>\n
- Choose whether you want to use double opt-in and send a welcome email to new subscribers.<\/li>\n
- WP CLI commands to synchronize a large amount of WordPress users at once.<\/li>\n<\/ul>\n\n
After activation, the plugin will listen to all changes in your WordPress users and make sure everything stays in sync with the selected Mailchimp list.<\/p>\n\n
Development of Mailchimp User Sync<\/h4>\n\n
Bug reports (and Pull Requests) for Mailchimp User Sync are welcomed on GitHub<\/a>. Please note that GitHub is not<\/em> a support forum.<\/p>\n\n
More information<\/strong><\/p>\n\n
\n
- Mailchimp for WordPress<\/a><\/li>\n
- Other add-ons for Mailchimp for WordPress<\/a><\/li>\n
- Developers; follow or contribute to the Mailchimp User Sync plugin on GitHub<\/a><\/li>\n
- Other WordPress plugins<\/a> by Danny van Kooten<\/a><\/li>\n<\/ul>\n\n\n
Mailchimp for WordPress<\/h4>\n\n
Since this plugin depends on the Mailchimp for WordPress plugin<\/a>, you will need to install that first.<\/p>\n\n
Installing Mailchimp User Sync<\/h4>\n\n
\n
- Make sure Mailchimp for WordPress<\/a> is installed (free or premium).<\/li>\n
- In your WordPress admin panel, go to Plugins > New Plugin<\/em>, search for Mailchimp User Sync<\/strong> and click \"Install now<\/em>\"<\/li>\n
- Alternatively, download the plugin and upload the contents of
mailchimp-sync.zip<\/code> to your plugins directory, which usually is\/wp-content\/plugins\/<\/code>.<\/li>\n- Activate the plugin<\/li>\n
- Set your Mailchimp API key<\/a> in Mailchimp for WP > Mailchimp Settings<\/strong>.<\/li>\n
- Select a list to sync with in Mailchimp for WP > Sync<\/strong>.]<\/li>\n
- (optional) Select a specific user role to synchronize.<\/li>\n
- (optional) synchronize your existing users.<\/li>\n<\/ol>\n\n\n
\n
- I think I found a bug. What now?<\/dt>\n
Please report it on GitHub issues<\/a> if it's not in the list of known issues.<\/p><\/dd>\n
- I have another question<\/dt>\n
Please open a topic on the WordPress.org plugin support forums<\/a>.<\/p><\/dd>\n
- Send additional fields to Mailchimp<\/dt>\n
Since version 1.1, you can specify which additional user fields to send to Mailchimp by mapping your fields on the settings page of the plugin.<\/p>\n\n
If you need to send more complex data you can use the
mailchimp_sync_user_data<\/code> filter.<\/p>\n\nadd_filter( 'mailchimp_sync_user_data', function( $data, $user ) {\n $data['WEBSITE'] = $user->user_url;\n return $data;\n}, 10, 2 );\n<\/code><\/pre><\/dd>\n- Only synchronize users based on a custom criteria<\/dt>\n
You can set your own criteria for subscribing a user by hooking into the
mailchimp_sync_should_sync_user<\/code> filter.<\/p>\n\nadd_filter( 'mailchimp_sync_should_sync_user', function( $subscribe, $user ) {\n\n \/\/ check for custom user field\n if( $user->subscribe_me ) {\n return true;\n }\n\n \/\/ do not subscribe otherwise\n return false;\n});\n<\/code><\/pre><\/dd>\n- Can I run this from the command-line?<\/dt>\n
Yes, you can. The plugin registers two WP CLI<\/a> commands.<\/p>\n\n
wp mailchimp-sync all # synchronize all users\nwp mailchimp-sync all --role=administrator # synchronize all users with \"administrator\" role\nwp mailchimp-sync user $user_id # synchronize the user specified by the given ID\n<\/code><\/pre>\n\nThis is especially useful for synchronising a huge amount of users.<\/p><\/dd>\n
- Does this plugin synchronize data back from Mailchimp?<\/dt>\n
Not by default, but you can enable this by configuring a webhook in your Mailchimp account<\/a>.<\/p><\/dd>\n\n<\/dl>\n\n\n
1.8.1 - Oct 15, 2019<\/h4>\n\n
Improvements<\/strong><\/p>\n\n
\n
- Add button to delete all pending background jobs.<\/li>\n<\/ul>\n\n
1.8.0 - Oct 7, 2019<\/h4>\n\n
Compatibility with Mailchimp for WordPress<\/a> version 4.6.<\/p>\n\n
1.7.6 - Dec 3, 2018<\/h3>\n\n
Improvements<\/strong><\/p>\n\n
\n
- Add warning text to settings that may cause subscribers to be removed from the connected Mailchimp list.<\/li>\n<\/ul>\n\n
1.7.5 - July 4, 2018<\/h3>\n\n
Improvements<\/strong><\/p>\n\n
\n
- Get rid of status indicator on settings page as it's not important nor accurate.<\/li>\n<\/ul>\n\n
Additions<\/strong><\/p>\n\n
\n
- Add button to settings page to immediately process all pending background jobs.<\/li>\n<\/ul>\n\n
1.7.4 - May 28, 2018<\/h3>\n\n
Additions<\/strong><\/p>\n\n
\n
- Added mailchimp_sync_delete_subscribers filter, will delete subscribers from the Mailchimp list<\/a> if filter returns true (instead of updating their status).<\/li>\n<\/ul>\n\n
1.7.3 - April 30, 2018<\/h3>\n\n
Improvements<\/strong><\/p>\n\n
\n
- Allow users that unsubscribed to be re-subscribed, but only if users can manage their sign-up status from their profile page.<\/li>\n
- Better (more privacy friendly) default settings.<\/li>\n
- Add warning text to settings that may affect GDPR compliance.<\/li>\n
- CLI commands shows a list of errors now (if any).<\/li>\n
- More detailed error messages when Mailchimp API returns an error.<\/li>\n<\/ul>\n\n
1.7.2 - March 14, 2018<\/h3>\n\n
Fixes<\/strong><\/p>\n\n
\n
- Fatal error because of unexisting function on WooCommerce my account page.<\/li>\n<\/ul>\n\n
1.7.1 - March 13, 2018<\/h3>\n\n
Fixes<\/strong><\/p>\n\n
\n
- Manual synchronization would not stop running if errors occurred.<\/li>\n
- Fix hooks like
mailchimp_sync_handle_user<\/code>.<\/li>\n<\/ul>\n\nAdditions<\/strong><\/p>\n\n
\n
- Allow users to subscribe\/unsubscribe from their WooCommerce account page too.<\/li>\n<\/ul>\n\n
1.7 - February 16, 2018<\/h4>\n\n
Fixes<\/strong><\/p>\n\n
\n
- Incorrect total user count when running the plugin on WP Multsite.<\/li>\n<\/ul>\n\n
Improvements<\/strong><\/p>\n\n
\n
- Do not hard-delete subscribers, update status instead.<\/li>\n<\/ul>\n\n
1.6.4 - December 12, 2017<\/h4>\n\n
Improvements<\/strong><\/p>\n\n
\n
- Transactional (e-commerce) subscribers would not be subscribed when synchronising.<\/li>\n<\/ul>\n\n
1.6.3 - December 4, 2017<\/h4>\n\n
Fixes<\/strong><\/p>\n\n
\n
- Last few users were always skipped when performing a manual sync (via browser).<\/li>\n<\/ul>\n\n
Improvements<\/strong><\/p>\n\n
\n
- Allow processing pending background jobs by visiting any admin page with
?_mc4wp_action=process_user_sync_queue<\/code> as an administrator.<\/li>\n- Get rid of PHP notice on user profile page.<\/li>\n<\/ul>\n\n
1.6.2 - November 22, 2017<\/h4>\n\n
Fixes<\/strong><\/p>\n\n
\n
- CLI command would not find any users when synchronising all user roles.<\/li>\n<\/ul>\n\n
Improvements<\/strong><\/p>\n\n
\n
- Improved success messages in CLI commands.<\/li>\n<\/ul>\n\n
1.6.1 - November 21, 2017<\/h4>\n\n
Fixes<\/strong><\/p>\n\n
\n
- Invalid class reference in WP CLI command.<\/li>\n<\/ul>\n\n
1.6 - November 2, 2017<\/h4>\n\n
Additions<\/strong><\/p>\n\n
\n
- Added setting that allows users to opt-out from selected Mailchimp list via their profile page.<\/li>\n<\/ul>\n\n
Improvements<\/strong><\/p>\n\n
\n
- Minor refactoring & improvements to log messages.<\/li>\n<\/ul>\n\n
1.5.4 - May 23, 2017<\/h4>\n\n
Fixes<\/strong><\/p>\n\n
\n
- Interest groupings not coming through when using
mailchimp_sync_subscriber_data<\/code> filter hook.<\/li>\n<\/ul>\n\nImprovements<\/strong><\/p>\n\n
\n
- Queued background jobs are now only processed at the hourly schedule.<\/li>\n<\/ul>\n\n
Additions<\/strong><\/p>\n\n
\n
- Added
mc4wp-sync process-queue<\/code> command to WP CLI.<\/li>\n<\/ul>\n\n1.5.3 - January 18, 2017<\/h4>\n\n
Fixes<\/strong><\/p>\n\n
\n
- Pending subscribers (when double opt-in is enabled) would be subscribed again on every profile change.<\/li>\n<\/ul>\n\n
Improvements<\/strong><\/p>\n\n
\n
- Plugin can now update email addresses in Mailchimp without creating a separate (new) subscriber. Thanks to Maymay<\/a> for the great help.<\/li>\n
- Now showing pending background jobs on settings page.<\/li>\n
- Background queue improvements for long-lived processes<\/li>\n
- Errors in background jobs will now be logged to the debug log<\/a>.<\/li>\n
- Reschedule event whenever options are saved.<\/li>\n<\/ul>\n\n
1.5.2 - September 28, 2016<\/h4>\n\n
Fixes<\/strong><\/p>\n\n
\n
- Interest groups were always being replaced, instead of added to the existing subscriber's interest groups.<\/li>\n<\/ul>\n\n
Improvements<\/strong><\/p>\n\n
\n
- Always write to debug log when webhook receives request for user.<\/li>\n<\/ul>\n\n
Additions<\/strong><\/p>\n\n
\n
- Added
mailchimp_sync_webhook_data<\/code> filter to manipulate data received by webhook before it is processed.<\/li>\n<\/ul>\n\n1.5.1 - September 7, 2016<\/h4>\n\n
Fixes<\/strong><\/p>\n\n
\n
- Don't delay other cron jobs when an error occurs.<\/li>\n<\/ul>\n\n
Improvements<\/strong><\/p>\n\n
\n
- Only send user fields to Mailchimp when not empty, to prevent overriding existing data when webhook is not configured.<\/li>\n
- Ask for confirmation before changing webhook secret.<\/li>\n<\/ul>\n\n
1.5 - August 4, 2016<\/h4>\n\n
Improvements<\/strong><\/p>\n\n
\n
- Forward compatibility with upcoming Mailchimp for WordPress 4.0 release<\/a>.<\/li>\n
- Use correct WP function for updating user email address from webhook.<\/li>\n<\/ul>\n\n
1.4.7 - July 8, 2016<\/h4>\n\n
Fixes<\/strong><\/p>\n\n
\n
- Incorrect user count resulting in lots of duplicate \"Fetched 0 users\" statements in Manual Synchronization wizard.<\/li>\n<\/ul>\n\n
Improvements<\/strong><\/p>\n\n
\n
- Various improvements to Manual Synchronization wizard, including more verbose feedback.<\/li>\n
- Add link to KB article for synchronizing additional fields<\/a>.<\/li>\n<\/ul>\n\n
1.4.6 - June 14, 2016<\/h4>\n\n
Fixes<\/strong><\/p>\n\n
\n
- Webhook not updating user fields because it couldn't find an associated user.<\/li>\n<\/ul>\n\n
Additions<\/strong><\/p>\n\n
\n
- Added webhook settings to settings page.<\/li>\n
- Added \"secret key\" option to webhook, to further secure webhook endpoint.<\/li>\n
- Preparations for Mailchimp API v3.<\/li>\n<\/ul>\n\n
1.4.5 - May 25, 2016<\/h4>\n\n
Fixes<\/strong><\/p>\n\n
\n
- Error on PHP 5.3. Square bracket array assignment is a PHP 5.4 feature.<\/li>\n<\/ul>\n\n
1.4.4 - May 25, 2016<\/h4>\n\n
Fixes<\/strong><\/p>\n\n
\n
- Only add Mailchimp status to user profile when user matches criteria.<\/li>\n
- CLI command now defaults to role selected on settings page when no role argument given.<\/li>\n<\/ul>\n\n
Improvements<\/strong><\/p>\n\n
\n
- Show success notice when manually subscribing or updating a user.<\/li>\n
- Show \"skipped\" message when wizard attempts to synchronize a user that is excluded by the
mailchimp_sync_should_sync_user<\/code> filter.<\/li>\n- Show notice that numbers are off when using
mailchimp_sync_should_sync_user<\/code> filter.<\/li>\n- Various UX improvements to settings page & manual synchronization wizard.<\/li>\n
- Various performance improvements.<\/li>\n<\/ul>\n\n
1.4.3 - April 13, 2016<\/h4>\n\n
Improvements<\/strong><\/p>\n\n
\n
- When user switches role or no longer matches custom conditions (using the
mailchimp_sync_should_sync_user<\/code> filter) he will now be unsubscribed from the selected Mailchimp list.<\/li>\n- User fields which are an array of values are now automatically converted to a comma-separated string before they are sent to Mailchimp.<\/li>\n<\/ul>\n\n
1.4.2 - March 14, 2016<\/h4>\n\n
Fixes<\/strong><\/p>\n\n
\n
- Re-run subscribe method if email isn't found on Mailchimp list (because of an invalid email, for example)<\/li>\n<\/ul>\n\n
Improvements<\/strong><\/p>\n\n
\n
- Setup schedule to run sync process at least once an hour, to prevent long delays.<\/li>\n
- Strip
EMAIL<\/code> from available field map fields to prevent invalid configurations.<\/li>\n- Webhook updating a user will now write to the debug log<\/a>.<\/li>\n<\/ul>\n\n
1.4.1 - February 10, 2016<\/h4>\n\n
Fixes<\/strong><\/p>\n\n
\n
- Webhook verification not working when setting up webhook in Mailchimp.<\/li>\n<\/ul>\n\n
Improvements<\/strong><\/p>\n\n