laravel feed
4.4.0
该包提供了一种为 Laravel 应用程序生成提要的简单方法。支持的格式有 RSS、Atom 和 JSON。您几乎不需要编码。只需按照安装说明进行操作，更新您的配置文件，就可以开始了。
Spatie 是一家位于比利时安特卫普的网页设计机构。您可以在我们的网站上找到所有开源项目的概述。
我们投入了大量资源来创建一流的开源包。您可以通过购买我们的一款付费产品来支持我们。
我们非常感谢您从家乡寄给我们一张明信片，并注明您正在使用我们的哪种套餐。您可以在我们的联系页面上找到我们的地址。我们在虚拟明信片墙上发布所有收到的明信片。
您可以通过 Composer 安装该软件包：
composer require spatie/laravel-feed使用feeds -macro 注册将显示 feed 的路由。
// In routes/web.php
Route:: feeds ();或者，您可以传递一个字符串作为宏的第一个参数。该字符串将用作所有配置的源的 URL 前缀。
接下来，您必须发布配置文件：
php artisan feed:install看起来是这样的：
return [
' feeds ' => [
' main ' => [
/*
* Here you can specify which class and method will return
* the items that should appear in the feed. For example:
* [AppModel::class, 'getAllFeedItems']
*
* You can also pass an argument to that method. Note that their key must be the name of the parameter: *
* [AppModel::class, 'getAllFeedItems', 'parameterName' => 'argument']
*/
' items ' => '' ,
/*
* The feed will be available on this url.
*/
' url ' => '' ,
' title ' => ' My feed ' ,
' description ' => ' The description of the feed. ' ,
' language ' => ' en-US ' ,
/*
* The image to display for the feed. For Atom feeds, this is displayed as
* a banner/logo; for RSS and JSON feeds, it's displayed as an icon.
* An empty value omits the image attribute from the feed.
*/
' image ' => '' ,
/*
* The format of the feed. Acceptable values are 'rss', 'atom', or 'json'.
*/
' format ' => ' atom ' ,
/*
* The view that will render the feed.
*/
' view ' => ' feed::atom ' ,
/*
* The mime type to be used in the <link> tag. Set to an empty string to automatically
* determine the correct value.
*/
' type ' => '' ,
/*
* The content type for the feed response. Set to an empty string to automatically
* determine the correct value.
*/
' contentType ' => '' ,
],
],
];您可以选择发布视图文件：
php artisan vendor:publish --provider= " SpatieFeedFeedServiceProvider " --tag= " feed-views " 假设您有一个名为NewsItem的模型，其中包含您想要在提要中显示的记录。
首先，您必须在该模型上实现Feedable接口。 Feedable需要一种方法： toFeedItem ，它应该返回一个FeedItem实例。
// app/NewsItem.php
use Illuminate Database Eloquent Model ;
use Spatie Feed Feedable ;
use Spatie Feed FeedItem ;
class NewsItem extends Model implements Feedable
{
public function toFeedItem (): FeedItem
{
return FeedItem:: create ()
-> id ( $ this -> id )
-> title ( $ this -> title )
-> summary ( $ this -> summary )
-> updated ( $ this -> updated_at )
-> link ( $ this -> link )
-> authorName ( $ this -> author )
-> authorEmail ( $ this -> authorEmail );
}
}如果您愿意，返回带有必要键的关联数组也可以达到目的。
// app/NewsItem.php
use Illuminate Database Eloquent Model ;
use Spatie Feed Feedable ;
use Spatie Feed FeedItem ;
class NewsItem extends Model implements Feedable
{
public function toFeedItem (): FeedItem
{
return FeedItem:: create ([
' id ' => $ this -> id ,
' title ' => $ this -> title ,
' summary ' => $ this -> summary ,
' updated ' => $ this -> updated_at ,
' link ' => $ this -> link ,
' authorName ' => $ this -> authorName ,
]);
}
}接下来，您必须创建一个方法来返回必须在提要中显示的所有项目。您可以将该方法命名为您喜欢的任何名称，并且可以执行您想要的任何查询。
// app/NewsItem.php
public static function getFeedItems ()
{
return NewsItem:: all ();
}最后，您必须将类的名称和要在配置文件中呈现提要的 url 放入其中：
// config/feed.php
return [
' feeds ' => [
' news ' => [
/*
* Here you can specify which class and method will return
* the items that should appear in the feed. For example:
* 'AppModel@getAllFeedItems'
* or
* ['AppModel', 'getAllFeedItems']
*
* You can also pass an argument to that method. Note that their key must be the name of the parameter: *
* ['AppModel@getAllFeedItems', 'parameterName' => 'argument']
* or
* ['AppModel', 'getAllFeedItems', 'parameterName' => 'argument']
*/
' items ' => ' AppNewsItem@getFeedItems ' ,
/*
* The feed will be available on this url.
*/
' url ' => ' /feed ' ,
' title ' => ' All newsitems on mysite.com ' ,
/*
* The format of the feed. Acceptable values are 'rss', 'atom', or 'json'.
*/
' format ' => ' atom ' ,
/*
* Custom view for the items.
*
* Defaults to feed::feed if not present.
*/
' view ' => ' feed::feed ' ,
],
],
]; items键必须指向返回以下值之一的方法：
Feedable的数组或集合FeedItem的数组或集合这个包提供了开箱即用的feed::feed视图，用于显示您的 feed 详细信息。
但是，您可以通过在 Feed 配置中提供view键来为每个 Feed 使用自定义视图。
在以下示例中，我们将之前的News源与自定义feeds.news视图（位于resources/views/feeds/news.blade.php ）一起使用：
// config/feed.php
return [
' feeds ' => [
' news ' => [
' items ' => [ ' AppNewsItem ' , ' getFeedItems ' ],
' url ' => ' /feed ' ,
' title ' => ' All newsitems on mysite.com ' ,
/*
* The format of the feed. Acceptable values are 'rss', 'atom', or 'json'.
*/
' format ' => ' atom ' ,
/*
* Custom view for the items.
*
* Defaults to feed::feed if not present.
*/
' view ' => ' feeds.news ' ,
],
],
];要发现提要，提要阅读器会在 html 文档的 head 部分中查找如下所示的标签：
< link rel =" alternate " type =" application/atom+xml " title =" News " href =" /feed " >您可以通过部分视图将其添加到您的<head>中。
@ include ( ' feed::links ' )作为替代方案，您可以使用此刀片组件：
< x-feed-links /> composer test 请参阅变更日志以了解有关最近更改内容的更多信息。
详细信息请参阅贡献。
请查看我们的安全政策，了解如何报告安全漏洞。
麻省理工学院许可证 (MIT)。请参阅许可证文件以获取更多信息。
