PHPackages aerni/apple-news - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. aerni/apple-news ActiveLibrary[Utility & Helpers](/categories/utility) aerni/apple-news ================ A Statamic addon to publish your collection entries on Apple News. v1.0.0(4y ago)0507proprietaryPHPPHP ^7.4 | ^8.0 Since Jul 28Pushed 4y ago1 watchersCompare [ Source](https://github.com/aerni/statamic-apple-news)[ Packagist](https://packagist.org/packages/aerni/apple-news)[ Docs](https://github.com/aerni/statamic-apple-news)[ RSS](/packages/aerni-apple-news/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (1)Dependencies (7)Versions (2)Used By (0) [![Statamic](https://camo.githubusercontent.com/93d33dcdd370c8e4e34b4186825dc0e37e2796db65c5e344dc5d106b09af12a9/68747470733a2f2f666c61742e62616467656e2e6e65742f62616467652f53746174616d69632f332e302b2f464632363945)](https://camo.githubusercontent.com/93d33dcdd370c8e4e34b4186825dc0e37e2796db65c5e344dc5d106b09af12a9/68747470733a2f2f666c61742e62616467656e2e6e65742f62616467652f53746174616d69632f332e302b2f464632363945) [![Packagist version](https://camo.githubusercontent.com/861921a556e4f30465bb1e611f04668c6422154358a269b3b8e08c61d9edc901/68747470733a2f2f666c61742e62616467656e2e6e65742f7061636b61676973742f762f6165726e692f6170706c652d6e6577732f6c6174657374)](https://camo.githubusercontent.com/861921a556e4f30465bb1e611f04668c6422154358a269b3b8e08c61d9edc901/68747470733a2f2f666c61742e62616467656e2e6e65742f7061636b61676973742f762f6165726e692f6170706c652d6e6577732f6c6174657374) [![Packagist Total Downloads](https://camo.githubusercontent.com/f5922184d440d8e396f3c79adc0228edd8c2edc794db38152a743568dee93827/68747470733a2f2f666c61742e62616467656e2e6e65742f7061636b61676973742f64742f6165726e692f6170706c652d6e657773)](https://camo.githubusercontent.com/f5922184d440d8e396f3c79adc0228edd8c2edc794db38152a743568dee93827/68747470733a2f2f666c61742e62616467656e2e6e65742f7061636b61676973742f64742f6165726e692f6170706c652d6e657773) Apple News ========== [](#apple-news) This Statamic addon provides a powerful integration with Apple News, making it possible to publish your collection entries to iPhone, iPad, and Mac users around the world. Prerequisites ------------- [](#prerequisites) You first need to [apply for News Publisher](https://www.icloud.com/newspublisher/) and create a channel before you can start publishing your content. Note that new channels have to go through an approval process before you can use them. Next, you need to get your channel's ID and API Credentials. You can get those in News Publisher `Settings -> Connect CMS -> API Key`. Installation ------------ [](#installation) Install the addon using Composer: ``` composer require aerni/apple-news ``` Publish the config of the package: ``` php please vendor:publish --tag=apple-news-config ``` The following config will be published to `config/apple-news.php`: ``` return [ /* |-------------------------------------------------------------------------- | Apple News API |-------------------------------------------------------------------------- | | The Apple News API credentials of your channel. | */ 'id' => env('APPLE_NEWS_CHANNEL_ID'), 'key' => env('APPLE_NEWS_KEY'), 'secret' => env('APPLE_NEWS_SECRET'), /* |-------------------------------------------------------------------------- | Site |-------------------------------------------------------------------------- | | The handle of the site you want to use to publish on Apple News. | */ 'site' => 'default', /* |-------------------------------------------------------------------------- | Collections |-------------------------------------------------------------------------- | | The handles of the collections whose entries you want to publish. | */ 'collections' => [ // 'articles', ], /* |-------------------------------------------------------------------------- | Templates |-------------------------------------------------------------------------- | | The templates for your Apple News articles. | */ 'templates' => [ // \App\AppleNews\DefaultTemplate::class, ], ]; ``` Configuration ------------- [](#configuration) ### Apple News API [](#apple-news-api) Add your Apple News API credentials to your `.env` file: ``` APPLE_NEWS_CHANNEL_ID=************************************ APPLE_NEWS_KEY=************************************ APPLE_NEWS_SECRET=******************************************** ``` ### Site [](#site) Add the handle of the site you want to use to publish on Apple News: ``` 'site' => 'default' ``` ### Collections [](#collections) Add the handles of the collections whose entries you want to publish on Apple News: ``` 'collections' => [ 'articles', 'interviews' ] ``` ### Templates [](#templates) Add your article template classes: ``` 'templates' => [ \App\AppleNews\DefaultTemplate::class, \App\AppleNews\InterviewTemplate::class, ] ``` Article Templates ----------------- [](#article-templates) ### Creating a template [](#creating-a-template) Create your first article template: ``` php please apple-news:template {name} ``` This will publish a new template to `app/AppleNews/{name}.php`. ### Customizing a template [](#customizing-a-template) Each template consists of a set of methods to configure your articles. They are powered by the excellent [AppleNewsAPI](https://github.com/chapter-three/AppleNewsAPI) library that lets you define your article's layout, components, styles, etc. Make sure to [take a look at the source](https://github.com/chapter-three/AppleNewsAPI/tree/master/src/Document) to get an idea of the classes and methods available to you. Previewing an article --------------------- [](#previewing-an-article) [News Preview](https://developer.apple.com/news-preview/) is an app provided by Apple that lets you preview your articles in the News app. This is super useful when building out your templates. Use the following command and provide the `id` of the Statamic entry you want to use for preview: ``` php please apple-news:preview {entryId} ``` This creates an `article.json` file of the entry in `storage/statamic/addons/apple-news/preview/`. Open the `News Preview` app, select the `article.json` file, and choose the device you want to use to preview your article. Publishing Workflow ------------------- [](#publishing-workflow) ### Publishing [](#publishing) Open the entry in the Statamic Control Panel that you want to publish on Apple News. Navigate to the `Apple News` tab and customize the options to your liking. Once you're ready to publish, flick the `Published` toggle and save the entry. The article is now being processed by Apple News. Refresh the page to see the current `Publish State`. ### Updating [](#updating) The article will be updated every time you save the Statamic entry. > **Note:** The article is updated every time the `Statamic\Events\EntrySaving` event is dispatched. ### Unpublishing / Deleting [](#unpublishing--deleting) Unflick the `Published` toggle to delete the article from Apple News. Deleting the Statamic entry will do the same. > **Note:** Apple News doesn't support unpublishing an article. Articles can only be deleted. Alternatively you can use the `Hidden` toggle to hide the article from Apple News feeds. License ------- [](#license) Apple News is **commercial software** but has an open-source codebase. If you want to use it in production, you'll need to [buy a license from the Statamic Marketplace](https://statamic.com/addons/aerni/apple-news). > Apple News is **NOT** free software. Credits ------- [](#credits) Developed by [Michael Aerni](https://www.michaelaerni.ch) Special Thanks -------------- [](#special-thanks) Many thanks to [Duo Security](https://duo.com/) and [Cisco](https://www.cisco.com/) for sponsoring this addon. ### Health Score 26 — LowBetter than 43% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity12 Limited adoption so far Community7 Small or concentrated contributor base Maturity55 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 1746d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/7f0a168dc347e5e141dc13cec734d3b0a25a13445069483732580f26f71456a6?d=identicon)[aerni](/maintainers/aerni) --- Top Contributors [![aerni](https://avatars.githubusercontent.com/u/23167701?v=4)](https://github.com/aerni "aerni (124 commits)") --- Tags apple-newsstatamicstatamic-addonapple newsstatamicapple-news ### Code Quality TestsPHPUnit Code StylePHP CS Fixer ### Embed Badge ![Health badge](/badges/aerni-apple-news/health.svg) ``` [![Health](https://phpackages.com/badges/aerni-apple-news/health.svg)](https://phpackages.com/packages/aerni-apple-news) ``` ### Alternatives [marcorieser/statamic-livewire A Laravel Livewire integration for Statamic. 2381.5k10](/packages/marcorieser-statamic-livewire)[withcandour/aardvark-seo Save time and get your Statamic site to rank better with the SEO addon for Statamic. 13128.3k](/packages/withcandour-aardvark-seo)[aerni/livewire-forms A Statamic forms framework powered by Laravel Livewire 2912.8k](/packages/aerni-livewire-forms)[mitydigital/feedamic A fully-featured RSS and Atom feed generator for Statamic. 1064.0k](/packages/mitydigital-feedamic)[aerni/advanced-seo Comprehensive SEO addon for Statamic with flexibility in mind 1316.6k](/packages/aerni-advanced-seo)[mitydigital/sitemapamic An XML sitemap generator for Statamic that includes all collections and related taxonomy pages. 1485.2k](/packages/mitydigital-sitemapamic) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)