Version 33 (modified by 17 years ago) (diff) | ,
---|
Discussion forum plugin
Notice: This plugin is unmaintained and available for adoption.
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
You can download zipped sources [download:discussionplugin here].
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.search.discussionsearch = 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
For now sqlite version 3 or PostgreSQL is required as SQL backend for running this plugin.
Permissions
Discussion plugin defines four permissions. With DISCUSSION_VIEW permission you can view all topics and you can post replies to them with DISCUSSION_APPEND permission. DISCUSSION_MODERATE permission gives you rights to delete replies or topics where are you defined as moderator. DISCUSSION_ADMIN 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_APPEND # trac-admin <path_to_environment> permission add <user> DISCUSSION_MODERATE # trac-admin <path_to_environment> permission add <user> DISCUSSION_ADMIN
Macros
There are few wiki macros available:
[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].
Testing
Because of that DiscussionPlugin code is growing up, I've made testing sheet for controling if some feature had't been broken sine last commits. You can find this sheet in plugin's SVN repository.
Feedback
Change Log
- 17854 by rjollos on 2020-08-21 20:44:35
-
TracDiscussion 1.2.2dev: Make compatible with Trac 1.4+
Fixes #13877.
- 17713 by rjollos on 2020-04-30 01:50:36
-
TracDiscussion 1.2.2dev: Use
authorinfo
to format name in topic list
Refs #13778.
- 17637 by rjollos on 2019-12-19 09:35:13
-
TracDiscussion 1.2.1: Publish to PyPI
Refs #13659.
- 16775 by rjollos on 2017-08-26 03:49:19
-
TracDiscussion 1.2: Update copyright info
- 16671 by rjollos on 2017-06-19 05:05:51
-
TracDiscussion 1.2dev: Fix incorrect username in input fields
format_author
should not be used in input fields.
(more)
Author/Contributors
Attachments (3)
-
discussion_list.png (101.9 KB) - added by 12 years ago.
Screenshot of discussion listing.
-
admin.png (139.7 KB) - added by 12 years ago.
Screenshot of administration interface.
-
thread.png (144.1 KB) - added by 12 years ago.
Screenshot of message list in a thread.
Download all attachments as: .zip