| 1 |
=== ConvertKit - Email Newsletter, Email Marketing, Subscribers and Landing Pages === |
| 2 |
Contributors: nathanbarry, growdev, travisnorthcutt, ggwicz |
| 3 |
Donate link: https://convertkit.com |
| 4 |
Tags: email marketing, email newsletter, newsletter, subscribers, membership |
| 5 |
Requires at least: 5.0 |
| 6 |
Tested up to: 6.5 |
| 7 |
Requires PHP: 5.6.20 |
| 8 |
Stable tag: 2.4.7 |
| 9 |
License: GPLv2 or later |
| 10 |
License URI: http://www.gnu.org/licenses/gpl-2.0.html |
| 11 |
|
| 12 |
== Description == |
| 13 |
|
| 14 |
[ConvertKit](https://convertkit.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. |
| 15 |
|
| 16 |
**New to ConvertKit? [Creating an account](https://app.convertkit.com/users/signup?plan=1k&utm_source=wordpress&utm_term=en_US&utm_content=readme) is 100% free for your first 1,000 subscribers, making ConvertKit an email marketing solution for everyone - whether you're new to email marketing or a seasoned professional email marketer.** |
| 17 |
|
| 18 |
### Email Newsletter and Email Marketing Features |
| 19 |
|
| 20 |
- Design [email newsletter subscription forms](https://convertkit.com/features/forms?utm_source=wordpress&utm_term=en_US&utm_content=readme) in ConvertKit, 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 subscriber lists. |
| 21 |
- Build [landing pages](https://convertkit.com/features/landing-pages?utm_source=wordpress&utm_term=en_US&utm_content=readme) in ConvertKit, and display them on a WordPress page to capture email subscribers |
| 22 |
- List past [email newsletters](https://convertkit.com/features/email-marketing?utm_source=wordpress&utm_term=en_US&utm_content=readme) on your WordPress site |
| 23 |
|
| 24 |
= Forms = |
| 25 |
|
| 26 |
Design [forms](https://convertkit.com/features/forms?utm_source=wordpress&utm_term=en_US&utm_content=readme) in ConvertKit, choosing from a variety of designs, customisable to your branding. |
| 27 |
|
| 28 |
Sign up forms can be configured to: |
| 29 |
|
| 30 |
- Send free content, such as a PDF |
| 31 |
- Display when the user is about to leave the page |
| 32 |
- Subscribe to an email newsletter, with powerful tagging and segmentation options |
| 33 |
|
| 34 |
Embedding ConvertKit forms on your WordPress web site with the ConvertKit Plugin is quick and simple: |
| 35 |
|
| 36 |
- Choose a default form to be displayed below each individual Post Type (Pages, Posts and other public Post Types, such as WooCommerce Products) |
| 37 |
- Choose a specific email marketing form to be displayed below a specific Page, Post or custom post type |
| 38 |
- Turn off form embedding at both site wide and/or individual Page/Post level |
| 39 |
|
| 40 |
For greater control, ConvertKit's email marketing subscription forms can be displayed in specific sections of your WordPress site's content, sidebars and footers by: |
| 41 |
|
| 42 |
- Using the ConvertKit Forms block in Gutenberg |
| 43 |
- Using the `[convertkit]` shortcode in the Classic Editor |
| 44 |
|
| 45 |
Start collecting email subscribers today! |
| 46 |
|
| 47 |
### Send Email Newsletters |
| 48 |
|
| 49 |
Use ConvertKit's [email marketing](https://convertkit.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. |
| 50 |
|
| 51 |
Embed existing email newsletters on your WordPress web site, ensuring visitors never miss your email newsletter content, by: |
| 52 |
|
| 53 |
- Using the ConvertKit Broadcasts block in Gutenberg |
| 54 |
- Using the `[convertkit_broadcasts]` shortcode in the Classic Editor |
| 55 |
|
| 56 |
= Landing Pages = |
| 57 |
|
| 58 |
Design [landing pages](https://convertkit.com/features/landing-pages?utm_source=wordpress&utm_term=en_US&utm_content=readme) in ConvertKit's intuitive editor, choosing from a variety of designs, customisable to your branding and ideal for building your email marketing list or selling a product. |
| 59 |
|
| 60 |
Landing pages can then be embedded on your WordPress web site. Simply create or edit a WordPress Page, choose the ConvertKit landing page from the ConvertKit meta box settings to display, and you're all set to begin growing your email subscribers list. |
| 61 |
|
| 62 |
= Sell Products = |
| 63 |
|
| 64 |
Embed buttons (or link text) to sell your ConvertKit Products in seconds - whether that's digital goods, paid email newsletters, music, coaching and more. |
| 65 |
|
| 66 |
### List Email Newsletters |
| 67 |
|
| 68 |
Automatically publish your past email newsletters to WordPress Posts, defining a WordPress author, category and cut-off date within the Plugin's settings. |
| 69 |
|
| 70 |
Prefer to just list existing broadcasts, each linked to your ConvertKit profile? Use the Broadcasts block or shortcode to embed your existing newsletters in any WordPress Page, Post or Custom Post Type. |
| 71 |
|
| 72 |
### Paid (and free) Membership Sites |
| 73 |
|
| 74 |
Require email subscribers to either purchase a [ConvertKit Product](https://convertkit.com/features/commerce), or subscribe for free, to access your content with ConvertKit's Member Content feature - whether that's a course, ebook, digital download, album, presets, coaching and more. |
| 75 |
|
| 76 |
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. |
| 77 |
|
| 78 |
There's no limit to the number of ConvertKit 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. |
| 79 |
|
| 80 |
= Plugin Integrations = |
| 81 |
|
| 82 |
With the ConvertKit for WordPress Plugin, you also get integrations with: |
| 83 |
|
| 84 |
- Elementor: Form and Broadcast widgets natively integrated with Elementor, to embed ConvertKit forms and broadcast lists |
| 85 |
- Contact Form 7: Automatically add email subscribers to ConvertKit when they submit a Contact Form 7 form |
| 86 |
- WishList Member: Automatically subscribe, unsubscribe and tag users based on their membership level |
| 87 |
|
| 88 |
Our other WordPress Plugins provide further integrations between WordPress and ConvertKit: |
| 89 |
|
| 90 |
- [ConvertKit for WooCommerce](https://wordpress.org/plugins/convertkit-for-woocommerce/): Subscribe, tag and assign sequences to customers at checkout, and send order data to ConvertKit |
| 91 |
- [ConvertKit for Gravity Forms](https://wordpress.org/plugins/convertkit-gravity-forms/): Automatically add email subscribers to ConvertKit when they submit a Gravity Form, with tagging options |
| 92 |
|
| 93 |
= What is ConvertKit? = |
| 94 |
|
| 95 |
ConvertKit is the go-to email marketing hub for creators that helps you grow and monetize your audience with ease. |
| 96 |
|
| 97 |
**Grow your audience:** Increase subscribers with beautiful landing pages, sign up forms, and link pages that make your work stand out. |
| 98 |
|
| 99 |
**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. |
| 100 |
|
| 101 |
**Sell your digital products:** Market and sell your digital products and subscriptions with ConvertKit to drive higher conversions and save big on fees. |
| 102 |
|
| 103 |
= Documentation = |
| 104 |
|
| 105 |
Full Plugin documentation can be found [here](https://help.convertkit.com/en/articles/2502591-the-convertkit-wordpress-plugin?utm_source=wordpress&utm_term=en_US&utm_content=readme). |
| 106 |
|
| 107 |
== Installation == |
| 108 |
|
| 109 |
1. Upload the `convertkit` folder to the `/wp-content/plugins/` directory |
| 110 |
2. Active the ConvertKit plugin through the 'Plugins' menu in WordPress |
| 111 |
|
| 112 |
== Configuration == |
| 113 |
|
| 114 |
1. Configure the plugin by navigating to `Settings > ConvertKit` in the WordPress Administration Menu, entering your [API Key](https://app.convertkit.com/account_settings/advanced_settings?utm_source=wordpress&utm_term=en_US&utm_content=readme) and defining the default forms to display on Pages, Posts and/or Custom Post Types |
| 115 |
2. (Optional) choose a specific Form to display when editing a Page, Post or Custom Post Type in the Page/Post/Custom Post Type's ConvertKit settings |
| 116 |
3. (Optional) use the ConvertKit Form Shortcode or Block to insert Forms into your Page, Post or Custom Post Type content |
| 117 |
|
| 118 |
== Frequently asked questions == |
| 119 |
|
| 120 |
= Does this plugin require a paid service? = |
| 121 |
|
| 122 |
No. You must first have an account on [convertkit.com](https://convertkit.com?utm_source=wordpress&utm_term=en_US&utm_content=readme), but you do not have to use a paid plan! |
| 123 |
|
| 124 |
= How do I refresh my available Forms, Landing Pages and Tags? = |
| 125 |
|
| 126 |
Either: |
| 127 |
|
| 128 |
- Navigate to the Plugin's Settings at `Settings > ConvertKit` |
| 129 |
- Click the refresh button displayed next to the Form, Landing Page or Tag fields when creating/editing Pages or Posts |
| 130 |
|
| 131 |
= How do I automatically import ConvertKit Broadcasts to WordPress Posts? = |
| 132 |
|
| 133 |
To import your past (and future) email newsletters from ConvertKit to WordPress: |
| 134 |
|
| 135 |
- Navigate to the Plugin's Settings at `Settings > ConvertKit` |
| 136 |
- Click the `Broadcasts` tab |
| 137 |
- Tick the `Enable Automatic Import` option |
| 138 |
- Configure other settings as necessary, and click `Save Changes` when done |
| 139 |
|
| 140 |
= Where can I find the Plugin's Documentation? = |
| 141 |
|
| 142 |
Full Plugin documentation can be found [here](https://help.convertkit.com/en/articles/2502591-the-convertkit-wordpress-plugin?utm_source=wordpress&utm_content=readme). |
| 143 |
|
| 144 |
== Screenshots == |
| 145 |
|
| 146 |
1. Create and customize stunning email subscription forms and landing pages in ConvertKit |
| 147 |
2. Manage the WordPress plugin from a simple settings page in the WordPress admin |
| 148 |
3. Append ConvertKit forms to Pages, Posts or other Custom Post Types |
| 149 |
4. Configure a specific ConvertKit form to display on a specific Page or Post |
| 150 |
5. Display your ConvertKit forms anywhere on your WordPress web site using the form block / shortcode |
| 151 |
6. Configure a ConvertKit landing page to be used in place of a WordPress Page, to capture email subscribers |
| 152 |
7. Automatically import your past email newsletters to WordPress Posts |
| 153 |
8. Create your paid membership site by assigning paid ConvertKit Products to your existing WordPress content |
| 154 |
9. Set up form and landing page automations in ConvertKit |
| 155 |
10. Track subscriber growth |
| 156 |
|
| 157 |
== Changelog == |
| 158 |
|
| 159 |
### 2.4.7 2024-04-08 |
| 160 |
* Fix: WP-Rocket: Display Forms when WP-Rocket's `Delay JavaScript Execution` option is enabled |
| 161 |
* Fix: Perfmatters: Display Forms when Perfmatters' `Delay JavaScript` option is enabled |
| 162 |
* Fix: Broadcasts (Beta): Improve parsing of Broadcasts when removing unsubscribe and hidden sections |
| 163 |
|
| 164 |
### 2.4.6 2024-03-08 |
| 165 |
* Fix: Debug Log: Change log file location to log subfolder, with .htaccess and index.html protection |
| 166 |
* Fix: Debug Log: Mask email addresses, first names and signed subscriber IDs |
| 167 |
|
| 168 |
### 2.4.5 2024-02-28 |
| 169 |
* Added: Products: Block and Shortcode: Option to immediately load checkout step when button clicked, instead of Product image and description |
| 170 |
* Fix: Siteground Speed Optimizer: Display Forms when Siteground's `Combine JavaScript Files` option is enabled |
| 171 |
* Fix: LiteSpeed Cache: Don't output duplicate non-inline Forms when LiteSpeed Cache's `Load JS Deferred` option is enabled |
| 172 |
* Fix: Member Content: Improved UI on mobile devices |
| 173 |
|
| 174 |
### 2.4.4 2024-02-19 |
| 175 |
* Added: Remove jQuery as a dependency from Setup Wizard, Modals and Refresh buttons |
| 176 |
* Added: Forms: Automatically center inline forms on non-block Themes |
| 177 |
* Fix: Forms: Remove bottom margin on non-inline forms |
| 178 |
* Fix: Setup Wizard: Preview Form link for Pages would incorrectly display a Post |
| 179 |
* Fix: Landing Pages: Prevent WP Rocket caching and lazy loading images on Landing Pages, which would result in missing background images |
| 180 |
* Fix: Classic Editor: Modal window: Don't display vertical scrollbar on Safari |
| 181 |
* Fix: Member Content: Refresh button: Populate Tags and Products in applicable option groups |
| 182 |
* Fix: Member Content: Refresh button: Define correct option values on refresh, ensuring settings save successfully. |
| 183 |
* Fix: Member Content: Corrected grammar for `member-only` |
| 184 |
|
| 185 |
### 2.4.3 2024-01-31 |
| 186 |
* Added: Settings: Option to specify Default Form on public Custom Post Types |
| 187 |
* Added: Custom Posts: Option to specify Form and Tag on individual public Custom Post Types |
| 188 |
* Added: Member Content: Support for Member Content functionality on public Custom Post Types |
| 189 |
* Added: Removed jQuery as a dependency from Bulk Edit, Quick Edit and TinyMCE JS |
| 190 |
* Fix: Divi: Allow scrolling when editing using the Divi Builder in tablet or mobile view |
| 191 |
* Fix: Jetpack Boost: Prevent inline Forms from displaying in footer when added to a Page or Widget area when Jetpack Boost Plugin active |
| 192 |
* Fix: Settings: Remove whitespaces from API Key and Secret when saving |
| 193 |
* Fix: Broadcasts (Beta): Improve descriptions to make clear that only public Broadcasts are imported to WordPress |
| 194 |
|
| 195 |
### 2.4.2 2024-01-22 |
| 196 |
* Added: Member Content: Option to permit search engines to crawl Member Content at `ConvertKit > Member Content > Permit Search Engine Crawlers` |
| 197 |
* Added: Removed jQuery from frontend JS and as a dependency |
| 198 |
* Fix: Site Editor: Use `enqueue_block_assets` hook instead of `enqueue_block_editor_assets` hook |
| 199 |
* Updated: WordPress Libraries to 1.4.1 |
| 200 |
|
| 201 |
### 2.4.1 2024-01-08 |
| 202 |
* Added: Broadcasts (Beta): Option to store ConvertKit Broadcast thumbnails as WordPress Post's Featured Image |
| 203 |
* Added: Products: Block and Shortcode: Option to include a discount code |
| 204 |
* Added: Products: Block and Shortcode: Option to disable modal on mobile. Recommended if the ConvertKit Product is a digital download (PDF) being purchased on mobile, to ensure the subscriber can immediately download the PDF once purchased. |
| 205 |
|
| 206 |
### 2.4.0 2023-12-06 |
| 207 |
* Fix: ConvertKit Error: Could not load Plugin class `output` when editing, quick or bulk editing a Post. |
| 208 |
|
| 209 |
### 2.3.9 2023-12-04 |
| 210 |
* Added: Settings: Display ConvertKit Form's format (inline, slide in, sticky bar, modal) where a `select` dropdown option is presented |
| 211 |
* 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 |
| 212 |
* Fix: Settings: Moved Documentation tab to Help link in header, for compat. with smaller screen resolutions |
| 213 |
|
| 214 |
### 2.3.8 2023-11-20 |
| 215 |
* Added: Member Content: Display log in and authentication code forms in modal to better match ConvertKit |
| 216 |
* Added: Broadcasts (Beta): Define WordPress Post Author when importing ConvertKit Broadcasts |
| 217 |
* Fix: Broadcasts (Beta): Don't show next scheduled date and time immediately after clicking `Import Now` |
| 218 |
* Fix: PHP Warning: Use of deprecated `FILTER_SANITIZE_STRING` |
| 219 |
|
| 220 |
### 2.3.7 2023-11-09 |
| 221 |
* Added: Member Content: Output manual or generated excerpt if no read more tag present in the Post's content |
| 222 |
* Fix: Member Content: Force padding on buttons to prevent Themes overriding button layout |
| 223 |
* Fix: Member Content: Add `required` attribute on form fields |
| 224 |
|
| 225 |
### 2.3.6 2023-11-02 |
| 226 |
* Added: Member Content: Updated UI of gated content screens to better match ConvertKit |
| 227 |
* Added: Settings: Member Content: Separate text settings can be configured for display when restricting by ConvertKit Tag |
| 228 |
|
| 229 |
### 2.3.5 2023-10-30 |
| 230 |
* Added: Member Content: Improve UI of authentication code screen |
| 231 |
* Fix: Don't attempt to append ConvertKit Forms to unsupported Post Types |
| 232 |
|
| 233 |
### 2.3.4 2023-10-24 |
| 234 |
* Added: Broadcasts (Beta): Define WordPress Post status (Draft, Pending Review, Private or Published) when importing ConvertKit Broadcasts |
| 235 |
* Added: Settings: General: Option to display a site wide non-inline form |
| 236 |
* Updated: WordPress Libraries to 1.4.0 |
| 237 |
|
| 238 |
### 2.3.3 2023-10-18 |
| 239 |
* Added: Broadcasts (Beta): Option to export WordPress Posts to draft ConvertKit Broadcasts |
| 240 |
* Added: Member Content: Wizard: Option to restrict content by ConvertKit Tag |
| 241 |
* Fix: Member Content: Check Product or Tag exists in ConvertKit before restricting content |
| 242 |
* Fix: Form Trigger Block: Add spacing to button on non-block themes |
| 243 |
* Fix: Form Trigger Block: Render button in Gutenberg to better match frontend output when changing background color |
| 244 |
* Fix: Product Block: Add spacing to button on non-block themes |
| 245 |
* Fix: Product Block: Render button in Gutenberg to better match frontend output when changing background color |
| 246 |
|
| 247 |
### 2.3.2 2023-10-05 |
| 248 |
* Added: Member Content: Option to restrict content by ConvertKit Tag, displaying a subscription form and subscribing the entered email address to the tag |
| 249 |
* Added: Member Content: Posts: Display Filter dropdown in Posts table |
| 250 |
* Fix: Member Content: Always enable Member Content options, ensuring imported Paid Broadcasts correctly show / hide content. |
| 251 |
* Fix: Prevent blank submenu entries displaying under `Dashboard` menu when using a third party admin menu editor Plugin |
| 252 |
* Updated: ConvertKit WordPress Libraries to 1.3.9 |
| 253 |
|
| 254 |
### 2.3.1 2023-09-14 |
| 255 |
* Fix: Settings: Member Content: Added missing`for` label attributes |
| 256 |
* Fix: Settings: Broadcasts: Added missing`for` label attributes |
| 257 |
* Fix: Posts: Add / Edit Category: `for` label attribute now matches the field ID |
| 258 |
* Fix: Select2: Remove whitespace on tooltip hover |
| 259 |
* Fix: Blocks: Include `editorScript` in `block.json` |
| 260 |
|
| 261 |
### 2.3.0 2023-09-12 |
| 262 |
* Added: Forminator: Option to map Forminator Forms to ConvertKit Forms, to subscribe email addresses at Settings > ConvertKit > Forminator |
| 263 |
* Added: Forminator: Option to Enable Creator Network Recommendations modal on individual Forms at Settings > ConvertKit > Forminator |
| 264 |
* Added: Blocks: Register blocks using block.json |
| 265 |
* Fix: Landing Pages: Use WordPress Site Icon as favicon, if defined |
| 266 |
|
| 267 |
### 2.2.9 2023-09-06 |
| 268 |
* Added: Broadcasts (Beta): Automatically publish public ConvertKit Broadcasts as WordPress Posts. Head over to `Settings > ConvertKit > Broadcasts` to get started. |
| 269 |
* Updated: WordPress Coding Standards |
| 270 |
* Updated: ConvertKit WordPress Libraries to 1.3.8 |
| 271 |
|
| 272 |
### 2.2.8 2023-08-07 |
| 273 |
* 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 |
| 274 |
* Fix: Block Editor: Prevent block error in WordPress 6.0 and lower by checking if `useAnchor` is available |
| 275 |
|
| 276 |
### 2.2.7 2023-07-24 |
| 277 |
* Added: Contact Form 7: Option to Enable Creator Network Recommendations modal on individual Forms at Settings > ConvertKit > Contact Form 7 |
| 278 |
|
| 279 |
### 2.2.6 2023-07-18 |
| 280 |
* Added: Form Trigger: Block: When no API Key specified, link to Setup Wizard in a popup window to complete setup |
| 281 |
* Added: Form: Block: When no API Key specified, link to Setup Wizard in a popup window to complete setup |
| 282 |
* Added: Product: Block: When no API Key specified, link to Setup Wizard in a popup window to complete setup |
| 283 |
* Updated: Member Content: Removed beta label |
| 284 |
|
| 285 |
### 2.2.5 2023-06-21 |
| 286 |
* Added: Broadcasts: Shortcode: Tabbed UI when adding broadcasts through the Classic or Text Editor |
| 287 |
* Added: Broadcasts: Block: Moved pagination settings to own sidebar panel |
| 288 |
* Fix: Classic Editor: Insert button would stop working when switching from Text Editor to Classic Editor |
| 289 |
* Fix: Uncaught Error: Call to undefined method ConvertKit_Resource_Forms::get_by() |
| 290 |
|
| 291 |
### 2.2.4 2023-06-15 |
| 292 |
* Added: Form Trigger: Block: Display message with link when no API Key specified, or no non-inline Forms exist in ConvertKit |
| 293 |
* Added: Form Trigger: Shortcode: Display message with link when no API Key specified, or no non-inline Forms exist in ConvertKit |
| 294 |
* Added: Forms: Shortcode: Display message with link when no API Key specified, or no inline Forms exist in ConvertKit |
| 295 |
* Added: Products: Shortcode: Display message with link when no API Key specified, or no Products exist in ConvertKit |
| 296 |
* Fix: Bulk & Quick Edit: Show contextual icons for Form, Tag and Member Content settings, instead of the default Form icon |
| 297 |
* Fix: Settings: Conditionally load CSS and JS depending on the section (General, Tools, Member Content) |
| 298 |
* Fix: Settings: Link to ConvertKit form creator when no Forms exist in ConvertKit |
| 299 |
* Fix: Use higher quality SVG icons for blocks, shortcodes and formatters |
| 300 |
* Updated: ConvertKit WordPress Libraries to 1.3.6 |
| 301 |
|
| 302 |
### 2.2.3 2023-06-06 |
| 303 |
* Added: Broadcasts: Options to display grid, images, descriptions and/or read more link |
| 304 |
* Added: Broadcasts: Output as single column on smaller screen resolutions |
| 305 |
* Added: Forms: Block: Display message with link when no API Key specified, or no Forms exist in ConvertKit |
| 306 |
* Added: Products: Block: Display message with link when no API Key specified, or no Products exist in ConvertKit |
| 307 |
* Fix: Settings: Disable CSS: Improve description of Disable CSS functionality, making it clearer what this setting does |
| 308 |
* Fix: Use `esc_url` instead of `esc_attr` for link `href` properties |
| 309 |
|
| 310 |
### 2.2.2 2023-05-24 |
| 311 |
* Added: Elementor: ConvertKit Form Trigger Block |
| 312 |
* 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 |
| 313 |
* 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 |
| 314 |
* Fix: Elementor: ConvertKit Product: Button icon was missing |
| 315 |
* Fix: Block Editor: Don't display options to link text to display a non-inline form if no forms exist in ConvertKit |
| 316 |
* Fix: Block Editor: Don't display options to link text to display a Product or Tip Jar if no Product / Tip Jar exists in ConvertKit |
| 317 |
|
| 318 |
### 2.2.1 2023-05-10 |
| 319 |
* Fix: Settings: Escape tab links on output |
| 320 |
|
| 321 |
### 2.2.0 2023-05-04 |
| 322 |
* Added: ConvertKit Form Trigger Block, outputting a button which displays a non-inline form (modal, slide in, sticky bar) when pressed |
| 323 |
* Added: ConvertKit Form Trigger Shortcode, outputting a button which displays a non-inline form (modal, slide in, sticky bar) when pressed |
| 324 |
* Added: Block Editor: Link text to display a non-inline form (modal, slide in, sticky bar) when pressed |
| 325 |
* Added: Block Editor: Link text to display a ConvertKit Product or Tip Jar when pressed |
| 326 |
* 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 |
| 327 |
* Fix: Forms: Output non-inline scripts using the `wp_footer` hook, ensuring modal overlays fill the screen |
| 328 |
* Fix: Member Content: Append `ck-cache-bust` query parameter after entering code, to prevent plugin / host caching showing stale data |
| 329 |
* Fix: Settings: Tools: Import / Export: Include Member Content settings in import and export configuration |
| 330 |
* 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 |
| 331 |
|
| 332 |
### 2.1.3 2023-04-06 |
| 333 |
* Fix: Improve UI compatibility for buttons in WordPress 5.x, using `button-hero` CSS class instead of custom padding |
| 334 |
* Updated: ConvertKit WordPress Libraries to 1.3.4 |
| 335 |
|
| 336 |
### 2.1.2 2023-03-30 |
| 337 |
* Added: Link to Setup Wizard on Plugins screen |
| 338 |
* Added: Improved ConvertKit Icons in Classic Editor and block editor for Broadcasts, Forms, Products and Custom Content |
| 339 |
|
| 340 |
### 2.1.1 2023-02-23 |
| 341 |
* Fix: Post: Settings: PHP notices when settings are not an array |
| 342 |
* Fix: Landing Pages and Legacy Forms: Deprecated `mb_convert_encoding()` message in PHP 8.2 |
| 343 |
|
| 344 |
### 2.1.0 2023-02-15 |
| 345 |
* Added: Member Content (Beta): Require subscribers to purchase a ConvertKit Product to access specific Pages on your WordPress site. Head over to `Settings > ConvertKit > Member Content` to get started. |
| 346 |
* Fix: Product: Block and Shortcode: Set stylesheet ID to `convertkit-product-css`, to match other blocks |
| 347 |
* Fix: Blocks: Use wp.serverSideRender instead of soon to be deprecated wp.components.ServerSideRender |
| 348 |
* Fix: Forms: Preview: Support for previewing and editing Legacy Forms |
| 349 |
* Fix: Improved performance in WordPress Admin when invalid API credentials specified on new installation |
| 350 |
* Fix: Display notice in WordPress Admin with link to settings screen when invalid API credentials specified |
| 351 |
|
| 352 |
### 2.0.8 2023-02-02 |
| 353 |
* Added: Settings: ConvertKit: Documentation tab |
| 354 |
* Added: Forms: Link to edit form in ConvertKit when previewing a Page, Post or Custom Post containing a ConvertKit form |
| 355 |
* Fix: Display Forms, Landing Pages, Products and Tags in alphabetical order when listed in a `<select>` dropdown |
| 356 |
* Fix: Form: Block and Shortcode: Check Forms exist in ConvertKit before outputting Block / Shortcode options |
| 357 |
* Fix: Form: Shortcode: Remove unused API Key output |
| 358 |
* Fix: Product: Block: Preview: Improved performance when previewing the Product block to determine if a ConvertKit Product was specified in the Block's settings |
| 359 |
* Fix: Product: Shortcode: Remove unused API Key and data-attributes output |
| 360 |
|
| 361 |
### 2.0.7 2023-01-16 |
| 362 |
* Fix: Elementor 3.9.0+ compatibility |
| 363 |
* Updated: ConvertKit WordPress Libraries to 1.3.0 |
| 364 |
|
| 365 |
### 2.0.6 2023-01-05 |
| 366 |
* Fix: Honor "Add a tag" setting when enabled on a Page/Post |
| 367 |
* 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) |
| 368 |
* Fix: PHP Warning: Trying to access array offset on value of type null |
| 369 |
|
| 370 |
### 2.0.5 2022-12-15 |
| 371 |
* Fix: Broadcasts: Strip slashes on output when pagination clicked and Broadcasts are reloaded |
| 372 |
* Fix: Broadcasts: Sanitize and escape HTML attributes on output |
| 373 |
* Fix: Forms: Escape HTML attributes on output |
| 374 |
* Fix: Products: Sanitize and escape HTML attributes on output |
| 375 |
|
| 376 |
### 2.0.4 2022-12-13 |
| 377 |
* Fix: Products: PHP warning when attempting to parse an invalid Product URL |
| 378 |
* Fix: Landing Pages: Catch and log when an error occurs fetching a Landing Page |
| 379 |
* Fix: Remove double forwardslash on product.css |
| 380 |
|
| 381 |
### 2.0.3 2022-12-08 |
| 382 |
* Added: Categories: Option to specify ConvertKit Form to display when adding a new Post Category |
| 383 |
* Fix: Bulk & Quick Edit: Improve layout of ConvertKit settings on desktop and mobile |
| 384 |
* Fix: Post: Improve layout of ConvertKit settings on desktop and mobile |
| 385 |
* Fix: Categories: Improve layout of ConvertKit settings on desktop and mobile |
| 386 |
* Fix: Products: Block: Display preview when adding new block |
| 387 |
|
| 388 |
### 2.0.2 2022-11-21 |
| 389 |
* Fixed: Removed argument count on `in_admin_footer` action calls |
| 390 |
|
| 391 |
### 2.0.1 2022-11-01 |
| 392 |
* Added: Broadcasts: Block: Display message in editor when no Broadcasts exist in ConvertKit |
| 393 |
* Fixed: Settings: Contact Form 7: Render screen correctly when no Forms in ConvertKit |
| 394 |
* Fixed: Settings: WishList Member: Render screen correctly when no Forms in ConvertKit |
| 395 |
|
| 396 |
### 2.0.0 2022-10-24 |
| 397 |
* Added: ConvertKit Products Block, to output a button linking to a ConvertKit Product or Tip Jar |
| 398 |
* Added: ConvertKit Products Shortcode, to output a button linking to a ConvertKit Product or Tip Jar |
| 399 |
* Added: Gutenberg: Option to link text or button to a ConvertKit Product or Tip Jar |
| 400 |
* Added: Classic Editor: Option to link text or button to a ConvertKit Product or Tip Jar |
| 401 |
* Added: Settings: Improved UI |
| 402 |
|
| 403 |
### 1.9.8.5 2022-10-03 |
| 404 |
* Added: Broadcasts: Shortcode: Options to specify background, text and link colors |
| 405 |
* Added: Broadcasts: Elementor: Options to specify background, text and link colors |
| 406 |
* Added: Settings: General: Links added to preview Default Form for each Post Type |
| 407 |
|
| 408 |
### 1.9.8.4 2022-09-08 |
| 409 |
* Added: Setup Wizard for new installations |
| 410 |
* Fix: Text Editor: Quicktag Buttons: Position and size modal window correctly to avoid scrollbars and whitespace |
| 411 |
* 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 |
| 412 |
* Development: Moved /lib folder to managed repository |
| 413 |
|
| 414 |
### 1.9.8.3 2022-08-19 |
| 415 |
* Added: Settings: Tools: Use WordPress' Site Info to populate System Info section |
| 416 |
* Added: Refresh button: Show error notification when refreshing fails |
| 417 |
* Fix: Widgets: Broadcasts Block: JSON response error when attempting to save Broadcasts Block in a Widget area |
| 418 |
* Fix: Classic (Visual) and Text Editor: Insert shortcode into correct editor when multiple editor instances exist (e.g. WooCommerce Products) |
| 419 |
|
| 420 |
### 1.9.8.2 2022-08-04 |
| 421 |
* Fix: API: Show error notification when API returns HTTP 500 and 502 errors, instead of showing PHP warnings |
| 422 |
* Fix: Bulk and Quick Edit: `for` label attribute now matches the field ID |
| 423 |
|
| 424 |
### 1.9.8.1 2022-07-18 |
| 425 |
* Added: Refresh button for Form, Landing Page and Tag fields to fetch latest data from ConvertKit account |
| 426 |
* Fix: Bulk Edit: Don't display fields when no Pages / Posts exist |
| 427 |
|
| 428 |
### 1.9.8.0 2022-07-14 |
| 429 |
* Added: Bulk and Quick Edit Form and Tag when viewing list of Pages/Posts |
| 430 |
* Fix: Performance: Don't perform API requests on every WordPress Administration screen when no Forms, Tags or Landing Pages exist |
| 431 |
|
| 432 |
### 1.9.7.9 2022-06-24 |
| 433 |
* Fix: API: Prevent fatal error when API returns null instead of expected array |
| 434 |
|
| 435 |
### 1.9.7.8 2022-06-23 |
| 436 |
* Added: Elementor Page Builder: ConvertKit Broadcasts Widget |
| 437 |
* Fix: Integration: WishList Member: Unsubscribe email address from ConvertKit if 'unsubscribe' configured and member level removed |
| 438 |
* Fix: Remove double forwardslash on some enqueued scripts and styles |
| 439 |
|
| 440 |
### 1.9.7.7 2022-06-09 |
| 441 |
* Added: Broadcasts: Option to enable pagination on block/shortcode |
| 442 |
|
| 443 |
### 1.9.7.6 2022-06-01 |
| 444 |
* Added: ConvertKit Broadcasts Block when editing Widgets using the block editor in WordPress 5.8+ |
| 445 |
* Added: ConvertKit Form Block when editing Widgets using the block editor in WordPress 5.8+ |
| 446 |
* Fix: ConvertKit Broadcasts Block/Shortcode: Fetch all Broadcasts from ConvertKit, not just the first 50 |
| 447 |
* Fix: Settings: Added label element for setting field names |
| 448 |
|
| 449 |
### 1.9.7.5 2022-05-12 |
| 450 |
* Fix: PHP Warning: Cannot modify header information, caused by QuickTags modal template output |
| 451 |
* Fix: Text Editor: Quicktag Buttons: Block could not be found error when using a Quicktag |
| 452 |
|
| 453 |
### 1.9.7.4 2022-05-04 |
| 454 |
* Added: ConvertKit Broadcasts Block, to output a list of ConvertKit broadcasts |
| 455 |
* Added: ConvertKit Broadcasts Shortcode [convertkit_broadcasts], to output a list of ConvertKit broadcasts |
| 456 |
* Added: Settings: Tools: Import and Export configuration |
| 457 |
* Fix: Page/Post: If a specific Form is selected that no longer exists in ConvertKit, fallback to the Default Form setting |
| 458 |
|
| 459 |
### 1.9.7.3 2022-04-04 |
| 460 |
* Added: Elementor Page Builder: ConvertKit Form Widget |
| 461 |
* 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 |
| 462 |
* Fix: Categories: Improved wording of Form setting on per-Category level |
| 463 |
|
| 464 |
### 1.9.7.2 2022-03-30 |
| 465 |
* Fix: Default Form would not display on Posts due to regression in 1.9.7.1 |
| 466 |
|
| 467 |
### 1.9.7.1 2022-03-23 |
| 468 |
* Fix: Default Form would not display on Posts due to regression in 1.9.7.0 |
| 469 |
|
| 470 |
### 1.9.7.0 2022-03-17 |
| 471 |
* Fix: ConvertKit Form Block: Order Form names alphabetically |
| 472 |
* Fix: Prevent Select2 styling from applying to non-Plugin elements |
| 473 |
|
| 474 |
### 1.9.6.9 2022-03-07 |
| 475 |
* Added: ConvertKit 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 |
| 476 |
* Fix: Include email address in API request when attempting to fetch subscriber ID by email when ConvertKit Form is submitted with no email address |
| 477 |
|
| 478 |
### 1.9.6.8 2022-02-18 |
| 479 |
* Fix: Performance: Don't query API to fetch subscriber ID by email when ConvertKit Form is submitted with no email address |
| 480 |
|
| 481 |
### 1.9.6.7 2022-02-14 |
| 482 |
* Fix: Localization: Corrected path to load language files |
| 483 |
|
| 484 |
### 1.9.6.6 2022-01-27 |
| 485 |
* Fix: Plugin Activation: Parse error when using PHP 7.2 or below due to trailing comma in sprintf() call |
| 486 |
|
| 487 |
### 1.9.6.5 2022-01-26 |
| 488 |
* Added: ConvertKit Form Block for Gutenberg |
| 489 |
* Added: Select2 dropdown for Forms, Landing Pages and Tags with search functionality for improved UX. |
| 490 |
* Fix: Legacy Forms: Removed erronous <html>, <head> and <body> tags from markup |
| 491 |
|
| 492 |
### 1.9.6.4 2022-01-11 |
| 493 |
* Fix: Render Legacy Form when shortcode is copied from app.convertkit.com for a Legacy Form |
| 494 |
* Fix: Don't check for Landing Page when viewing any non-Page public Post Type which doesn't support Landing Pages |
| 495 |
* Fix: PHP Notice: Undefined index landing_page when upgrading from 1.4.6 or earlier |
| 496 |
* Fix: PHP Notice: Undefined index tag when upgrading from 1.4.6 or earlier |
| 497 |
|
| 498 |
### 1.9.6.3 2021-12-23 |
| 499 |
* Fix: Render Legacy Landing Pages |
| 500 |
|
| 501 |
### 1.9.6.2 2021-12-22 |
| 502 |
* Fix: Render Form Shortcode when a new ConvertKit Form ID specified that does not yet exist in Plugin's cached Form Resources |
| 503 |
|
| 504 |
### 1.9.6.1 2021-12-16 |
| 505 |
* Fix: Character encoding issue on Landing Pages |
| 506 |
* Fix: Removed unused .scripts directory and .MD files |
| 507 |
|
| 508 |
### 1.9.6 2021-12-15 |
| 509 |
* Added: ConvertKit Form Shortcode Button for Classic Editor |
| 510 |
* Added: Text Editor: Quicktag Buttons for inserting ConvertKit Forms and Custom Content |
| 511 |
* Added: Settings: ConvertKit: Logo and branding header |
| 512 |
* Added: Option to specify ConvertKit API Key and Secret as constants `CONVERTKIT_API_KEY` and `CONVERTKIT_API_SECRET` in wp-config.php |
| 513 |
* Added: Settings: ConvertKit: General: Different Default Forms can be specified for Pages and Posts |
| 514 |
* Added: Settings: ConvertKit: General: Enabling Debug option will also output data to browser console and inline HTML comments |
| 515 |
* Added: Settings: ConvertKit: Tools: Option to Download Log to text file |
| 516 |
* Added: Settings: ConvertKit: Tools: Option to Download System Info to text file |
| 517 |
* Added: PHP 8.x compatibility |
| 518 |
* Added: Developers: Action and filter hooks. See https://github.com/ConvertKit/convertkit-wordpress/blob/1.9.6/ACTIONS-FILTERS.md |
| 519 |
* Fix: PHP warnings on new installations when adding/editing Pages or Posts where the plugin was not yet configured |
| 520 |
* Fix: PHP 8.x: PHP Deprecated warnings where required parameters wrongly followed optional parameters |
| 521 |
* Fix: gzinflate() data error |
| 522 |
* Fix: Deprecated edit_category_form_fields warning |
| 523 |
* Fix: Integration: WishList Member: Unsubscribe Action 'Unsubscribe from all' now honored when selected and saved |
| 524 |
* Fix: Ensure code meets WordPress Coding Standards |
| 525 |
* Fix: Use WP_Filesystem instead of PHP functions to read/write log file, per WordPress Coding Standards |
| 526 |
|
| 527 |
[See changelog for all versions](https://github.com/ConvertKit/convertkit-wordpress/CHANGELOG.md). |
| 528 |
|
| 529 |
== Upgrade notice == |
| 530 |
|
| 531 |
|
