README

注意：SilverStripe 2.4的新闻模块在ss24分支上可用！

维护者联系方式

Marcus Nyeholt

<marcus (at) silverstripe (dot) com (dot) au>

要求

SilverStripe 3.0.x

概述

新闻模块提供了一种简单的方法来创建和发布网站上的新闻文章。在某些方面，它与博客模块相似，但新闻文章更侧重于新闻稿风格的文本内容——这意味着新闻文章可以表示为普通内容、托管文件（例如PDF）或完全独立的网站上的文章。此外，新闻文章允许作者为正文指定单独的摘要，这在聚合网站上内容引用时很有用，并允许作者为文章附加缩略图。

新闻容器可以配置为自动将包含的文章按日期分层归档，为归档目的生成分层结构。

与博客模块不同，新闻模块完全不支持小部件，并且默认不启用评论。虽然您可以通过自己添加来实现这些功能，但这不是模块功能的核心。

文档

将文件提取到您的SilverStripe文件夹中的“news”目录，并运行dev/build。现在您应该有一个“新闻容器”页面类型，以及可以在新闻容器下创建的新闻条目页面类型。

新闻模块还提供将文章自动归档到按年份、月份和日期排序的层次结构的功能。这将自动为新闻文章提供“归档”类型的功能。要启用此功能，请在新闻容器上选择“自动归档包含的文章”复选框。

已知问题

当使用自动归档功能创建文章时，如果其最终父位置不可见，文章最初将出现在网站树根目录，尽管它已被创建在正确位置之下。刷新树可以解决这个问题。

当容器包含子容器页面并使用子部分循环时，分页将不起作用，因为分页详情将针对每个子容器页面单独。请使用TotalChildArticles循环而不是子部分来解决这个问题。

<% if TotalChildArticles %>
		<div <% if FirstLast %>class="$FirstLast"<% end_if %>>
			<% include NewsListItem %>
		</div>
		<% if TotalChildArticles.MoreThanOnePage %>
			<div id="NextPrevLinks" class="news-pagination">
			  <% if TotalChildArticles.NotLastPage %>
				<div id="NextLink" class="next">
					<p><a class="next" href="$TotalChildArticles.NextLink" 
						title="View the next page">See older articles</a></p>
				</div>
			  <% end_if %>
			  <% if TotalChildArticles.NotFirstPage %>
				<div id="PrevLink" class="previous">
					<p><a class="prev" href="$TotalChildArticles.PrevLink" 
						title="View the previous page">See newer articles</a></p>
				</div>
			  <% end_if %>
			  <span>
				<% if TotalChildArticles.PaginationSummary %><% loop TotalChildArticles.PaginationSummary %>
				  <% if CurrentBool %>
					<p class="current">
						$PageNum
					</p>
				  <% else %>
					<a class="pagination-link" href="$Link" i
						title="View page number $PageNum">$PageNum</a>
				  <% end_if %>
				<% end_loop %><% end_if %>
			  </span>
			</div>
		 <% end_if %>
<% end_if %>