= Discussion Forum Plugin = == Description == The DiscussionPlugin adds discussion forums to Trac. An arbitrary number of forums can be added, organised to forum groups. Users can create topics in forums and reply to them which together creates discussion threads. Threaded or flat view to topics and its replies is supported. Each forum has a list of moderators who can delete topics, replies, etc. Plugin is administrated directly or via WebAdminPlugin with apropriate rights. Appending new forums and topics either as new replies shows up in timeline. Searching capability in topics and replies is supported too. == Bugs/Feature Requests == Existing bugs and feature requests for DiscussionPlugin are [report:9?COMPONENT=DiscussionPlugin here]. If you have any issues, create a [http://trac-hacks.org/newticket?component=DiscussionPlugin&owner=Blackhex new ticket] but read BugReporting page first, please. == Download == You can download zipped sources [download:discussionplugin here]. == Source == You can check out DiscussionPlugin from [http://trac-hacks.org/svn/discussionplugin here] using Subversion, or [source:discussionplugin browse the source] with Trac. == Dependencies == DiscussionPlugin depends on WebAdminPlugin since many configuration options are avaiable only on apropriate WebAdminPlugin's pages. == 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.admin.discussionwebadmin = enabled tracdiscussion.core.discussioncore = enabled tracdiscussion.init.discussioninit = enabled tracdiscussion.search.discussionsearch = enabled tracdiscussion.timeline.discussiontimeline = enabled tracdiscussion.wiki.discussionwiki = enabled tracdiscussion.notification.discussionnotifyemail = enabled }}} The next step is to upgrade your environment: {{{ # trac-admin 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 permission add DISCUSSION_VIEW # trac-admin permission add DISCUSSION_APPEND # trac-admin permission add DISCUSSION_MODERATE # trac-admin permission add DISCUSSION_ADMIN }}} == Macros == There are few wiki macros available: {{{ [forum: ] }}} Displays link to forum with id and text . Second argument is optional. {{{ [topic: ] }}} Displays link to topic with id and text . Second argument is optional. {{{ [message: ] }}} Displays link to reply with id and text . Second argument is optional. {{{ [[ViewTopic()]] }}} Displays content of topic with subject . If no subject given displays content of topic with same subject as name of current wiki page. Currently there is a limitation of post length using this macro because of using GET method of HTML form. == Example == {{{ Discuss this on the [forum:trac-dev Trac Development forum]. Useful threads are [topic:23 this one] and [topic:96 this one]. }}} == Planned Features == - Better permission system (maybe using 0.11 permissions policies). - Email notification. == Notes == - Branch 0.9 of plugin is considered as deprecated and not developed anymore. == Feedback == [[Poll(Are you using this plugin?; Yes, it's usefull.; No, it's useless.; No, I don't need it.; I think it will help;)]] == Change Log == [[ChangeLog(/discussionplugin, 5)]] == Author/Contributors == '''Author:''' [wiki:Blackhex Blackhex] [[BR]] '''Contributors:''' [wiki:athomas athomas] [[BR]]