= Discussion Forum Plugin = == Description == The DiscussionPlugin adds discussion forums to Trac. An arbitrary number of forums can be added, organized 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 Trac administration interface with appropriate rights. Appending new forums and topics either as new replies shows up in timeline. Searching capability in topics and replies is supported too. == Live Example == To get an idea how the forums look, see [http://blackhex.no-ip.org/discussion BlackTrac discussion]. == Donations == If you want to support plugin's development, you can donate some small amount via !PaySec or !PayPal (!PaySec prefered). If you specify particular feature, you want to support, in the note field, the donation will be used to develop that feature. {{{ #!html
}}} Any donation will be gratefully welcomed. == Bugs/Feature Requests == Existing bugs and feature requests for DiscussionPlugin are [query:status!=closed&component=DiscussionPlugin&order=priority here]. If you have any issues, create a [/newticket?component=DiscussionPlugin&owner=Blackhex new ticket] but read BugReporting page first, please. == Download and Source == You can [download:discussionplugin download zipped sources], check out [/svn/discussionplugin using Subversion], or [source:discussionplugin browse the source] with Trac. == Dependencies == If you need spam filtering feature working, the SpamFilterPlugin installation is required. In other cases, disable a !DiscussionSpamFilter component. On older Trac versions, the DiscussionPlugin depends on a WebAdminPlugin since many configuration options are available only on appropriate WebAdminPlugin's pages. Since Trac 0.10, the WebAdminPlugin is internal part of the Trac. == Plugin Versions == As many other plugins in this site even this plugin names its branches according to Trac versions. Here is a simple table explaining this convention for DiscussionPlugin: || Plugin Branch || Trac Branch || Plugin Version || || 0.9 || 0.9-stable || 0.5 || || 0.10 || 0.10-stable || 0.5 || || 0.11 || 0.11-stable, 0.12-stable || 0.6, 0.7 || Main difference between 0.5 and 0.6 version is that 0.6 uses Genshi templates and 0.5 !ClearSilver ones. == Installation == For general information about Trac plugins installation see TracPlugins. Plugin is configurable from {{{trac.ini}}} file, see TracIni for more on this topic. The following variables controls DiscussionPlugin's behavior: {{{ [discussion] title = Discussion default_topic_display = classic default_message_display = tree forum_sort = lasttopic forum_sort_direction = asc topic_sort = lastreply topic_sort_direction = asc topics_per_page = 30 messages_per_page = 50 smtp_always_cc = }}} Options: {{{title}}} :: changes title of main navigation bar button, {{{default_topic_display}}}:: changes between two possible displays of topic list - the {{{classic}}} and the {{{compact}}} view. {{{default_message_display}}}:: defines default display mode for message list. Possible values are {{{tree}}}, {{{flat}}}, {{{flat-asc}}} and {{{flat-desc}}}. {{{flat}}} is synonym for {{{flat-desc}}}. {{{forum_sort}}} :: is column by which will be sorted forum lists. Possible values are: * {{{id}}}, * {{{group}}}, * {{{name}}}, * {{{subject}}}, * {{{time}}}, * {{{moderators}}}, * {{{description}}}, * {{{topics}}}, * {{{replies}}}, * {{{lasttopic}}} and * {{{lastreply}}}. {{{topic_sort}}}:: to sort Topic lists. It has values * {{{id}}}, * {{{forum}}}, * {{{subject}}}, * {{{time}}}, * {{{author}}}, * {{{body}}}, * {{{replies}}} and * {{{lastreply}}}. {{{forum_sort_direction}}} and {{{topic_sort_direction}}}:: are directions of that sorting. They may be * {{{asc}}} and * {{{desc}}}. {{{topics_per_page}}} and {{{messages_per_page}}}:: options controlls number of items displayed in topic and message lists at each page of pagination. You can type list of e-mail addresses into {{{smtp_always_cc}}} option to send all discussion plugin e-mail notification to them. Previous example shows default values for these options. If you run Trac in environment which needs to enable plugins explicitly put in trac.ini these lines: {{{ [components] tracdiscussion.admin.DiscussionWebAdmin = enabled tracdiscussion.api.DiscussionApi = enabled tracdiscussion.core.DiscussionCore = enabled tracdiscussion.init.DiscussionInit = enabled tracdiscussion.notification.DiscussionEmailNotification = enabled tracdiscussion.search.DiscussionSearch = enabled tracdiscussion.spamfilter.DiscussionSpamFilter = enabled # Optional, disable if you don't have SpamFilterPlugin. tracdiscussion.timeline.DiscussionTimeline = enabled tracdiscussion.wiki.DiscussionWiki = enabled }}} The next step is to upgrade your environment: {{{ # trac-admin