README

RSS Display

在前端显示 RSS feed 的内容元素。该扩展使用 SimplePie 作为底层库来获取和解析 feed。 SimplePie 是一个快速且经过充分测试的 RSS / Atom 库。在 2.0 版本中，扩展几乎全部重写。请务必阅读迁移章节。

功能

定义各种模板，用户可以选择。
可配置的缓存机制
高级视图助手，可以从 feed 项目中提取内容。

屏幕截图

一张图！

项目信息和版本

稳定版：http://typo3.org/extensions/repository/view/rss_display

开发版：https://github.com/fabarea/rss_display

安装

在扩展管理器中按正常方式安装扩展，并创建一个 RSS Display 类型的内容元素。

用户手册

要在页面上显示 RSS feed：点击应显示 RSS feed 的页面，并创建一个新的内容元素。

选择“插件”选项卡，然后选择“RSS Feed Display”。

如有必要，写入标题并选择“插件”选项卡。

在插件中：1. 写入 feed url 2. 定义要显示的项目数量 3. 如果需要显示项目的描述，则勾选 4. 如果勾选了第 3 项，请选择描述的长度 5. 保存并关闭

在前端应如何显示。

管理

迁移到 2.0

扩展版本 2.0 已使用 Extbase 作为底层框架重写。数据库结构已更改。为了平滑迁移，请从扩展管理器运行更新向导。脚本将负责构建 Flex Form 并更改 list_type 插件签名。

建议备份表 tt_content!!!

插件类型 USER_INT 与 USER

在扩展管理器中，可以决定由插件还是全局缓存首选项处理缓存。这被称为 USER_INT 与 USER。如果设置为 USER_INT，默认缓存时长为 3600 秒，可以通过 TS 进行更改。如果设置为 USER，则缓存时长与配置的缓存页面相同。更改此值时，请务必清除 TYPO3 缓存!!

避免缓存

每当 RSS Display 在 URL 中检测到参数 no_cache=1 时，都会跳过缓存框架。这在开发模式或强制重新生成缓存时很方便。

添加自定义模板

RSS Display 足够灵活，可以添加自定义模板，然后在 BE 中的下拉菜单中显示。然后，BE 用户可以选择此自定义模板。新的模板必须通过 TypoScript 添加/配置，例如

# To be added somewhere in your settings
# Replace "foo" by your extension.
plugin.tx_rssdisplay {
        settings {
                templates {

                        # foo1 is just a key which must be unique
                        foo_1 {
                                label = My Template
                                path = EXT:foo/Resources/Private/Templates/Feed/Show.html
                        }
                }
        }
}

视图助手

RSS Display 有各种视图助手可以与 SimplePie 对象交互，该对象提供了从 feed 项目中获取数据的 API。以下是一些高级视图助手的说明

# Retrieve a custom value from the item "author". See the API http://simplepie.org/wiki/reference/start#methods1
<feed:item.get value="author"/>

# Retrieve a value of a custom tag according to a namespace
<feed:item.tag namespace="http://purl.org/dc/elements/1.1/" tag="foo"/>

# Retrieve multiple values from a tag according to a namespace
# The example uses the shorthand syntax of Fluid - @see http://forge.typo3.org/issues/5033
<f:for each="{feed:item.tags(namespace: 'http://purl.org/dc/elements/1.1/' tag: 'bar')}" as="value">
        {value}
</f:for>
{namespace feed=Fab\RssDisplay\ViewHelpers}

配置

属性: cacheDuration
数据类型: integer
描述: 缓存的寿命。该值仅在扩展是USER_INT（默认设置）时相关。扩展也可以在扩展管理器中配置为USER。
默认: 3600

fab / rss-display

维护者

详细信息