README

The eZRSSFeed extension contains a configurable rssfeed toolbar for displaying rssfeeds on your site. It also contains a rssfeed template operator for fetching rssfeeds into a template

版本

当前 eZ RSS Feed 版本为 0.1.2
上次重大更新：2017年10月2日

版权

eZ RSS Feed 版权所有 1999 - 2017 Brookins Consulting
更多信息请参阅： COPYRIGHT.md

许可

eZ RSS Feed 采用 GNU 通用公共许可证。

完整的许可协议包含在 LICENSE 文件中。

eZ RSS Feed 是免费软件：您可以在 GNU 通用公共许可证的条款下重新分发和/或修改它，该许可证由自由软件基金会发布，无论是许可证的第 2 版还是您选择的较新版本。

eZ RSS Feed 以希望它将是有用的目的进行分发，但没有任何形式的保证；甚至没有关于其适销性或适用于特定目的的暗示性保证。有关详细信息，请参阅 GNU 通用公共许可证。

GNU GPL 在某些条件下赋予您使用、修改和重新分发 eZ RSS Feed 的权利。GNU GPL 许可证与软件一起分发，请参阅 LICENSE 文件。

它也可在 https://gnu.ac.cn/licenses/gpl.txt 上找到

您应该在 LICENSE 文件中收到 GNU 通用公共许可证的副本。

如果没有，请参阅 https://gnu.ac.cn/licenses/。

根据 GNU GPL 许可使用 eZ RSS Feed 是免费的（指自由）。

有关更多信息或疑问，请联系： license@brookinsconsulting.com

需求

以下为使用 eZ RSS Feed 扩展的需求

eZ Publish 版本

确保您使用 eZ Publish 版本 5.x（必需）或更高版本。
设计与测试基于 eZ Publish Community Project 2017.1

PHP 版本

确保您有 PHP 5.x 或更高版本。

功能

工具栏

以下是一个使用示例：可用的工具栏

操作符

此解决方案提供了以下 eztpl 操作符

操作符： ezrssfeed

依赖项

此解决方案依赖于 eZ Publish Legacy

用例

此解决方案旨在提供一种简单的方法，以便在您的网站模板中检索和显示 rss feed 内容。

安装

通过 Composer 安装扩展

从您的项目根目录运行以下命令以安装扩展

```bash
$ composer require brookinsconsulting/ezrssfeed dev-master;```

通过手动安装扩展

将 ezrssfeed.tar.gz 提取到您的 eZ Publish Legacy 扩展目录中。

激活扩展

通过管理员激活扩展

在管理界面中：前往“设置”>“扩展”>勾选“ezrssfeed”旁边的复选框>点击“激活”

通过ini文件激活扩展

 Add the following to your settings/override/site.ini.append.php file:

     [ExtensionSettings]
     ActiveExtensions[]=ezrssfeed

使用方法

扩展可以以两种方式使用。要么作为工具栏，要么作为模板操作符。它还可以作为创建工具栏的示例。

工具栏

例如，有一个工具栏可用。一旦安装并激活扩展，管理界面中就会出现“rssfeed”工具栏。

工具栏可以轻松地将rssfeed添加到您的页面。设置是自我解释的。

模板操作符

为了增加灵活性，可以在模板中使用操作符。ezrss操作符至少需要一个参数，即RSS-feeds的URL。

可用的参数包括

url：要下载的源URL。此参数是必需的。
items：要返回的项目数（设置为0以返回所有项目）。默认值：4
channeldata：返回频道数据？默认值：False
imagedata：返回rssfeed图像数据？这可能不是所有源都可用。默认值：False

示例用法

{let slashdot=ezrssfeed("http://slashdot.org/index.rss", 4, true(), false()}

这将从给定的URL加载源，返回前4个项目，包含频道数据，不包含图像数据，并将其存储在变量slashdot中。

缓存块

确保ezrssfeed在{cache-block}内是一个非常好的主意，这将提高站点的性能，并且您不需要每次有人加载您的页面时都下载源。

某些站点可能会在一段时间内禁止您请求源。

使用操作符的完整示例

{cache-block expiry=300}
  {let feed=ezrssfeed("http://slashdot.org/index.rss", 10, true(), true() )}
     <h2>
       <a href="{$feed.image.link.content}"><img src="{$feed.image.url.content}" alt="{$feed.image.title.content}"></a>
       <a href="{$feed.channel.link.content}">{$feed.channel.title.content}</a>
     </h2>
    <ul>
    {section var=theitem loop=$feed.items}
      <li><a href="{$theitem.link.content}">{$theitem.title.content}</a></li>
      <p>{$theitem.description.content|shorten(80)}</p>
    {/section}
    </ul>
  {/let}
{/cache-block}

缓存块的过期时间为300秒，这意味着每5分钟将重新生成源。

如果您想查看eZRSS返回的数据，请将以下内容放入模板中

{let freshmeat_data=ezrssfeed("http://download.freshmeat.net/backend/fm-releases-unix.xml", 0, true(), true() )}
     {$freshmeat_data|attribute(show)}
{/let}

这里我们用rssfeed URL作为参数调用ezrssfeed。项目数设置为0，表示源中的每个项目。

我们下载了频道数据，然后打开URL，解析它并返回数据。属性（显示）显示所有可用的数据。

测试

该解决方案配置为在正确安装和配置后正常工作。

故障排除

阅读常见问题解答

某些问题比其他问题更常见。最常见的问题列在doc/FAQ.md中

支持

如果您在此文档或常见问题解答中未找到任何问题，可以通过支持系统联系Brookins咨询：http://brookinsconsulting.com/contact

变更日志

v1.2 (2017-10-02)

用DOMDocument替换了eZXML库的使用，以实现eZ Publish 5的兼容性。（5.x）

v1.1 (2006-08-21)

为每个项目添加了时间戳生成
修复了从rss中解析某些时间戳的损坏
修复了readme中的某些错误

v1.0 (2005-02-13)

初始发布（3.x）

致谢

更新者：Brookins咨询
发布者：Kristian Hole
最初由：Ole Morten Halvorsen编写

brookinsconsulting / ezrssfeed

维护者

详细信息