=== Centous Integration for Contact Form 7 and Mailchimp ===
Contributors: Centous
Tags: contact form 7, wpforms, formidable forms, mailchimp, lead management
Requires at least: 6.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.1.3
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Connect Contact Form 7, WPForms, Elementor Forms, and Formidable Forms to Mailchimp. Sync submissions to your Mailchimp audience automatically.

== Description ==

Centous Integration for Contact Form 7 and Mailchimp connects your WordPress forms to [Mailchimp](https://mailchimp.com/). When a visitor submits a supported form, the plugin can automatically add or update subscribers in your Mailchimp audience based on your feed configuration.

Install the form builder you already use, connect Mailchimp, create a feed, map your fields, and submissions sync in the background.

This plugin is not affiliated with or endorsed by Mailchimp, Inc. Mailchimp is a registered trademark of Mailchimp, Inc.

= Supported form plugins =

* Contact Form 7
* WPForms
* Elementor Forms (Elementor Pro)
* Formidable Forms

= Key features =

* Sync form submissions to Mailchimp audience subscribers
* Secure Mailchimp authentication via OAuth 2.0 or API key
* Feed-based integration management
* Advanced field mapping between form fields and Mailchimp merge fields
* Built-in connection testing
* Add notes to Mailchimp records from WordPress logs
* Detailed API request and response logging
* Optional clean uninstall to remove plugin data
* Modular architecture for reliable multi-form support

= How it works =

1. Connect your Mailchimp account from the plugin settings.
2. Create a feed and select a form from Contact Form 7, WPForms, Elementor Forms, or Formidable Forms.
3. Choose your Mailchimp audience.
4. Map form fields to Mailchimp merge fields.
5. Save the feed. Submissions are sent to Mailchimp and logged in WordPress.

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/` or install it through **Plugins → Add New → Upload Plugin**.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Install and activate at least one supported form plugin:
   * Contact Form 7
   * WPForms
   * Elementor Pro (for Elementor Forms)
   * Formidable Forms
4. Go to **Mailchimp Connect → Mailchimp Connect** in the WordPress admin.
5. Connect your Mailchimp account using OAuth 2.0 or an API key and complete the setup.

== Frequently Asked Questions ==

= Which form plugins are supported? =

Contact Form 7, WPForms, Elementor Forms (Elementor Pro), and Formidable Forms. Install only the form plugin or plugins you use. The plugin detects supported builders automatically.

= Can I use multiple form plugins at the same time? =

Yes. You can create feeds for Contact Form 7, WPForms, Elementor Forms, and Formidable Forms in the same WordPress installation.

= What Mailchimp objects are supported? =

The plugin syncs data to Mailchimp audience subscribers (contacts).

= Does the plugin delete data on uninstall? =

Only if the **Delete all plugin data when uninstalling** setting is enabled in **Mailchimp Connect → Settings**. By default, plugin data is preserved.

= Is OAuth authentication supported? =

Yes. The plugin supports OAuth 2.0 and API key authentication for Mailchimp.

= How does Formidable Forms field mapping work? =

Formidable fields are mapped using their field keys, such as `email`, `first-name`, or `phone`. When you select a Formidable form in the feed settings, the plugin loads its fields automatically.

= How does Elementor Forms field mapping work? =

Elementor fields are mapped using each field's custom ID from the Elementor form widget settings.

= Is an email field required? =

Yes. Mailchimp requires a valid email address to create or update a subscriber. Map your form's email field to the Mailchimp email merge field.

== Screenshots ==

1. Mailchimp connection setup screen
2. Mailchimp test connection screen
3. Feed creation with grouped form selection
4. Field mapping interface
5. Feeds list with form type badges
6. Logs and debugging panel

== Usage ==

= Basic setup =

1. Connect your Mailchimp account from the plugin settings.
2. Install and activate your preferred form plugin or plugins.
3. Go to **Mailchimp Connect → Feeds** and click **Add New Feed**.
4. Select the form type and choose your form.
5. Select your Mailchimp audience.
6. Map form fields to Mailchimp merge fields.
7. Save and activate the feed.

= Contact Form 7 =

1. Install and activate Contact Form 7.
2. Create or choose an existing CF7 form.
3. Create a feed, select **Contact Form 7**, and choose your form.
4. Map fields using CF7 field names such as `your-email` and `your-name`.
5. Save the feed.

= WPForms =

1. Install and activate WPForms.
2. Create or choose an existing WPForms form.
3. Create a feed, select **WPForms**, and choose your form.
4. Map fields using the WPForms field identifiers shown in the mapping screen.
5. Save the feed.

= Elementor Forms =

1. Install and activate Elementor Pro.
2. Create or choose an existing Elementor form widget.
3. Create a feed, select **Elementor Forms**, and choose your form.
4. Map fields using Elementor field custom IDs.
5. Save the feed.

= Formidable Forms =

1. Install and activate Formidable Forms.
2. Create or choose an existing Formidable form.
3. Create a feed, select **Formidable Forms**, and choose your form.
4. Map fields using Formidable field keys such as `email`, `first-name`, and `phone`.
5. Save the feed.

== External services ==

This plugin connects to Mailchimp to send and manage audience subscriber data.

= What the service is and what it is used for =

[Mailchimp](https://mailchimp.com/) is an email marketing and CRM platform. This plugin uses the Mailchimp API to create or update audience subscribers when supported WordPress forms are submitted.

= What data is sent and when =

When a supported form is submitted and a matching active feed exists, the plugin sends only the mapped field values to Mailchimp over HTTPS. This may include personal data such as name, email address, phone number, and other custom fields configured in your feed mapping.

Data is sent at the time of form submission. The plugin may also contact Mailchimp during account connection, token refresh, connection testing, and when notes are added from plugin logs.

No visitor data is sent to Mailchimp unless a form is submitted and an active feed is configured for that form.

= Service provider =

Mailchimp, Inc.
Website: https://www.mailchimp.com/
Privacy Policy: https://legal.mailchimp.com/privacy-policy/
Terms of Service: https://legal.mailchimp.com/terms-of-service/

= User consent =

Site owners are responsible for informing visitors about data collection and obtaining any consent required by applicable privacy laws, including GDPR and CCPA, before sending personal data to Mailchimp.

== Changelog ==

= 1.1.3 =
* Added Formidable Forms integration support
* Formidable form submissions can sync to Mailchimp audience subscribers
* Added Formidable Forms option in the feed form type selector
* Added Formidable field key-based mapping in the admin interface
* Added Formidable Forms source label in integration logs

= 1.1.2 =
* Added Elementor Forms integration support
* Enhanced form plugin detection and compatibility
* Improved feed form selection interface
* Updated documentation for Elementor Forms

= 1.1.0 =
* Added WPForms integration support alongside Contact Form 7
* Restructured plugin architecture for improved performance and maintainability
* Enhanced feed-based configuration system
* Improved field mapping interface
* Better handling of multiple form types in a single installation

= 1.0 =
* Initial release
* Contact Form 7 integration
* Mailchimp OAuth and API key authentication
* Feed management and field mapping
* Logging and note sync support
* Clean uninstall option

== Upgrade Notice ==

= 1.1.3 =
Adds Formidable Forms support. Existing Contact Form 7, WPForms, and Elementor Forms integrations continue to work without changes.

= 1.1.2 =
Adds Elementor Forms support. Existing Contact Form 7 and WPForms integrations continue to work without changes.

= 1.1.0 =
Major update with WPForms support and a restructured architecture. Existing Contact Form 7 feeds continue to work. Backup your data before upgrading.

= 1.0 =
Initial stable release.

== Support ==

For support, feature requests, or bug reports, contact Centous:
https://centousplugins.com/contact-us/

Documentation:
https://docs.centousplugins.com/centous-integration-for-cf7-wpforms-and-mailchimp/

Website: https://www.centous.com/

== Additional resources ==

* Contact Form 7: https://wordpress.org/plugins/contact-form-7/
* WPForms: https://wpforms.com/
* Elementor: https://elementor.com/
* Formidable Forms: https://wordpress.org/plugins/formidable/
