craftcms / apple-news
Publish Craft CMS entries to Apple News
Installs: 22 387
Dependents: 0
Suggesters: 0
Security: 0
Stars: 41
Watchers: 9
Forks: 7
Open Issues: 5
Type:craft-plugin
Requires
- php: ^8.2.0
- chapter-three/apple-news-api: ^0.3.9
- craftcms/cms: ^5.0.0-beta.1
- league/html-to-markdown: ^5.0
Requires (Dev)
- codeception/codeception: ^5.0.11
- codeception/module-asserts: ^3.0.0
- codeception/module-datafactory: ^3.0.0
- codeception/module-phpbrowser: ^3.0.0
- codeception/module-rest: ^3.3.2
- codeception/module-yii2: ^1.1.9
- craftcms/ckeditor: *
- craftcms/ecs: dev-main
- craftcms/phpstan: dev-main
- craftcms/rector: dev-main
- symfony/browser-kit: ^6.4.0
- vlucas/phpdotenv: ^5.4
README
Apple News
This plugin provides an Apple News integration for Craft CMS, making it possible to publish your content to iPhone, iPad, and Mac users around the world.
Before You Begin
Before you can start publishing to Apple News, you’ll need to sign up for News Publisher and create your first channel. Make sure you choose to publish with Apple News Format when asked. Note that new channels must go through an approval process before they can be used.
Once you’ve created a channel, you’ll need to write down its Channel ID and API credentials. You can get those from Settings → Channel Info → Connect CMS → API Key in News Publisher.
Requirements
This plugin requires Craft CMS 5.0.0+.
Installation
You can install this plugin from the Plugin Store or with Composer.
From the Plugin Store
Go to the Plugin Store in your project’s Control Panel and search for Apple News. Then click on the Install button in its modal window.
With Composer
Open your terminal and run the following commands:
# go to the project directory cd /path/to/my-project.test # tell Composer to load the plugin composer require craftcms/apple-news # tell Craft to install the plugin ./craft install/plugin apple-news
Configuration
Publish to Apple News gets its own configuration file, located at config/apple-news.php
. It can have the following config settings:
channels
(array) – List of channel class configsautoPublishOnSave
(bool) – Whether entries should be automatically published to Apple News whenever they are saved (true
by default)
Here’s an example:
<?php return [ 'channels' => [ [ 'class' => applenewschannels\MyNewsChannel::class, 'channelId' => craft\helpers\App::env('NEWS_CHANNEL_ID'), // xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx 'apiKeyId' => craft\helpers\App::env('NEWS_API_KEY'), // xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx 'apiSecret' => craft\helpers\App::env('NEWS_API_SECRET'), // xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx ], ], ];
Channel Classes
Channel classes tell the plugin everything it needs to know to start publishing content Apple News. They should should extend craft\applenews\BaseChannel.
We recommend that you save your channel classes in config/apple-news-channels
and use an applenewschannels
namespace.
<?php namespace applenewschannels; // ...
An example channel class is provided at apple-news-channels/MyNewsChannel.php, which will more or less work with the “News” section within the Happy Lager demo site.
Autoloading your Channel Classes
To make your channel classes auto-loadable, add a new autoload root to composer.json
for your channel and article classes, and then run composer dump-autoload
.
{ "autoload": { "psr-4": { "applenewschannels\\": "config/apple-news-channels/" } } }
Usage
Once your Channel classes are set up and included properly, a new Apple News Channels area appear in the details pane of Edit Entry pages, for entries that have at least one matching channel.
Each channel will display an action menu beside it with some of the following options, depending on the state of the article:
- Publish to Apple News – Queues the article to be published to Apple News.
- Copy share URL – Displays a prompt that allows the user to copy the article’s share URL.
- Download for News Preview – Downloads the entry’s
article.json
(and other files), which can be loaded into the News Preview app, to see exactly how your article will look on various iOS devices once published.
There will also be a new Publish to Apple News bulk action on the Entries index page, which makes it possible to queue up several entries to be published at once.
Resources
You can learn more about publishing on Apple News at the following resources:
Caveats
Please be aware of the following caveats:
- Entries with a Post Date set in the future won’t be automatically published to Apple News when they go live.
Thanks
Many thanks to Chapter Three for their excellent AppleNewsAPI library.