winter/wn-forum-plugin

Forum plugin for Winter CMS

Fund package maintenance!
wintercms
Open Collective

Installs: 670

Dependents: 1

Suggesters: 0

Security: 0

Stars: 5

Watchers: 5

Forks: 5

Open Issues: 2

Type:winter-plugin

v2.0.2 2022-08-01 08:49 UTC

This package is auto-updated.

Last update: 2024-12-20 07:37:40 UTC


README

MIT License

This plugin adds a simple embeddable forum to Winter CMS websites.

A video demonstration of this plugin can be seen here: https://vimeo.com/97088926

Supports:

  • Topics
  • Channels
  • Members
  • Posts
  • RSS Feeds

Installation

This plugin is available for installation via Composer.

composer require winter/wn-forum-plugin

After installing the plugin you will need to run the migrations and (if you are using a public folder) republish your public directory.

php artisan migrate

Configuration

The forum does not require immediate configuration to operate. However the following options are available.

  • Forum categories (Channels) can be managed via the System > Channels menu.
  • Forum members can be managed via the User menu.

Displaying a list of channels

The plugin includes a component forumChannels that should be used as the main page for your forum. Add the component to your page and render it with the component tag:

{% component 'forumChannels' %}

You should tell this component about the other forum pages.

  • channelPage - the page used for viewing an individual channel's topics.
  • topicPage - the page used for viewing a discussion topic and posts.
  • memberPage - the page used for viewing a forum user.

RSS feed

Use the forumRssFeed component to display an RSS feed containing the latest blog posts. The following properties are supported:

  • channelFilter - a channel slug to filter the topics by. If left blank, all topics are displayed.
  • topicsPerPage - how many topics to display on the feed. The default value is 20.
  • forumPage - path to the main forum page.
  • topicPage - path to the topic details page.

The component can be used on any page, it will hijack the entire page cycle to display the feed in RSS format. The next example shows how to use it:

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

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

Example page structure

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' %}