﻿=== 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
