wiki:DiscussionPlugin

Version 23 (modified by Blackhex, 8 years ago) (diff)

Added documentation about plugins permissions.

Discussion forum plugin

Description

The DiscussionPlugin adds discussion forums to Trac. An arbitrary number of forums can be added, and each forum has a list of moderators who can block posts, etc. Plugin is administrated directly with apropriate rights for now but WebAdminPlugin support is planned.

Bugs/Feature Requests

Existing bugs and feature requests for DiscussionPlugin are here.

If you have any issues, create a new ticket.

Download

download:discussionplugin

Source

You can check out the source for DiscussionPlugin from Subversion at http://trac-hacks.org/svn/discussionplugin.

Installation

After installing plugin's egg you can set in trac.ini configuration file following variables:

[discussion]
title = Discussion

If you run Trac in environment which needs to enable plugins explicitly put in trac.ini these lines:

[components]
tracdiscussion.init.discussioninit = enabled
tracdiscussion.timeline.discussiontimeline = enabled
tracdiscussion.wiki.discussionwiki = enabled
tracdiscussion.admin.discussionwebadmin = enabled
tracdiscussion.core.discussioncore = enabled

The next step is to upgrade your environment:

# trac-admin <path_to_environment> upgrade

Permissions

Discussion plugin defines three permissions. With DISCUSSION_VIEW permission you can view all topics and post replies to them. DISCUSSION_MODERATE permission gives you rights to delete replies or topics where are you defined as moderator. DISCUSSION_MODIFY permission gives you administrator rights to create, modify or delete forum groups, forums and topics. You can add these permissions by typing following commands from commandline or you can use WebAdminPlugin to do it for you.

# trac-admin <path_to_environment> permission add <user> DISCUSSION_VIEW
# trac-admin <path_to_environment> permission add <user> DISCUSSION_MODERATE
# trac-admin <path_to_environment> permission add <user> DISCUSSION_MODIFY

Macros

There are few wiki maros avaiable:

[forum:<forum_id> <text>]

Displays link to forum with id <id> and text <text>. Second argument is optional.

[topic:<topic_id> <text>]

Displays link to topic with id <id> and text <text>. Second argument is optional.

[message:<message_id> <text>]

Displays link to reply with id <id> and text <text>. Second argument is optional.

[[ViewTopic(<topic_subject>)]]

Displays content of topic with subject <topic_subject>. If no subject given displays content of topic with same subject as name of current wiki page.

Example

Discuss this on the [forum:trac-dev Trac Development forum]. 
Useful threads are [topic:23 this one] and [topic:96 this one].

Author/Contributors

Author: athomas
Contributors: Blackhex

Attachments (3)

Download all attachments as: .zip