winter / wn-forum-plugin
Forum plugin for Winter CMS
Fund package maintenance!
wintercms
Open Collective
Installs: 652
Dependents: 1
Suggesters: 0
Security: 0
Stars: 5
Watchers: 5
Forks: 5
Open Issues: 2
Type:winter-plugin
Requires
- php: >=7.0
- composer/installers: ~1.0
- winter/wn-user-plugin: ^2.0.0
README
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' %}