=== Ultimate Member - MailChimp === Author URI: https://ultimatemember.com/ Plugin URI: https://ultimatemember.com/extensions/mailchimp/ Contributors: ultimatemember, champsupertramp, nsinelnikov Donate link: Tags: mailchimp api connect, email, audience, community Requires at least: 6.5 Tested up to: 6.9 Stable tag: 2.6.2 License: GPLv3 License URI: http://www.gnu.org/licenses/gpl-3.0.txt Requires UM core at least: 2.11.0 This extension integrates MailChimp with Ultimate Member and allows users to subscribe to your mailing lists when they register on your site. == Description == This extension integrates MailChimp with Ultimate Member and allows users to subscribe to your mailing lists when they register on your site. = Key Features: = * Automatically add users to a MailChimp list when they register. * Allow users to opt-in to subcribing to a MailChimp list when they register. * Add multiple lists to register form and allow users to select which lists they subscribe to. * Show different lists on different register forms. * Sync user meta with MailChimp list. * Allow users to subscribe/unsubcribe from their account page. * Restrict lists to certain roles (Only roles that can subscribe/unsubcribe to a list will see it on their account page). = Development * Translations = Want to add a new language to Ultimate Member? Great! You can contribute via [translate.wordpress.org](https://translate.wordpress.org/projects/wp-plugins/ultimate-member). If you are a developer and you need to know the list of UM Hooks, make this via our [Hooks Documentation](https://docs.ultimatemember.com/article/1324-hooks-list). = Documentation & Support = Got a problem or need help with Ultimate Member? Head over to our [documentation](http://docs.ultimatemember.com/) and perform a search of the knowledge base. If you can’t find a solution to your issue then you can create a topic on the [support forum](https://wordpress.org/support/plugin/um-forumwp). == Installation == 1. Download ZIP file with extension from your account on https://ultimatemember.com/ 2. Enter your website, go to wp-admin > Plugins > Add New Plugin. 3. Click the "Upload Plugin" button, choose ZIP file with extension, click the "Install Now" button. 4. Activate the plugin. 5. Go to wp-admin > Ultimate Member > Settings > Extensions > MailChimp and enter your MailChimp API key. 6. For more details, please visit the official documentation at http://docs.ultimatemember.com/article/82-mailchimp-setup == Changelog == = 2.6.2: December 02, 2025 = * Tweak: Integration with Ultimate Member Extensions_Updater class. Updated packages for integration with Action Scheduler. = 2.6.1: October 9, 2025 = * Fixed: Member Directory displaying when there isn't active MailChimp connection. = 2.6.0: October 8, 2025 = * Added: The extension settings and connection information to the Site Health "Info" page. * Tweak: Improve descriptions for the extension settings. * Tweak: Implement new UI and functionality updates. * Tweak: Replaced Font Awesome icons with WordPress Dashicons for consistency across all wp-admin interfaces. * Tweak: Refactor integrations and update extension dependencies. * Tweak: Used new filesystem class. * Templates required update: - account_email_newsletters.php - field.php - fieldset.php - fieldset_ch.php **Cached and optimized/minified assets(JS/CSS) must be flushed/re-generated after upgrade** = 2.5.0: March 3, 2025 = * Added: Settings "Enable language field" and "Default language". * Added: Filter requests and search in the "Requests log". * Added: The "Import users from MailChimp" dashboard widget. * Fixed: The `init` hook priority conflict. * Tweak: Changed the extension structure to improve performance. * Tweak: The "Log all responses" setting replaced with the `um_mailchimp_log_response` filter hook. * Removed: The "Sync Profiles" dashboard widget. * Templates required update: - account_email_newsletters.php - field.php - fieldset.php - fieldset_ch.php - form_subscribe.php - form_unsubscribe.php = 2.4.9: November 15, 2024 = * Added: Compatibility with Ultimate Member 2.9.0 and Action Scheduler for email sending * Fixed: "Load textdomain just in time" issue * Fixed: PHP Fatal error on Ultimate Member Dashboard page = 2.4.8: September 30, 2024 = * Added: Language setting for user and MailChimp field * Added: Shortcode [ultimatemember_mailchimp_subscribe] language attribute * Tweak: Compatibility with the future new UI * Tweak: WP Users table compatibility with Ultimate Member 2.8.7 * Tweak: Improved connection checking and error logging * Templates required update: - fieldset.php - fieldset_ch.php - account_email_newsletters.php = 2.4.7: December 11, 2023 = * Tweak: wp-admin scripts refactored * Tweak: Added CPT as UM registered post type for define proper UM screen on wp-admin * Fixed: 'um_user_permissions_filter' hook attributes * Tweak: Enhancements related to WPCS = 2.4.6: October 11, 2023 = * Added: Connection setting "Default interests for existing contacts" * Added: Connection setting "Default tags for existing contacts" * Fixed: Displaying "Notifications Account Tab" setting * Fixed: Case when extension isn't active based on dependency, but we can provide the license key field = 2.4.5: August 18, 2023 = * Added: Users bulk actions Subscribe and Unsubscribe. * Added: The `autofill` attribute in shortcodes. * Fixed: The `show_label` and `show_placeholder` attributes in shortcodes. * Tweak: New method to check a connection to the MailChimp API. * Tweak: Error notice about the invalid MailChimp API Key. * Tweak: Nonce protection for the AJAX requests. = 2.4.4: July 1, 2023 = * Fixed: PHP warnings * Tweak: Ultimate Member 2.6.7 compatibility = 2.4.3: May 31, 2023 = * Fixed: PHP warnings = 2.4.2: May 30, 2023 = * Fixed: PHP warnings * Tweak: Template overwrite versioning = 2.4.1: October 26, 2022 = * Added: Remove MailChimp settings, connections, form fields on uninstall * Added: Remove user role settings related to MailChimp on uninstall * Added: Remove user meta related to MailChimp on uninstall * Added: Remove custom templates related to MailChimp on uninstall * Added: Default value for the "Groups and Tags view" setting * Added: Auto-fill MailChimp groups and tags in the registration form after failed submit * Fixed: A contact update if the user email is changed * Fixed: Deleting fields on post delete or trash if field type is empty * Fixed: Error in Admin dashboard if MailChimp API key is incorrect * Fixed: Group's interests removing in account notifications tab = 2.4.0: August 17, 2022 = * Added: Hook um_mailchimp_can_sync * Added: Display a list of newsletters after the member name (for administrators) * Added: Sanitize connection title on connection update * Added: Remove fields which use deleted connection on connection delete * Fixed: Connection roles setting * Fixed: Double opt-in feature * Fixed: Error on activation without a core plugin * Fixed: Don't display field label if empty * Improved: Internal caching * Improved: Planned requests are used instead of immediately requests * Improved: Widget "Testing connection with MailChimp server" = 2.3.2: February 9, 2022 = * Fixed: Extension settings structure = 2.3.1: December 16, 2021 = * Added: Restore the requested user before the contact update if it is lost * Added: Requests log for users * Added: Keys into dropdown options in the widget Merge User Meta * Fixed: BIRTHDAY meta field format * Fixed: BIRTHDAY meta field value if not valid * Fixed: Fields in the shortcode [ultimatemember_mailchimp_subscribe] = 2.3.0: September 23, 2021 = * Updated: MailChimp wp-admin metabox * Fixed: Compatibility with core version 2.2.5 * Fixed: Update audience contact if Administrator edit user in the admin area * Fixed: The multiselect-type field value on bulk syncing = 2.2.9: May 5, 2021 = * Fixed: Unsubscribe form = 2.2.8: March 15, 2021 = * Added: Setting "Groups and Tags view" * Added: Setting "Label" for the MailChimp field * Added: The `fieldset_ch.php` template for the Groups and Tags checkbox view * Added: Option to skip address field on syncing * Added: Links to the documentation * Fixed: "MailChimp audiences" column in the Users table * Fixed: MailChimp field's label in the registration form * Tweak: Settings description = 2.2.7: December 8, 2020 = * Added: A column "MailChimp audiences" in the admin table "Users" * Added: A notification if the "MailChimp API Key" is wrong * Added: A setting "Blocked Email Addresses" * Added: Helper fields "Role slug" and "Role title" to simplify role syncing * Added: Skip invalid values on audience fields syncing * Added: The shortcode [ultimatemember_mailchimp_subscribe] * Added: The shortcode [ultimatemember_mailchimp_unsubscribe] * Added: Template files field.php, form_subscribe.php, form_unsubscribe.php * Changed: The template file fieldset.php * Fixed: A label for the field type "MailChimp" in the registration form * Fixed: Disable fields hidden by conditional logic * Fixed: Don't unsubscribe existing contacts on registration * Fixed: Integration with the extension "Profile Completeness" * Fixed: The conflict caused by the function um_fetch_user * Fixed: The subscription logic for contacts with the status "pending" = 2.2.6: August 14, 2020 = * Fixed: Getting all groups * Fixed: Getting all tags * Updated: Documentation = 2.2.5: August 11, 2020 = * Added: A new widget tool "Sync Profiles (with details)" * Added: Compatibility with the extension "User Tags" * Added: Compatibility with the MailChimp's field type "Address" * Added: Show sync error details in the dashboard widget * Added: Show sync error details on the page Account * Added: Show a difference between "MC Choices" and "UM Choices" in the box "Merge User Meta" * Added: Show tooltips in the box "Testing connection with Mailchimp server" * Changed: Send a 'multiselect' field value as a comma-separated values * Changed: The action on Account update or Profile update * Fixed: Data used in the modal window "Review Registration Details" and email placeholder {submitted_registration} * Fixed: JavaScript error in the tool "Bulk Subscribe & Unsubscribe" * Fixed: The action on Change email address (update existing contact) * Fixed: The form field "MailChimp", option "Select an audience" * Fixed: The function that get audience groups (get all groups) = 2.2.4: April 1, 2020 = * Added: Frontend script and style * Added: Setting "Marketing Permissions" * Added: User Roles options: "Can manage groups?", "Can manage tags?", "Can create tags?" * Added: Settings "Account delete action", "Account unapprove action" * Added: Method UM()->Mailchimp()->api()->mc_archive_member() * Added: Method UM()->Mailchimp()->api()->mc_deletep_member() * Removed: Setting "Remove subscriber from Mailchimp audience when user unsubscribed" * Removed: Setting "Allow member to create tags" * Deprecated: Method UM()->Mailchimp()->api()->mc_delete_member() = 2.2.3: January 22, 2020 = * Added: Filter 'um_mailchimp_single_merge_field' and integration with Profile Completeness * Added: Option to disable lists nonce fields * Fixed: Prevent multiple updates = 2.2.2: December 18, 2019 = * Added: Ability to merge any UM field type with MC text field type * Fixed: Check member role before automatically subscribe * Fixed: Tool "Test subscribe" = 2.2.1: November 13, 2019 = * Fixed: Double opt-in: added "filter_subscription_status" method = 2.2.0: November 11, 2019 = * New: MailChimp's Groups support * New: MailChimp's Tags support * Added: Update Notifications notices * Added: Requests cache * Fixed: Requests log * Fixed: Testing connection tool * Fixed: Sync Profiles tool Users cache = 2.1.2: August 3, 2019 = * Fixed: JS error on Mailchimp widget dashboard = 2.1.1: December 7, 2018 = * Fixed: Subscription on change users role = 2.1.0: November 30, 2018 = * Added: MailChimp List testing actions = 2.0.9: November 1, 2018 = * Fixed: MailChimp API integration * Fixed: Translation Files = 2.0.8: November 1, 2018 = * Fixed: MailChimp API integration = 2.0.7: August 13, 2018 = * Fixed: WP native AJAX handlers = 2.0.6: August 3, 2018 = * Fixed: MailChimp Queries Queue * Fixed: Logic for auto subscribe process * Fixed: Small warnings & bugs = 2.0.5: July 11, 2018 = * Deprecated: old Sync&Opt-in process * Added: New batch opt-in users to MailChimp lists * Added: New sync users with MailChimp lists = 2.0.4: June 18, 2018 = * Added: GDPR compatibility * Added: Double opt-int settings to MailChimp lists = 2.0.3: May 18, 2018 = * Fixed: Statuses after registration * Fixed: Problem with subscription to list after activation process = 2.0.2: April 27, 2018 = * Added: Loading translation from "wp-content/languages/plugins/" directory = 2.0.1: October 17, 2017 = * Tweak: UM2.0 compatibility * Fixed: Users sync on add/edit/update profile actions = 1.1.8: July 28, 2017 = * New: MailChimp API v3 Integration * New: Scan opted-in users but not yet synced * New: Scan not yet opted-in users * New: Sync opted-in users * New: Opt-in profiles to specifc list on behalf of users * Fixed: resubscribe users in account page * Fixed: split sync process and show progress * Fixed: EDD plugin updater * Fixed: remove notices = 1.1.7: November 6, 2016 = * Fixed: empty email lists = 1.1.6: December 8, 2015 = * Initial release