Posts: Replace wordpress/posts with v4/posts endpoint

[n7studios]

Summary

Updates the Kit WordPress Libraries to use the v4/posts API endpoint, instead of the legacy wordpress/posts endpoint, when fetching Broadcasts.

Library changes: Kit/convertkit-wordpress-libraries use-v4-api-posts-endpoint

Broadcasts block

• Supports both wordpress/posts (url) and v4/posts (public_url) cached resource data, so existing cached Broadcasts continue to display until the resource is refreshed
• Uses meta_description for the Broadcast's description
• Outputs the title without a link if a Broadcast has no public URL

Broadcasts importer

• Updates to the v4/posts/{id} response shape, where the Broadcast is nested in a post key
• Uses meta_description as the Post's excerpt if description is null
• Checks the access token once in refresh(), instead of for every Broadcast imported

HTML parser

• v4/posts/{id} returns the Broadcast's content as a full HTML document. Adds an $is_html_document parameter to ConvertKit_HTML_Parser, which inserts the UTF-8 Content-Type meta tag into the document's existing <head>, instead of wrapping the document in another <html> document (which would output the Broadcast's <head> elements within the <body>)

Testing

Existing tests cover this change, and pass:

• BroadcastsImportTest (Integration)
• Broadcasts block, shortcode and Broadcasts to Posts tests (EndToEnd)

Checklist

• I have written a test and included it in this PR
• I have run all tests and they pass
• The code passes when running the PHP CodeSniffer
• Code meets WordPress Coding Standards for PHP, HTML, CSS and JS
• Security and Sanitization requirements have been followed
• I have assigned a reviewer or two to review this PR (if you're not sure who to assign, we can do this step for you)

[github-actions]

WordPress Playground

🚀 Your PR has been built and is ready for testing in WordPress Playground!

Click here to test your changes in WordPress Playground