readme.txt

=== Kit (formerly ConvertKit) for WPForms ===
Contributors: nathanbarry, convertkit, billerickson
Donate link: https://kit.com
Tags: form, wpforms, convertkit, email, marketing
Requires at least: 5.0
Tested up to: 6.9
Requires PHP: 7.1
Stable tag: 1.9.3
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Create Kit signup forms using WPForms

== Description ==

[Kit](https://kit.com) makes it easy to capture more leads and sell more products by easily embedding email capture forms anywhere.

This Plugin integrates WPForms with Kit, allowing form submissions to be automatically sent to your Kit account.

Full plugin documentation is located [here](https://cultivatewp.com/our-plugins/integrate-convertkit-wpforms/).

== Installation ==

1. Upload the `integrate-convertkit-wpforms` folder to the `/wp-content/plugins/` directory
2. Active the Kit for WPForms plugin through the 'Plugins' menu in WordPress

== Configuration ==

1. Configure the plugin by navigating to WPForms > Settings > Integrations > Kit in the WordPress Administration Menu, entering your [API Key](https://app.convertkit.com/account_settings/advanced_settings)
2. Configure sending WPForms Form Entries to Kit, by editing your WPForms Form, and navigating to Marketing > Kit within the Form.

== Frequently asked questions ==

= Does this plugin require a paid service? =

No. You must first have an account on kit.com, but you do not have to use a paid plan!

== Screenshots ==

1. WPForms Kit API Connections at WPForms > Settings > Integrations > Kit
2. WPForms Kit Form Settings when editing a WPForms Form at Marketing > Kit

== Changelog ==

### 1.9.3 2026-04-22
* Updated: WordPress Libraries to 2.1.6

### 1.9.2 2026-04-13
* Added: Settings: Revoke Access and Refresh Tokens, and remove from settings, when `Disconnect` button clicked
* Added: Uninstall: Revoke Access and Refresh Tokens, and remove from settings, when the Plugin is deleted (Plugins > Kit for WPForms > Delete)
* Removed: v3 API Key and Secret
* Updated: WordPress Libraries to 2.1.5

### 1.9.1 2026-03-31
* Fix: Downgrade WordPress Libraries to 2.1.3, resolving issues in 1.9.0 and 1.9.0.1

### 1.9.0.1 2026-03-30
* Fix: Fatal error: Cannot redeclare trait ConvertKit_API\ConvertKit_API_Traits

### 1.9.0 2026-03-30
* Updated: Use WordPress Libraries 2.1.4

### 1.8.9 2025-12-18
* Fix: Settings: Automatically delete invalid Access Tokens
* Updated: Use WordPress Libraries 2.1.3

### 1.8.8 2025-12-03
* Updated: Use WordPress Libraries 2.1.2

### 1.8.7 2025-11-20
* Updated: Use WordPress Libraries 2.1.1

### 1.8.6 2025-09-29
* Updated: WordPress Coding Standards for JS and CSS
* Updated: Use WordPress Libraries 2.1.0

### 1.8.5 2025-07-31
* Fix: Automatically refresh Access Token when expired

### 1.8.4 2025-05-15
* Added: Form Builder: Marketing: Kit: Add New Connection: Display OAuth popup if no existing connections are specified at `WPForms > Settings > Integrations`

### 1.8.3 2025-05-07
* Updated: Require PHP 7.1 or greater
* Updated: Use WordPress Libraries 2.0.9

### 1.8.2 2025-04-15
* Updated: Use WordPress Libraries 2.0.8

### 1.8.1 2025-03-25
* Fix: Remove `load_plugin_textdomain` call, as it's not needed since WordPress 4.6
* Fix: Issue client ID, site-specific v4 API Access and Refresh Token when upgrading from < 1.7.0
* Updated: Use WordPress Libraries 2.0.7

### 1.8.0 2025-03-06
* Fix: Save Creator Network settings when editing a WPForms Form in WPForms Lite 1.9.4.0+

### 1.7.9 2025-01-23
* Added: Populate the referrer property when a WPForms Form is configured to subscribe an email address to a Kit Form
* Updated: ConvertKit WordPress Libraries to 2.0.6

### 1.7.8 2024-11-13
* Added: OAuth: Issue site-specific Access and Refresh Token when using the same Kit account on multiple WordPress sites
* Added: Settings: Integrations: Add `Reconnect` option
* Added: Use Kit Account ID as Provider Key, to retain settings when reconnecting via OAuth
* Updated: ConvertKit WordPress Libraries to 2.0.5

### 1.7.7 2024-10-08
* Fix: Kit branding tweaks and secondary button colors

### 1.7.6 2024-10-01
* Updated: Changed branding to Kit
* Updated: Kit WordPress Libraries to 2.0.4

### 1.7.5 2024-09-27
* Updated: ConvertKit WordPress Libraries to 2.0.3

### 1.7.4 2024-09-13
* Updated: ConvertKit WordPress Libraries to 2.0.2
* Fix: Don't automatically refresh tokens on non-production sites

### 1.7.3 2024-08-15
* Fix: Set subscriber to `inactive` when a ConvertKit Form is specified, honoring the Form's opt in setting.

### 1.7.2 2024-08-05
* Added: Option to just subscribe email, or subscribe to a Form, Tag or Sequence

### 1.7.1 2024-07-18
* Updated: ConvertKit WordPress Libraries to 2.0.1

### 1.7.0 2024-07-08
* Added: Use ConvertKit v4 API and OAuth
* Updated: ConvertKit WordPress Libraries to 2.0.0

### 1.6.3 2024-03-08
* Updated: ConvertKit WordPress Libraries to 1.4.2

### 1.6.2 2024-01-16
* Updated: ConvertKit WordPress Libraries to 1.4.1

### 1.6.1 2023-11-09
* Updated: ConvertKit WordPress Libraries to 1.4.0

### 1.6.0 2023-10-05
* Updated: ConvertKit WordPress Libraries to 1.3.9

### 1.5.9 2023-08-31
* Updated: WordPress Coding Standards
* Updated: ConvertKit WordPress Libraries to 1.3.8

### 1.5.8 2023-07-24
* Added: Enable Creator Network Recommendations modal on individual Forms at Edit Form > Settings > ConvertKit

### 1.5.7 2023-07-17
* Updated: ConvertKit WordPress Libraries to 1.3.7

### 1.5.6 2023-06-13
* Updated: ConvertKit WordPress Libraries to 1.3.6

### 1.5.5 2023-04-06
* Updated: ConvertKit WordPress Libraries to 1.3.4

### 1.5.4 2023-03-30
* Added: Tags: Support for multiple tags when tagging a subscriber
* Added: Tags: Support for values as tag names when tagging a subscriber

### 1.5.3 2023-02-23
* Updated: ConvertKit WordPress Libraries to 1.3.3

### 1.5.2 2023-02-14
* Updated: ConvertKit WordPress Libraries to 1.3.2

### 1.5.1.1 2023-02-02
* Fix: WPForms Form > Marketing > ConvertKit: ConvertKit Form: Display Forms in alphabetical order
* Fix: WPForms Form > Marketing > ConvertKit: List Fields: Display Custom Fields in alphabetical order

### 1.5.0 2023-01-16
* Added: Register ConvertKit as an Integration.  API Keys are now defined at WPForms > Settings > Integrations > ConvertKit. Any WPForms Forms from 1.4.2 and earlier will automatically have their ConvertKit API credentials migrated 
* Added: Select ConvertKit Form to send entries to from dropdown when editing a WPForms Form at Marketing > ConvertKit, instead of needing to specify a ConvertKit Form ID
* Added: Optionally map a Form Field to be used as the value for tagging a subscriber when editing a WPForms Form at Marketing > ConvertKit.  Any WPForms Forms using the `ck-tag` class are still honored.
* Added: Optionally map Form Fields to be used as a subscriber's Custom Fields when editing a WPForms Form at Marketing > ConvertKit.  Any WPForms Forms using the `ck-custom-{name}` class are still honored.
* Added: Improved logging at WPForms > Tools > Logs

= 1.4.2 =
* Fix: Include name when subscribing to ConvertKit, when the Name field is mapped to the first WPForms Form Field with an ID of zero
* Fix: Include tags when subscribing to ConvertKit
* Fix: Sign up link

= 1.4.0 =
- Added support for WPForms Log (Tools > Logs > select provider)

= 1.3.0 =
- Added method for defining custom fields and tags in your form, [more information](https://www.billerickson.net/setup-convertkit-wordpress-form/#custom-fields-and-tags)

= 1.2.0 =
- Added filter for passing custom fields to ConvertKit, [see example](https://www.billerickson.net/code/integrate-convertkit-wpforms-custom-fields/)
- First name is no longer a required field

= 1.1.0 =
- Added filter to conditionally limit ConvertKit integration, [see example](https://www.billerickson.net/code/integrate-convertkit-wpforms-conditional-processing/)

= 1.0.3 =
- Remove ConvertKit link once API key has been provided

= 1.0.2 =
- Updated documentation

= 1.0.1 =
* Added translation file for localization

= 1.0.0 =
* Initial release