跳转到主要内容

适用于Silva 3的新闻插件

项目描述

silva.app.news 是一个用于 Silva 3 的插件,允许作者在 Silva 中添加新闻文章和日程项目。

对于Silva的旧版本,请使用 Products.SilvaNews 的旧版本。

使用Silva新闻

首先需要做的是在ZMI的Silva根目录下向service_news对象添加主题和目标受众。这个对象仅用于管理这些列表(主题和目标受众),它们将作为newsfilters(稍后在本文档中详细介绍)搜索的依据。在设置新闻时,最好将当前可用的所有主题和目标受众添加到服务中,因为列表是过滤系统的基础,必须进入ZMI添加项目(因此需要适当的权限来编辑ZMI中的内容)。管理这些列表非常简单:您可以通过在文本字段中填写一个字符串并按下相应的“添加”按钮来添加一个项目,通过勾选项目前面的复选框并点击相应的“删除”按钮来删除它们。

添加新闻发布

新闻条目只能添加到新闻发布中。要添加,请转到SMI并从可添加菜单中选择“Silva新闻发布”(文件夹、出版物和Silva根目录编辑标签页的右上角)。输入一个ID和标题,然后选择“添加并编辑”,您将被带到新闻发布的编辑标签页。这个标签页看起来很像Silva中其他容器(文件夹、出版物)的编辑标签页,除了它没有默认文档或视图,也不能包含除新闻条目(文章和日历条目)、文件夹和出版物之外的内容(因此允许更结构化的新闻发布设置)。您可以通过选择此标签页中的添加菜单中的特定类型来添加新闻条目。

属性标签

在新闻发布的属性标签中,有一个名为“限制访问”的复选框。当勾选此选项时,文件夹只能由位于该文件夹及其所有子文件夹中的新闻和日历过滤器找到。这可以用来使新闻发布“私有”,使其仅对例如一个部门可用。

添加新闻条目

现在作者可以添加新闻条目。如前所述,有两种类型的新闻条目:文章和日历条目。主要区别在于日历条目必须包含事件发生的日期/时间,并包含事件发生的地点。开始日期/时间是必要的,以便在日历查看器中显示项目,因为它们显示特定时间段的项目(例如,一个月)。因此,日历查看器只能显示日历条目。新闻查看器能够显示文章和日历条目。系统正常运行所需的其他数据字段是“主题”和“目标受众”,作者可以使用它们对新闻条目进行分类。这些字段将稍后由新闻过滤器用作将项目路由到新闻查看器的依据。在编辑文章或日历条目时,请记住,内容编辑器中放置的第一个标题被认为是新闻条目的子标题,第一个段落是导语(两者都将显示在查看器的预览中)。

添加新闻过滤器

为了让系统正常工作,接下来需要添加一个或多个新闻和日历过滤器。这些是编辑器或主编用于过滤新闻条目流的对象。项目可以根据主题和目标受众进行过滤(例如,新闻过滤器可以将仅包含特定主题或针对特定目标受众的新闻条目路由到查看器)和/或单独(按新闻条目)。过滤器的另一个功能是能够“坚持当前路径”,当设置此选项时,过滤器只从其容器的子目录中拾取项目。

过滤器编辑标签

新闻过滤器的内容选项卡显示所有可用的新闻出版物列表(不包括通过勾选“限制访问”复选框设置为私有且不在同一文件夹或新闻过滤器父文件夹中的那些)。要将新闻出版物的新闻条目路由到新闻观众(稍后将详细介绍),请确保勾选新闻出版物前面的复选框,并点击“更新源”按钮。然后,所有符合新闻过滤器标准的(已发布)新闻条目将路由到使用此过滤器的新闻观众。这些标准可以在新闻过滤器的“属性”选项卡中设置:您会再次看到服务_news的主题和目标受众列表,在新闻过滤器中还有几个单选按钮,用于选择是否将议程条目以及文章路由。这些标准可以用于以不同方式在Silva实例中向新闻观众分发文章和议程条目。

例如:多个不同的新闻出版物可以包含不同主题和针对不同受众的文章和议程条目,新闻过滤器将过滤和分发特定条目给观众。请注意,这意味着必须合理设置过滤器,以便在网站上显示所有新闻条目:很容易设置系统,使具有特定主题或目标受众的文章和议程条目被所有新闻过滤器过滤掉,从而被排除在所有观众之外。

“条目”选项卡

可以使用“条目”选项卡过滤特定条目,允许编辑和主编禁止特定文章和议程条目被过滤器路由。要过滤特定条目,取消勾选其前面的复选框,并选择“更新”。

现在可以放置新闻和议程观众。观众是负责向公众展示文章和议程条目的对象。作者可以将观众放置在他希望显示新闻的地方。观众显示由过滤器路由的条目列表。

观众编辑选项卡

观众设置相当简单:唯一重要的选项卡是第一个(编辑),在这里您可以设置观众将回顾(对于新闻观众)或前瞻(对于议程观众)多少天以获取条目。在新闻观众的情况下,还有一个开关用于选择要显示的条目数量。还有一个可用过滤器的列表。所有在此选择的过滤器都用于检索新闻。放置后,观众将向公众开放,并显示文章和/或议程条目,以及一个存档(允许显示特定月份的条目)和搜索选项。

将“/rss”追加到新闻观众的URL中,将显示此观众中条目的RSS 1.0(RDF兼容)视图。

RSS聚合器

RSS聚合器取代了旧的(现在已删除的)RSSViewer。在编辑屏幕中,您将看到一个名为“RSS源”的文本框,您可以在其中输入要由此聚合器实例合并的源完整URL。

所有其他功能与新闻观众相同。

代码仓库

您可以在Git中找到此扩展的代码:[https://github.com/silvacms/silva.app.news](https://github.com/silvacms/silva.app.news)

变更日志

3.0.4 (2013/12/19)

  • 更改了在议程和新闻条目中显示日期的方式:不再使用本地设置正确翻译它们。显示 recurrence 信息。

  • 验证并防止使用已删除或重命名的服务中的主题和目标受众时出现的错误。

  • 改进测试。

3.0.3 (2013/10/09)

  • 议程过滤器只能由议程观众使用。议程观众API已清理。

  • 扩展内联新闻观众代码源可用的API。

  • 现在可以使用JSON文件导入和导出新闻服务内部的主题和目标受众。

  • 已更新JavaScript小部件。

  • 改进测试。

3.0.2 (2013/05/27)

  • 强制日期索引使用64位BTree存储其值。

3.0.1 (2013/03/06)

  • 更新Silva XML导入和导出API。

  • 修复树小部件。

  • 改进XML导入导出测试。

3.0 (2012/12/11)

  • 新闻出版物可以直接由代码源内的新闻查看器使用。

  • 修复当向新闻视图提供无效参数(无效日期范围)时的各种小错误。

3.0c1 (2012/09/25)

  • 更新API到Silva 3.0c1。

  • 各种可用性改进。

  • 修复错误。

  • 改进测试。

3.0b1 (2011/11/11)

  • 作为SilvaNews的分支的初始版本,基于silva.app.document而不是Products.SilvaDocument,并使用silva.ui

项目详情


下载文件

下载适合您平台的文件。如果您不确定选择哪一个,请了解更多关于安装包的信息。

源分布

silva.app.news-3.0.4.tar.gz (392.9 kB 查看散列)

上传时间

由以下组织支持