README

此插件为 October CMS 添加了一个简单的可嵌入论坛。

此插件的视频演示如下

• https://vimeo.com/97088926

在 October CMS 市场查看此插件

• https://octobercms.com/plugin/rainlab-forum

配置

论坛无需立即配置即可运行。然而，以下选项是可用的。

• 论坛类别（频道）可以通过系统 > 频道菜单进行管理。
• 论坛成员可以通过用户菜单进行管理。

显示频道列表

插件包含一个名为 forumChannels 的组件，应将其用作论坛的主页。将组件添加到您的页面，并用组件标签渲染它

{% component 'forumChannels' %}

您应该告诉此组件有关其他论坛页面。

• channelPage - 用于查看单个频道主题的页面。
• topicPage - 用于查看讨论主题和帖子的页面。
• memberPage - 用于查看论坛用户的页面。

RSS 源

使用 forumRssFeed 组件显示包含最新博客文章的 RSS 源。支持以下属性

• channelFilter - 用于筛选主题的频道 slug。如果留空，则显示所有主题。
• topicsPerPage - 在源中显示的主题数量。默认值为 20。
• forumPage - 主论坛页面的路径。
• topicPage - 主题详细信息页面的路径。

该组件可以用于任何页面，它将劫持整个页面周期以以 RSS 格式显示源。以下示例显示了如何使用它

title = "RSS Feed"
url = "/forum/rss.xml"

[forumRssFeed]
forumPage = "forum"
topicPage = "forum/topic"
==
<!-- This markup will never be displayed -->

示例页面结构

forum/home.htm

title = "Forum"
url = "/forum"
layout = "default"

[forumChannels]
memberPage = "forum/member"
channelPage = "forum/channel"
topicPage = "forum/topic"
==

<h1>Forum</h1>
{% component 'forumChannels' %}

forum/channel.htm

title = "Forum"
url = "/forum/channel/:slug"
layout = "default"

[forumChannel]
memberPage = "forum/member"
topicPage = "forum/topic"
==

<h1>{{ channel.title }}</h1>
{% component 'forumChannel' %}

forum/topic.htm

title = "Forum"
url = "/forum/topic/:slug"
layout = "default"

[forumTopic]
memberPage = "forum/member"
channelPage = "forum/channel"
==

<h1>{{ topic.subject }}</h1>
{% component 'forumTopic' %}

forum/member.htm

title = "Forum"
url = "/forum/member/:slug"
layout = "default"

[forumMember]
channelPage = "forum/channel"
topicPage = "forum/topic"
==

<h1>{{ member.username }}</h1>
{% component 'forumMember' %}

许可证

此插件是 October CMS 平台的官方扩展，如果您拥有平台许可证，则可免费使用。有关详细信息，请参阅EULA 许可证。