-
Notifications
You must be signed in to change notification settings - Fork 8
/
readme.txt
executable file
·632 lines (481 loc) · 37.5 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
=== 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, block, form
Requires at least: 5.0
Tested up to: 6.7.1
Requires PHP: 5.6.20
Stable tag: 2.6.6
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.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 marketing or a seasoned professional email 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 subscriber 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 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
= 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.
Sign up forms can be configured to:
- Send free content, such as a PDF
- Display when the user is about to leave the page
- Subscribe to an email newsletter, with powerful tagging and segmentation options
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)
- 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
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!
### 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 marketing list or selling a product.
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.
= 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.
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.
### 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
- 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
== 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
= 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
= 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
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
== Changelog ==
### 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 ==