readme.txt

=== Kit (formerly ConvertKit) - Email Newsletter, Email Marketing, Subscribers and Landing Pages ===
Contributors: nathanbarry, growdev, travisnorthcutt, ggwicz
Donate link: https://kit.com
Tags: email marketing, email newsletter, subscribers, landing page, membership
Requires at least: 5.0
Tested up to: 6.7.2
Requires PHP: 5.6.20
Stable tag: 2.7.5
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Build your email subscriber lists, send email marketing newsletters, sell more products and build your membership site with Kit (formerly ConvertKit).

== Description ==

[Kit](https://kit.com?utm_source=wordpress&utm_term=en_US&utm_content=readme) makes it easy to create, send and manage your email marketing campaigns; grow your email subscribers lists; send targeted email newsletters; sell more products and build your membership site - all by easily embedding email marketing / email subscriber forms anywhere on your WordPress web site.

**New to Kit? [Creating an account](https://app.kit.com/users/signup?plan=newsletter-free&utm_source=wordpress&utm_term=en_US&utm_content=readme) is 100% free for your first 10,000 subscribers, making Kit an email marketing solution for everyone - whether you're new to email newsletter marketing or a seasoned professional email newsletter marketer.**

## Email Newsletter and Email Marketing Features

- Design [email newsletter subscription forms](https://kit.com/features/forms?utm_source=wordpress&utm_term=en_US&utm_content=readme) in Kit, automatically appending them to any WordPress post or page, or displaying forms within your WordPress content using the supplied Gutenberg block and shortcode options. Perfect for building your email subscribers lists.
- Build [landing pages](https://kit.com/features/landing-pages?utm_source=wordpress&utm_term=en_US&utm_content=readme) in Kit, and display them on a WordPress page to capture additional email subscribers
- List past [email newsletters](https://kit.com/features/email-marketing?utm_source=wordpress&utm_term=en_US&utm_content=readme) on your WordPress site to engage your subscribers

## Forms

Design [forms](https://kit.com/features/forms?utm_source=wordpress&utm_term=en_US&utm_content=readme) in Kit, choosing from a variety of designs, customisable to your branding for your email newsletter strategy.

Sign up forms can be configured to:

- Send free content, such as a PDF newsletter
- Display when the user is about to leave the page
- Subscribe to an email newsletter, with powerful tagging and segmentation options for your subscribers

Embedding Kit forms on your WordPress web site with the Kit Plugin is quick and simple:

- Choose a default form to be displayed below each individual Post Type (Pages, Posts and other public Post Types, such as WooCommerce Products) to grow your email subscribers
- Choose a specific email marketing form to be displayed below a specific Page, Post or custom post type
- Turn off form embedding at both site wide and/or individual Page/Post level to control your email newsletter strategy

For greater control, Kit's email marketing subscription forms can be displayed in specific sections of your WordPress site's content, sidebars and footers by:

- Using the Kit Forms block in Gutenberg
- Using the `[convertkit]` shortcode in the Classic Editor

Start collecting email subscribers today and building your newsletter audience!

## Send Email Newsletters

Use Kit's [email marketing](https://kit.com/features/email-marketing?utm_source=wordpress&utm_term=en_US&utm_content=readme) feature to build and send email newsletters to your subscribers and leads, with options to send email newsletters to segments of your subscriber list.

Embed existing email newsletters on your WordPress web site, ensuring visitors never miss your email newsletter content, by:

- Using the Kit Broadcasts block in Gutenberg
- Using the `[convertkit_broadcasts]` shortcode in the Classic Editor

## Landing Pages

Design [landing pages](https://kit.com/features/landing-pages?utm_source=wordpress&utm_term=en_US&utm_content=readme) in Kit's intuitive editor, choosing from a variety of designs, customisable to your branding and ideal for building your email subscribers list or selling a product.

Additional landing pages can then be embedded on your WordPress web site. Simply create or edit a WordPress Page, choose the Kit landing page from the Kit meta box settings to display, and you're all set to begin growing your email subscribers list more effectively.

## Sell Products

Embed buttons (or link text) to sell your Kit Products in seconds - whether that's digital goods, paid email newsletters, music, coaching and more.

## List Email Newsletters

Automatically publish your past email newsletters to WordPress Posts, defining a WordPress author, category and cut-off date within the Plugin's settings to keep your subscribers informed.

Prefer to just list existing broadcasts, each linked to your Kit profile? Use the Broadcasts block or shortcode to embed your existing newsletters in any WordPress Page, Post or Custom Post Type, providing more touchpoints for your email newsletter content.

## Paid (and free) Membership Sites

Require email subscribers to either purchase a [Kit Product](https://kit.com/features/commerce), or subscribe for free, to access your content with Kit's Member Content feature - whether that's a course, ebook, digital download, album, presets, coaching and more. 

Subscribers access their membership by entering their email address, receiving a one time passcode by email and clicking the link in the email. That's it - no complex paid membership plugins or payment gateways to configure.

There's no limit to the number of Kit Products you can create, and each can be assigned to one or more WordPress Pages and Posts, instantly turning them into membership only content for your paid subscribers. 

## Plugin Integrations

With the Kit for WordPress Plugin, you also get integrations with:

- Elementor: Form and Broadcast widgets natively integrated with Elementor, to embed Kit forms and broadcast lists for your email newsletter strategy
- Contact Form 7: Automatically add email subscribers to Kit when they submit a Contact Form 7 form
- WishList Member: Automatically subscribe, unsubscribe and tag users based on their membership level

Our other WordPress Plugins provide further integrations between WordPress and Kit:

- [Kit for WooCommerce](https://wordpress.org/plugins/convertkit-for-woocommerce/): Subscribe, tag and assign sequences to customers at checkout, and send order data to Kit
- [Kit for Gravity Forms](https://wordpress.org/plugins/convertkit-gravity-forms/): Automatically add email subscribers to Kit when they submit a Gravity Form, with tagging options

## What is Kit?

Kit is the go-to email marketing hub for creators that helps you grow and monetize your audience with ease.

**Grow your audience:** Increase subscribers with beautiful landing pages, sign up forms, and link pages that make your work stand out.

**Automate your email marketing:** Create lasting connections and promote like a pro with our intuitive email editor, powerful sales funnels and subscriber list segmentation using tags.

**Sell your digital products:** Market and sell your digital products and subscriptions with Kit to drive higher conversions and save big on fees.

### Documentation

Full Plugin documentation can be found [here](https://help.kit.com/en/articles/2502591-the-convertkit-wordpress-plugin?utm_source=wordpress&utm_term=en_US&utm_content=readme).

== Installation ==

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

== Configuration ==

1. Configure the plugin by navigating to `Settings > Kit` in the WordPress Administration Menu, and clicking the `Connect` button
2. Once connected, define the default forms to display on Pages, Posts and/or Custom Post Types
3. (Optional) choose a specific Form to display when editing a Page, Post or Custom Post Type in the Page/Post/Custom Post Type's Kit settings
4. (Optional) use the Kit Form Shortcode or Block to insert Forms into your Page, Post or Custom Post Type content to enhance your email newsletter reach

== Frequently asked questions ==

= Does this plugin require a paid service? =

No. You must first have an account on [kit.com](https://kit.com?utm_source=wordpress&utm_term=en_US&utm_content=readme), but you do not have to use a paid plan!

= How do I refresh my available Forms, Landing Pages and Tags? =

Either:

- Navigate to the Plugin's Settings at `Settings > Kit`
- Click the refresh button displayed next to the Form, Landing Page or Tag fields when creating/editing Pages or Posts to ensure your latest email newsletter forms are available

= How do I automatically import Kit Broadcasts to WordPress Posts? =

To import your past (and future) email newsletters from Kit to WordPress:

- Navigate to the Plugin's Settings at `Settings > Kit`
- Click the `Broadcasts` tab
- Tick the `Enable Automatic Import` option
- Configure other settings as necessary, and click `Save Changes` when done to streamline your email newsletter publishing

= Where can I find the Plugin's Documentation? =

Full Plugin documentation can be found [here](https://help.kit.com/en/articles/2502591-the-convertkit-wordpress-plugin?utm_source=wordpress&utm_content=readme).

== Screenshots ==

1. Create and customize stunning email subscription forms and landing pages in Kit
2. Manage the WordPress plugin from a simple settings page in the WordPress admin
3. Append Kit forms to Pages, Posts or other Custom Post Types to grow your email subscribers
4. Configure a specific Kit form to display on a specific Page or Post
5. Display your Kit forms anywhere on your WordPress web site using the form block / shortcode
6. Configure a Kit landing page to be used in place of a WordPress Page, to capture email subscribers
7. Automatically import your past email newsletters to WordPress Posts
8. Create your paid membership site by assigning paid Kit Products to your existing WordPress content 
9. Set up form and landing page automations in Kit
10. Track subscriber growth and email newsletter performance

== Changelog ==

### 2.7.5 2025-03-07
* Fix: Member Content: Set `wordpress_ck_subscriber_id` cookie to beat WP Engine's server caching
* Fix: Settings: Forms: Check Post Type of main Post, to ensure correct form is output when multiple Posts output on a singular Post, Page or CPT

### 2.7.4 2025-02-24
* Added: Broadcasts (Beta): `convertkit-broadcast` body CSS class to Posts imported from Kit Broadcasts, to allow targeted CSS styles
* Fix: Broadcasts (Beta): Remove table borders and background colors added by Elementor on imported Kit Broadcasts
* Fix: Member Content: Support magic links in emails
* Fix: Tools: Import & Export: Include Broadcasts settings

### 2.7.3 2025-02-18
* Added: Member Content: Tags: Display login link when `Require login` option enabled
* Added: Member Content: Option to gate content by Kit Form
* Added: Default Forms (Site Wide): Option to honor `None` setting on Page, Post and Custom Post level
* Updated: Use WordPress Libraries 2.0.6

### 2.7.2 2025-02-04
* Added: Member Content: Option to require login when gating content by Tag. Subscribers receive an email with a magic link / code to securely access member-only content
* Added: Broadcasts (Beta): Option to export WordPress Pages and Custom Post Types to draft Kit Broadcasts using `Create Broadcast in Kit` option in admin tables
* Added: Settings: Intercom help integration
* Fix: Remove `ck_subscriber_id` from URL using `replaceState`, ensuring current URL is only stored once in browser history

### 2.7.1 2025-01-23
* Added: Populate the `referrer` property in Kit when Contact Form 7 or Forminator is configured to subscribe an email address to a Kit Form
* Added: Settings: Group Settings in UI
* Added: Refresh resources button to update the list of Kit Forms / Products when using an applicable block or shortcode
* Added: Member Content: Support using a signed subscriber ID when viewing content gated by Kit Tag
* Fix: Settings: Uncaught TypeError when clicking Save Changes at Settings > Kit when a Kit account has no resources and no checkboxes are checked
* Updated: Kit WordPress Libraries to 2.0.6

### 2.7.0 2024-12-18
* Added: Member Content: Automatically configure WP Rocket to not cache when the `ck_subscriber_id` cookie is present, to ensure Member Content correctly displays
* Fix: Don't strip hash from URL, ensuring anchor links work

### 2.6.9 2024-12-12
* Added: Settings: Default Forms (Site Wide): Option to specify more than one non-inline site wide Form
* Added: Settings: Member Content: Option to enable Google reCAPTCHA v3 when using Member Content by Tag functionality 

### 2.6.8 2024-12-07
* Fix: Fatal error when a non-inline Form specified in Plugin, Post or Category settings and Form Position set to `After element`

### 2.6.7 2024-12-04
* Removed: `convertkit_store_subscriber_id_in_cookie` AJAX call, as logic exists server side

### 2.6.6 2024-11-27
* Added: Categories: `None` option added to specify no Form displays on Posts assigned to the Category
* Added: Honor Block Visibility Plugin's conditions when used on a Kit Form block set to output a non-inline Form
* Fix: Character encoding when a Form is set to display after a specific element at `Settings > Kit > Form Position`
* Fix: Settings: Broadcasts: Ensure `Import Now` displays
* Fix: Broadcasts: Automatically reschedule cron event for importing Broadcasts to WordPress Posts, if removed

### 2.6.5 2024-11-13
* Added: OAuth: Issue site-specific Access and Refresh Token when using the same Kit account on multiple WordPress sites
* Fix: Exclude Forms from WP Rocket Minification and Combine
* Updated: ConvertKit WordPress Libraries to 2.0.5

### 2.6.4 2024-11-05
* Added: Settings: Broadcasts: Option to import images to the WordPress Media Library when importing Broadcasts to WordPress Posts
* Added: Broadcasts: Remove heading title from content when it matches the Broadcast's title
* Fix: Broadcasts: Retain `figure` and `figcaption` elements when importing Broadcasts to WordPress Posts

### 2.6.3 2024-10-28
* Added: Broadcasts: Exclude Polls when importing Broadcasts to WordPress Posts
* Added: Settings: Forms: Only display Form settings if Forms exist in Kit
* Fix: Add a Tag: Honor setting when defined on individual WordPress Pages and Posts, using the v4 API Access Token

### 2.6.2 2024-10-18
* Added: Settings: Option to output Default Forms after a given number of elements (paragraphs, headings, images)

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

### 2.6.0 2024-10-01
* Fix: Landing Pages: Replace Cloudflare JS `type` prefixes, to ensure JS runs
* Updated: Changed branding to Kit
* Updated: Kit WordPress Libraries to 2.0.4

### 2.5.9 2024-09-27
* Added: Settings: Option to output Default Forms above, below or above and below content
* Fix: Settings: Initialize Forms Resource class when no public Post Types (resolves PHP Uncaught Error: `Call to a member function non_inline_exist() on bool`)
* Fix: Landing Pages: Correctly parse HTML, honoring redirect if "Redirect to an external page" defined on Landing Page in Kit
* Fix: Query separator / question mark incorrectly appended to URLs when `ck_subscriber_id` cookie set
* Fix: JS Uncaught TypeError: `Cannot read properties of null (reading ‘matches’)`
* Fix: PHP Warning: `Attempt to read property “base” on null`
* Updated: Kit WordPress Libraries to 2.0.3

### 2.5.8 2024-09-18
* Added: Remove jQuery as a dependency from some backend JS
* Fix: Fatal error `Uncaught TypeError: Kit_API_V4::get_subscriber(): Argument #1 ($form_id) must be of type int, string given` when a blank or non-numeric `ck_subscriber_id` supplied in the URL

### 2.5.7 2024-09-16
* Added: Divi: Kit Broadcasts Module
* Added: Divi: Kit Form Trigger Module
* Added: Divi: Kit Product Module
* Fix: Landing Pages: Honor redirect if "Redirect to an external page" defined on Landing Page in Kit
* Fix: Preserve other URL query parameters when removing `ck_subscriber_id`

### 2.5.6 2024-08-15
* Added: Pages: Add New Landing Page Setup Wizard, to easily create a WordPress Page that displays a Kit Landing Page
* Added: Divi: Kit Form Module
* Updated: Pages: Landing Page + Member Content Wizards now display in a dropdown button

### 2.5.5 2024-08-15
* Fix: Contact Form 7: Set subscriber to `inactive` when a Kit Form is specified, honoring the Form's opt in setting.
* Fix: Forminator: Set subscriber to `inactive` when a Kit Form is specified, honoring the Form's opt in setting.
* Fix: WishList Member: Set subscriber to `inactive` when a Kit Form is specified, honoring the Form's opt in setting.

### 2.5.4 2024-08-08
* Added: WishList Member: Option to just subscribe email, subscribe to a Form, Tag or Sequence or unsubscribe
* Fix: Contact Form 7: Typo on description text
* Fix: Forminator: Typo on description text

### 2.5.3 2024-08-06
* Fix: Contact Form 7: Update description on settings screen to reflect new settings
* Fix: Forminator: Update description on settings screen to reflect new settings
* Fix: WishList Member: Fatal error `Uncaught TypeError: Kit_API_V4::add_subscriber_to_form(): Argument #1 ($form_id) must be of type int, string given`

### 2.5.2 2024-07-25
* Added: Contact Form 7: Option to just subscribe email, or subscribe to a Form, Tag or Sequence
* Added: Forminator: Option to just subscribe email, or subscribe to a Form, Tag or Sequence

### 2.5.1 2024-07-17
* Fix: Landing Pages: Prevent Perfmatters lazy loading images on Landing Pages, which would result in missing images
* Updated: Kit WordPress Libraries to 2.0.1

### 2.5.0 2024-07-09
* Added: Use Kit v4 API and OAuth
* Updated: Kit WordPress Libraries to 2.0.0

### 2.4.9.1 2024-06-20
* Added: Categories: Option to display specified Kit Form on Category archives
* Fix: Move "Add a Tag" logic to backend when tagging a subscriber, instead of using AJAX

### 2.4.9 2024-05-13
* Fix: Settings: Don't import Broadcasts to WordPress Posts when viewing Settings screen, for performance
* Fix: Broadcasts (Beta): Check `DOMDocument` available to parse Broadcasts, instead of producing a fatal error
* Fix: Autoptimize: Don't output duplicate Forms when Autoptimize's `Defer JS` option is enabled
* Updated: Removed upgrade path from Plugin versions below 1.4.1

### 2.4.8 2024-04-11
* Fix: Member Content: Display Content when using a frontend Page Builder, such as Beaver Builder
* Fix: Forms: Sticky Bar: Set `z-index` CSS property to ensure Sticky Bar Forms correctly display over some WordPress Theme headers and menus

### 2.4.7 2024-04-08
* Fix: WP-Rocket: Display Forms when WP-Rocket's `Delay JavaScript Execution` option is enabled
* Fix: Perfmatters: Display Forms when Perfmatters' `Delay JavaScript` option is enabled
* Fix: Broadcasts (Beta): Improve parsing of Broadcasts when removing unsubscribe and hidden sections

### 2.4.6 2024-03-08
* Fix: Debug Log: Change log file location to log subfolder, with .htaccess and index.html protection
* Fix: Debug Log: Mask email addresses, first names and signed subscriber IDs

### 2.4.5 2024-02-28
* Added: Products: Block and Shortcode: Option to immediately load checkout step when button clicked, instead of Product image and description
* Fix: Siteground Speed Optimizer: Display Forms when Siteground's `Combine JavaScript Files` option is enabled
* Fix: LiteSpeed Cache: Don't output duplicate non-inline Forms when LiteSpeed Cache's `Load JS Deferred` option is enabled
* Fix: Member Content: Improved UI on mobile devices

### 2.4.4 2024-02-19
* Added: Remove jQuery as a dependency from Setup Wizard, Modals and Refresh buttons
* Added: Forms: Automatically center inline forms on non-block Themes
* Fix: Forms: Remove bottom margin on non-inline forms
* Fix: Setup Wizard: Preview Form link for Pages would incorrectly display a Post
* Fix: Landing Pages: Prevent WP Rocket caching and lazy loading images on Landing Pages, which would result in missing background images
* Fix: Classic Editor: Modal window: Don't display vertical scrollbar on Safari
* Fix: Member Content: Refresh button: Populate Tags and Products in applicable option groups
* Fix: Member Content: Refresh button: Define correct option values on refresh, ensuring settings save successfully.
* Fix: Member Content: Corrected grammar for `member-only`

### 2.4.3 2024-01-31
* Added: Settings: Option to specify Default Form on public Custom Post Types
* Added: Custom Posts: Option to specify Form and Tag on individual public Custom Post Types
* Added: Member Content: Support for Member Content functionality on public Custom Post Types
* Added: Removed jQuery as a dependency from Bulk Edit, Quick Edit and TinyMCE JS
* Fix: Divi: Allow scrolling when editing using the Divi Builder in tablet or mobile view
* Fix: Jetpack Boost: Prevent inline Forms from displaying in footer when added to a Page or Widget area when Jetpack Boost Plugin active
* Fix: Settings: Remove whitespaces from API Key and Secret when saving
* Fix: Broadcasts (Beta): Improve descriptions to make clear that only public Broadcasts are imported to WordPress

### 2.4.2 2024-01-22
* Added: Member Content: Option to permit search engines to crawl Member Content at `Kit > Member Content > Permit Search Engine Crawlers`
* Added: Removed jQuery from frontend JS and as a dependency
* Fix: Site Editor: Use `enqueue_block_assets` hook instead of `enqueue_block_editor_assets` hook
* Updated: WordPress Libraries to 1.4.1

### 2.4.1 2024-01-08
* Added: Broadcasts (Beta): Option to store Kit Broadcast thumbnails as WordPress Post's Featured Image
* Added: Products: Block and Shortcode: Option to include a discount code
* Added: Products: Block and Shortcode: Option to disable modal on mobile. Recommended if the Kit Product is a digital download (PDF) being purchased on mobile, to ensure the subscriber can immediately download the PDF once purchased.

### 2.4.0 2023-12-06
* Fix: Kit Error: Could not load Plugin class `output` when editing, quick or bulk editing a Post.

### 2.3.9 2023-12-04
* Added: Settings: Display Kit Form's format (inline, slide in, sticky bar, modal) where a `select` dropdown option is presented
* Fix: Settings: Default Form (Site Wide): If defined, honor non-inline Form specified at Page, Post or Post Category level, to avoid two non-inline forms displaying
* Fix: Settings: Moved Documentation tab to Help link in header, for compat. with smaller screen resolutions

### 2.3.8 2023-11-20
* Added: Member Content: Display log in and authentication code forms in modal to better match Kit
* Added: Broadcasts (Beta): Define WordPress Post Author when importing Kit Broadcasts
* Fix: Broadcasts (Beta): Don't show next scheduled date and time immediately after clicking `Import Now`
* Fix: PHP Warning: Use of deprecated `FILTER_SANITIZE_STRING`

### 2.3.7 2023-11-09
* Added: Member Content: Output manual or generated excerpt if no read more tag present in the Post's content
* Fix: Member Content: Force padding on buttons to prevent Themes overriding button layout
* Fix: Member Content: Add `required` attribute on form fields

### 2.3.6 2023-11-02
* Added: Member Content: Updated UI of gated content screens to better match Kit
* Added: Settings: Member Content: Separate text settings can be configured for display when restricting by Kit Tag

### 2.3.5 2023-10-30
* Added: Member Content: Improve UI of authentication code screen
* Fix: Don't attempt to append Kit Forms to unsupported Post Types

### 2.3.4 2023-10-24
* Added: Broadcasts (Beta): Define WordPress Post status (Draft, Pending Review, Private or Published) when importing Kit Broadcasts
* Added: Settings: General: Option to display a site wide non-inline form
* Updated: WordPress Libraries to 1.4.0

### 2.3.3 2023-10-18
* Added: Broadcasts (Beta): Option to export WordPress Posts to draft Kit Broadcasts
* Added: Member Content: Wizard: Option to restrict content by Kit Tag
* Fix: Member Content: Check Product or Tag exists in Kit before restricting content
* Fix: Form Trigger Block: Add spacing to button on non-block themes
* Fix: Form Trigger Block: Render button in Gutenberg to better match frontend output when changing background color
* Fix: Product Block: Add spacing to button on non-block themes
* Fix: Product Block: Render button in Gutenberg to better match frontend output when changing background color

### 2.3.2 2023-10-05
* Added: Member Content: Option to restrict content by Kit Tag, displaying a subscription form and subscribing the entered email address to the tag
* Added: Member Content: Posts: Display Filter dropdown in Posts table
* Fix: Member Content: Always enable Member Content options, ensuring imported Paid Broadcasts correctly show / hide content.
* Fix: Prevent blank submenu entries displaying under `Dashboard` menu when using a third party admin menu editor Plugin
* Updated: Kit WordPress Libraries to 1.3.9

### 2.3.1 2023-09-14
* Fix: Settings: Member Content: Added missing`for` label attributes
* Fix: Settings: Broadcasts: Added missing`for` label attributes
* Fix: Posts: Add / Edit Category: `for` label attribute now matches the field ID
* Fix: Select2: Remove whitespace on tooltip hover
* Fix: Blocks: Include `editorScript` in `block.json`

### 2.3.0 2023-09-12
* Added: Forminator: Option to map Forminator Forms to Kit Forms, to subscribe email addresses at Settings > Kit > Forminator
* Added: Forminator: Option to Enable Creator Network Recommendations modal on individual Forms at Settings > Kit > Forminator
* Added: Blocks: Register blocks using block.json
* Fix: Landing Pages: Use WordPress Site Icon as favicon, if defined

### 2.2.9 2023-09-06
* Added: Broadcasts (Beta): Automatically publish public Kit Broadcasts as WordPress Posts. Head over to `Settings > Kit > Broadcasts` to get started.
* Updated: WordPress Coding Standards
* Updated: Kit WordPress Libraries to 1.3.8

### 2.2.8 2023-08-07
* Fix: Use `file_get_contents` instead of `WP_Filesystem` for reading plugin files, to avoid fatal error on activation when file ownership/permission issues occur
* Fix: Block Editor: Prevent block error in WordPress 6.0 and lower by checking if `useAnchor` is available

### 2.2.7 2023-07-24
* Added: Contact Form 7: Option to Enable Creator Network Recommendations modal on individual Forms at Settings > Kit > Contact Form 7

### 2.2.6 2023-07-18
* Added: Form Trigger: Block: When no API Key specified, link to Setup Wizard in a popup window to complete setup
* Added: Form: Block: When no API Key specified, link to Setup Wizard in a popup window to complete setup
* Added: Product: Block: When no API Key specified, link to Setup Wizard in a popup window to complete setup
* Updated: Member Content: Removed beta label

### 2.2.5 2023-06-21
* Added: Broadcasts: Shortcode: Tabbed UI when adding broadcasts through the Classic or Text Editor
* Added: Broadcasts: Block: Moved pagination settings to own sidebar panel
* Fix: Classic Editor: Insert button would stop working when switching from Text Editor to Classic Editor
* Fix: Uncaught Error: Call to undefined method Kit_Resource_Forms::get_by()

### 2.2.4 2023-06-15
* Added: Form Trigger: Block: Display message with link when no API Key specified, or no non-inline Forms exist in Kit
* Added: Form Trigger: Shortcode: Display message with link when no API Key specified, or no non-inline Forms exist in Kit
* Added: Forms: Shortcode: Display message with link when no API Key specified, or no inline Forms exist in Kit
* Added: Products: Shortcode: Display message with link when no API Key specified, or no Products exist in Kit
* Fix: Bulk & Quick Edit: Show contextual icons for Form, Tag and Member Content settings, instead of the default Form icon
* Fix: Settings: Conditionally load CSS and JS depending on the section (General, Tools, Member Content)
* Fix: Settings: Link to Kit form creator when no Forms exist in Kit
* Fix: Use higher quality SVG icons for blocks, shortcodes and formatters 
* Updated: Kit WordPress Libraries to 1.3.6

### 2.2.3 2023-06-06
* Added: Broadcasts: Options to display grid, images, descriptions and/or read more link
* Added: Broadcasts: Output as single column on smaller screen resolutions
* Added: Forms: Block: Display message with link when no API Key specified, or no Forms exist in Kit
* Added: Products: Block: Display message with link when no API Key specified, or no Products exist in Kit
* Fix: Settings: Disable CSS: Improve description of Disable CSS functionality, making it clearer what this setting does
* Fix: Use `esc_url` instead of `esc_attr` for link `href` properties

### 2.2.2 2023-05-24
* Added: Elementor: Kit Form Trigger Block
* Added: Member Content: Automatically configure WP Fastest Cache and WP-Optimize Plugins to not cache when the `ck_subscriber_id` cookie is present, to ensure Member Content correctly displays
* Added: Member Content: Display a notice if Litespeed Cache, W3 Total Cache or WP Super Cache Plugins are active and have not been configured to exclude caching when the `ck_subscriber_id` cookie is present
* Fix: Elementor: Kit Product: Button icon was missing
* Fix: Block Editor: Don't display options to link text to display a non-inline form if no forms exist in Kit
* Fix: Block Editor: Don't display options to link text to display a Product or Tip Jar if no Product / Tip Jar exists in Kit

### 2.2.1 2023-05-10
* Fix: Settings: Escape tab links on output

### 2.2.0 2023-05-04
* Added: Kit Form Trigger Block, outputting a button which displays a non-inline form (modal, slide in, sticky bar) when pressed
* Added: Kit Form Trigger Shortcode, outputting a button which displays a non-inline form (modal, slide in, sticky bar) when pressed
* Added: Block Editor: Link text to display a non-inline form (modal, slide in, sticky bar) when pressed
* Added: Block Editor: Link text to display a Kit Product or Tip Jar when pressed
* Fix: Forms: Output non-inline scripts once per form, to avoid the same form displaying twice when embedded two or more times in a page
* Fix: Forms: Output non-inline scripts using the `wp_footer` hook, ensuring modal overlays fill the screen
* Fix: Member Content: Append `ck-cache-bust` query parameter after entering code, to prevent plugin / host caching showing stale data
* Fix: Settings: Tools: Import / Export: Include Member Content settings in import and export configuration
* Fix: Settings: Member Content: Display warning notice that web host caching / caching plugins must be configured to disable caching when the `ck_subscriber_id` cookie is present

### 2.1.3 2023-04-06
* Fix: Improve UI compatibility for buttons in WordPress 5.x, using `button-hero` CSS class instead of custom padding 
* Updated: Kit WordPress Libraries to 1.3.4

### 2.1.2 2023-03-30
* Added: Link to Setup Wizard on Plugins screen
* Added: Improved Kit Icons in Classic Editor and block editor for Broadcasts, Forms, Products and Custom Content

### 2.1.1 2023-02-23
* Fix: Post: Settings: PHP notices when settings are not an array
* Fix: Landing Pages and Legacy Forms: Deprecated `mb_convert_encoding()` message in PHP 8.2

### 2.1.0 2023-02-15
* Added: Member Content (Beta): Require subscribers to purchase a Kit Product to access specific Pages on your WordPress site. Head over to `Settings > Kit > Member Content` to get started.
* Fix: Product: Block and Shortcode: Set stylesheet ID to `convertkit-product-css`, to match other blocks
* Fix: Blocks: Use wp.serverSideRender instead of soon to be deprecated wp.components.ServerSideRender
* Fix: Forms: Preview: Support for previewing and editing Legacy Forms
* Fix: Improved performance in WordPress Admin when invalid API credentials specified on new installation
* Fix: Display notice in WordPress Admin with link to settings screen when invalid API credentials specified

### 2.0.8 2023-02-02
* Added: Settings: Kit: Documentation tab
* Added: Forms: Link to edit form in Kit when previewing a Page, Post or Custom Post containing a Kit form
* Fix: Display Forms, Landing Pages, Products and Tags in alphabetical order when listed in a `<select>` dropdown
* Fix: Form: Block and Shortcode: Check Forms exist in Kit before outputting Block / Shortcode options
* Fix: Form: Shortcode: Remove unused API Key output
* Fix: Product: Block: Preview: Improved performance when previewing the Product block to determine if a Kit Product was specified in the Block's settings
* Fix: Product: Shortcode: Remove unused API Key and data-attributes output

### 2.0.7 2023-01-16
* Fix: Elementor 3.9.0+ compatibility
* Updated: Kit WordPress Libraries to 1.3.0

### 2.0.6 2023-01-05
* Fix: Honor "Add a tag" setting when enabled on a Page/Post
* Fix: PHP Warning: Cannot modify header information - headers already sent, when ?ck_subscriber_id included in request URI in some Page Builders (e.g. Elementor)
* Fix: PHP Warning: Trying to access array offset on value of type null

### 2.0.5 2022-12-15
* Fix: Broadcasts: Strip slashes on output when pagination clicked and Broadcasts are reloaded
* Fix: Broadcasts: Sanitize and escape HTML attributes on output
* Fix: Forms: Escape HTML attributes on output
* Fix: Products: Sanitize and escape HTML attributes on output

### 2.0.4 2022-12-13
* Fix: Products: PHP warning when attempting to parse an invalid Product URL
* Fix: Landing Pages: Catch and log when an error occurs fetching a Landing Page
* Fix: Remove double forwardslash on product.css

### 2.0.3 2022-12-08
* Added: Categories: Option to specify Kit Form to display when adding a new Post Category
* Fix: Bulk & Quick Edit: Improve layout of Kit settings on desktop and mobile
* Fix: Post: Improve layout of Kit settings on desktop and mobile
* Fix: Categories: Improve layout of Kit settings on desktop and mobile
* Fix: Products: Block: Display preview when adding new block

### 2.0.2 2022-11-21
* Fixed: Removed argument count on `in_admin_footer` action calls

### 2.0.1 2022-11-01
* Added: Broadcasts: Block: Display message in editor when no Broadcasts exist in Kit
* Fixed: Settings: Contact Form 7: Render screen correctly when no Forms in Kit
* Fixed: Settings: WishList Member: Render screen correctly when no Forms in Kit

### 2.0.0 2022-10-24
* Added: Kit Products Block, to output a button linking to a Kit Product or Tip Jar
* Added: Kit Products Shortcode, to output a button linking to a Kit Product or Tip Jar
* Added: Gutenberg: Option to link text or button to a Kit Product or Tip Jar
* Added: Classic Editor: Option to link text or button to a Kit Product or Tip Jar
* Added: Settings: Improved UI

### 1.9.8.5 2022-10-03
* Added: Broadcasts: Shortcode: Options to specify background, text and link colors
* Added: Broadcasts: Elementor: Options to specify background, text and link colors
* Added: Settings: General: Links added to preview Default Form for each Post Type

### 1.9.8.4 2022-09-08
* Added: Setup Wizard for new installations
* Fix: Text Editor: Quicktag Buttons: Position and size modal window correctly to avoid scrollbars and whitespace
* Fix: Widgets: Legacy Forms Widget: "The convertkit_form block was affected by errors and may not function properly" when attempting to add legacy form widget
* Development: Moved /lib folder to managed repository

### 1.9.8.3 2022-08-19
* Added: Settings: Tools: Use WordPress' Site Info to populate System Info section
* Added: Refresh button: Show error notification when refreshing fails
* Fix: Widgets: Broadcasts Block: JSON response error when attempting to save Broadcasts Block in a Widget area
* Fix: Classic (Visual) and Text Editor: Insert shortcode into correct editor when multiple editor instances exist (e.g. WooCommerce Products)

### 1.9.8.2 2022-08-04
* Fix: API: Show error notification when API returns HTTP 500 and 502 errors, instead of showing PHP warnings
* Fix: Bulk and Quick Edit: `for` label attribute now matches the field ID

### 1.9.8.1 2022-07-18
* Added: Refresh button for Form, Landing Page and Tag fields to fetch latest data from Kit account
* Fix: Bulk Edit: Don't display fields when no Pages / Posts exist

### 1.9.8.0 2022-07-14
* Added: Bulk and Quick Edit Form and Tag when viewing list of Pages/Posts
* Fix: Performance: Don't perform API requests on every WordPress Administration screen when no Forms, Tags or Landing Pages exist

### 1.9.7.9 2022-06-24
* Fix: API: Prevent fatal error when API returns null instead of expected array

### 1.9.7.8 2022-06-23
* Added: Elementor Page Builder: Kit Broadcasts Widget
* Fix: Integration: WishList Member: Unsubscribe email address from Kit if 'unsubscribe' configured and member level removed
* Fix: Remove double forwardslash on some enqueued scripts and styles 

### 1.9.7.7 2022-06-09
* Added: Broadcasts: Option to enable pagination on block/shortcode

### 1.9.7.6 2022-06-01
* Added: Kit Broadcasts Block when editing Widgets using the block editor in WordPress 5.8+
* Added: Kit Form Block when editing Widgets using the block editor in WordPress 5.8+
* Fix: Kit Broadcasts Block/Shortcode: Fetch all Broadcasts from Kit, not just the first 50
* Fix: Settings: Added label element for setting field names

### 1.9.7.5 2022-05-12
* Fix: PHP Warning: Cannot modify header information, caused by QuickTags modal template output
* Fix: Text Editor: Quicktag Buttons: Block could not be found error when using a Quicktag

### 1.9.7.4 2022-05-04
* Added: Kit Broadcasts Block, to output a list of Kit broadcasts
* Added: Kit Broadcasts Shortcode [convertkit_broadcasts], to output a list of Kit broadcasts
* Added: Settings: Tools: Import and Export configuration
* Fix: Page/Post: If a specific Form is selected that no longer exists in Kit, fallback to the Default Form setting

### 1.9.7.3 2022-04-04
* Added: Elementor Page Builder: Kit Form Widget
* Fix: Default Form would not display on Posts assigned to Categories, where Categories were created prior to 1.9.6.0 and site uses PHP 8.0 or greater
* Fix: Categories: Improved wording of Form setting on per-Category level

### 1.9.7.2 2022-03-30
* Fix: Default Form would not display on Posts due to regression in 1.9.7.1

### 1.9.7.1 2022-03-23
* Fix: Default Form would not display on Posts due to regression in 1.9.7.0

### 1.9.7.0 2022-03-17
* Fix: Kit Form Block: Order Form names alphabetically
* Fix: Prevent Select2 styling from applying to non-Plugin elements

### 1.9.6.9 2022-03-07
* Added: Kit Form Block: When editing, display the Form Name if a non-inline form has been selected, as non-inline forms cannot be previewed in the editor
* Fix: Include email address in API request when attempting to fetch subscriber ID by email when Kit Form is submitted with no email address

### 1.9.6.8 2022-02-18
* Fix: Performance: Don't query API to fetch subscriber ID by email when Kit Form is submitted with no email address

### 1.9.6.7 2022-02-14
* Fix: Localization: Corrected path to load language files

### 1.9.6.6 2022-01-27
* Fix: Plugin Activation: Parse error when using PHP 7.2 or below due to trailing comma in sprintf() call

### 1.9.6.5 2022-01-26
* Added: Kit Form Block for Gutenberg
* Added: Select2 dropdown for Forms, Landing Pages and Tags with search functionality for improved UX.
* Fix: Legacy Forms: Removed erronous <html>, <head> and <body> tags from markup 

### 1.9.6.4 2022-01-11
* Fix: Render Legacy Form when shortcode is copied from app.kit.com for a Legacy Form
* Fix: Don't check for Landing Page when viewing any non-Page public Post Type which doesn't support Landing Pages
* Fix: PHP Notice: Undefined index landing_page when upgrading from 1.4.6 or earlier
* Fix: PHP Notice: Undefined index tag when upgrading from 1.4.6 or earlier

### 1.9.6.3 2021-12-23
* Fix: Render Legacy Landing Pages

### 1.9.6.2 2021-12-22
* Fix: Render Form Shortcode when a new Kit Form ID specified that does not yet exist in Plugin's cached Form Resources

### 1.9.6.1 2021-12-16
* Fix: Character encoding issue on Landing Pages
* Fix: Removed unused .scripts directory and .MD files

### 1.9.6 2021-12-15
* Added: Kit Form Shortcode Button for Classic Editor
* Added: Text Editor: Quicktag Buttons for inserting Kit Forms and Custom Content
* Added: Settings: Kit: Logo and branding header
* Added: Option to specify Kit API Key and Secret as constants `CONVERTKIT_API_KEY` and `CONVERTKIT_API_SECRET` in wp-config.php
* Added: Settings: Kit: General: Different Default Forms can be specified for Pages and Posts
* Added: Settings: Kit: General: Enabling Debug option will also output data to browser console and inline HTML comments
* Added: Settings: Kit: Tools: Option to Download Log to text file
* Added: Settings: Kit: Tools: Option to Download System Info to text file
* Added: PHP 8.x compatibility
* Added: Developers: Action and filter hooks.  See https://github.com/convertkit/convertkit-wordpress/blob/1.9.6/ACTIONS-FILTERS.md
* Fix: PHP warnings on new installations when adding/editing Pages or Posts where the plugin was not yet configured
* Fix: PHP 8.x: PHP Deprecated warnings where required parameters wrongly followed optional parameters
* Fix: gzinflate() data error
* Fix: Deprecated edit_category_form_fields warning
* Fix: Integration: WishList Member: Unsubscribe Action 'Unsubscribe from all' now honored when selected and saved
* Fix: Ensure code meets WordPress Coding Standards
* Fix: Use WP_Filesystem instead of PHP functions to read/write log file, per WordPress Coding Standards

[See changelog for all versions](https://github.com/convertkit/convertkit-wordpress/CHANGELOG.md).

== Upgrade notice ==