=== Publish To Apple News ===
Contributors: potatomaster, kevinfodness, jomurgel, tylermachado, benpbolton, alleyinteractive, beezwaxbuzz, gosukiwi, pilaf, jaygonzales, brianschick, wildist
Donate link: https://wordpress.org
Tags: publish, apple, news, iOS
Requires at least: 6.3
Tested up to: 6.9
Requires PHP: 8.2
Stable tag: 2.8.0
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl.html

Enables journalistic outlets already approved by Apple News to send content directly to the app.

== Description ==

The 'Publish to Apple News' plugin enables WordPress sites with approved Apple News channels to publish content directly on Apple News.

**Features include:**

* Convert your WordPress content into Apple News format automatically.
* Create a custom design for your Apple News content with no programming knowledge required.
* Automatically or manually publish posts from WordPress to Apple News.
* Control individual posts with options to publish, update, or delete.
* Publish individual posts or in bulk.
* Handles image galleries and popular embeds like YouTube and Vimeo that are supported by Apple News.

To enable content from your WordPress site to be published to your Apple News channel, you must obtain and enter Apple News API credentials from Apple.

Please see the [Apple Developer](https://developer.apple.com/) and [Apple News Publisher documentation](https://developer.apple.com/news-publisher/) and terms on Apple's website for complete information.

== Installation ==

Please visit our [wiki](https://github.com/alleyinteractive/apple-news/wiki) for detailed [installation instructions](https://github.com/alleyinteractive/apple-news/wiki/Installation) as well as [configuration](https://github.com/alleyinteractive/apple-news/wiki/Configuration) and [usage instructions](https://github.com/alleyinteractive/apple-news/wiki/Usage), [troubleshooting information](https://github.com/alleyinteractive/apple-news/wiki/Usage#troubleshooting) and a full list of [action and filter hooks](https://github.com/alleyinteractive/apple-news/wiki/action-and-filter-hooks).

== Frequently Asked Questions ==

Please visit our [wiki](https://github.com/alleyinteractive/apple-news/wiki) for detailed [installation instructions](https://github.com/alleyinteractive/apple-news/wiki/Installation) as well as [configuration](https://github.com/alleyinteractive/apple-news/wiki/Configuration) and [usage instructions](https://github.com/alleyinteractive/apple-news/wiki/Usage), [troubleshooting information](https://github.com/alleyinteractive/apple-news/wiki/Usage#troubleshooting) and a full list of [action and filter hooks](https://github.com/alleyinteractive/apple-news/wiki/action-and-filter-hooks).

== Screenshots ==

1. Manage all of your posts in Apple News from your WordPress dashboard
2. Create a custom theme for your Apple News posts with no programming knowledge required
3. Publish posts in bulk
4. Manage posts in Apple News right from the post edit screen

== Changelog ==

= 2.8.0 =

* Breaking Change: Drops support for EOL PHP versions (8.0, 8.1). The minimum required PHP version is now 8.2. 
* Enhancement: Adds a new filter, apple_news_embed_web_video_link, to filter the final video URL for an Embed Web Video component. Props to @dphiffer for the enhancement.
* Bugfix: Fixes a conflict with the Yoast Video SEO plugin where videos that are lazy loaded weren't being properly converted to video elements in the Apple News output (e.g., YouTube).

= 2.7.2 =

* Enhancement: Now shows up to 50 suggestions for terms in Automation settings, rather than just 10. Props to @aurooba for the fix.
* Bugfix: Resolves an issue where the date in the standalone "Date" component had the UTC offset applied to it twice, causing the date and time to be off by the value of the UTC offset (e.g., a post published at 12:00 PM EDT would incorrectly appear as 8:00 AM EDT). Props to @naxoc for the fix.
* Bugfix: Resolves a warning being thrown when block editor assets are being enqueued and the plugin settings haven't been loaded. Props to @s3rgiosan for the fix.
* Bugfix: The logic for whether the plugin should update postmeta by comparing the old value to the new now compares the raw value from the database instead of the filtered value, which now accurately accounts for default postmeta values. Props to @dlh01 for the fix.

= 2.7.1 =

* Changed: Removed the requirement that recipe HTML contains the exact name of the recipe given in the corresponding JSON-LD item.
* Bugfix: Fixed an issue where an error would occur when attempting to publish posts containing VideoPress embedded videos.
* Bugfix: Fixed an issue where JSON-LD Recipe items would not be detected when they were part of JSON-LD arrays.

= 2.7.0 =

* Enhancement: Add support for the Apple News Recipe component. Please [visit our wiki for detailed documentation](https://github.com/alleyinteractive/apple-news/wiki/configuration#recipe-component).
* Enhancement: Add "Cover Media" options, expanding on existing "Cover Image" feature, allowing YouTube or other videos to display in the Cover component.
* Enhancement: Add setting that allows elements in post content matching CSS classes or ID selectors to be excluded from the content sent to Apple News.
* Enhancement: Allow article deletions with Bulk Actions.
* Enhancement: Move section mapping to its own table in the Automation settings for easier management.
* Enhancement: Enable caption on the Cover component by default.

= 2.6.3 =

* Bugfix: Fixed an issue where the deletion of a post's autosave could cause the Apple News article for that post to be deleted.

= 2.6.2 =

* Enhancement: i18n - Remove `load_plugin_textdomain`. Since WordPress 4.6, plugins no longer need to load their own textdomain.
* Enhancement: i18n - Moved some plugin initialization code to the `init` action hook.
* Enhancement: Add license to plugin header.
* Bugfix: i18n - Fixed the `_load_textdomain_just_in_time` error with WordPress 6.7.
* Bugfix: Update bulk action text to clarify that the "Publish" action can also be used to update published articles.
* Bugfix: Update plugin name in plugin header.

= 2.6.1 =

* Enhancement: Ensured support for WordPress 6.7.

= 2.6.0 =

* Enhancement: Support added for PHP 8.3.
* Enhancement: Support added for handling deleted articles (in iCloud News Publisher).
* Enhancement: Add a new hook, `apple_news_after_push_failure`, that fires when a post fails to be pushed to Apple News.
* Enhancement: Debugging Settings: support added for sending notification to multiple email accounts.
* Enhancement: Debugging Settings: support added for client side validation of the email accounts.
* Enhancement: REST Endpoints actually return a `WP_Error` if Apple News *is not* initialized.
* Bugfix: Fixed an issue where a root-relative image URL used the URL to the WordPress installation instead of the URL to the front-end, which WordPress allows admins to configure to be different URLs.
* Bugfix: API Settings: fixed an issue where the latest `value` was not rendered after an update.

= 2.5.1 =

* Bugfix: Fixed an issue where the plugin would crash if the Apple News API returned an error when fetching information about the configured channel. Now surfaces an admin notice with the error message instead.

= 2.5.0 =

* Breaking Change: Removed support for per-article advertising settings, which have been deprecated by Apple. Advertising settings can now only be set at the channel level.
* Enhancement: Added support for an aside component. To use, specify the class for the container that includes the aside content in the plugin settings.
* Enhancement: Added support for the Footnotes block.
* Enhancement: Added a new In Article module, similar to the End of Article module, but which is configurable to appear within article content instead.
* Enhancement: Added support for custom fonts added to the channel in the theme customizer.
* Enhancement: Added support for respecting the text alignment of individual paragraphs.
* Enhancement: Added support for customizing default tag styles via Customize JSON. To use, edit the Body component in the Customize JSON interface.
* Enhancement: Added support for customizing individual items in a gallery via Customize JSON.
* Enhancement: Added an option to Automation where the contentGenerationType can be set to AI for AI-generated content based on applied taxonomy terms.
* Enhancement: Added an option to Automation to prepend text to an Apple News article title based on applied taxonomy terms.
* Enhancement: Split layouts for headings by level, so different layouts can be applied to each heading level in Customize JSON.
* Enhancement: Improves the display of captions.
* Enhancement: Added debugging for Apple News API requests.
* Bugfix: Fixed an issue where a channel that was set to paid by default required every article to also be marked as paid, rather than accepting the channel default.
* Bugfix: Fixed an issue where images that were hyperlinked and aligned to the left or the right would not properly display in Apple News.
* Bugfix: Fixed an issue with a bad path for file inclusion that was causing a crash on some systems.
* Bugfix: Fixed an issue where including a Cover block with a caption would cause an error on publish.
* Bugfix: Fixed an issue where editing a synced pattern (formerly known as a reusable block) would cause an error in the editor. Props to @kasparsd for the fix.
* Bugfix: Fixed an issue where posts missing custom excerpts would show the publish date and time as the excerpt instead of an autogenerated excerpt based on post content.

Information on previous releases can be found on the plugin's [GitHub Releases page](https://github.com/alleyinteractive/apple-news/releases).

== Developers ==

Please visit us on [GitHub](https://github.com/alleyinteractive/apple-news) to [submit issues](https://github.com/alleyinteractive/apple-news/issues), [pull requests](https://github.com/alleyinteractive/apple-news/pulls) or [read our wiki page about contributing](https://github.com/alleyinteractive/apple-news/wiki/contributing).
