6 | | 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 permissions granted. Appending new forums and topics either as new replies shows up in timeline. Searching capability in topics and replies is supported too. |
7 | | |
8 | | == Screenshots |
9 | | |
10 | | To get an idea how the forums look, see [attachment:discussion_list.png], [attachment:admin.png] and [attachment:thread.png]. |
| 7 | This plugin adds discussion forums to Trac. |
| 8 | |
| 9 | Key features: |
| 10 | * Any number of forums can be added and organized to forum groups. |
| 11 | * Users can create topics in forums and reply to them which together creates discussion threads. |
| 12 | * Threaded or flat view to topics and its replies is supported. |
| 13 | * Each forum has a list of moderators who can delete topics, replies, etc. |
| 14 | * Plugin is administrated directly or via Trac administration interface with appropriate permissions granted. |
| 15 | * Appending new forums and topics either as new replies shows up in timeline. |
| 16 | * Searching capability in topics and replies is supported too. |
| 17 | |
| 18 | === Screenshots |
| 19 | |
| 20 | Discussion list: |
| 21 | |
| 22 | [[Image(discussion_list.png, 450px)]] |
| 23 | |
| 24 | Admin page: |
| 25 | |
| 26 | [[Image(admin.png, 450px)]] |
| 27 | |
| 28 | Thread: |
| 29 | |
| 30 | [[Image(thread.png, 450px)]] |
27 | | == Dependencies |
28 | | |
29 | | 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. |
30 | | |
31 | | == Plugin Versions |
32 | | |
33 | | 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: |
| 49 | == Installation |
| 50 | |
| 51 | === Dependencies |
| 52 | |
| 53 | If you need spam filtering features, then the SpamFilterPlugin is required. In other cases, disable a !DiscussionSpamFilter component. On Trac versions older than 0.10, the DiscussionPlugin depends on a WebAdminPlugin, since many configuration options are available only on appropriate WebAdminPlugin's pages. |
| 54 | |
| 55 | Sqlite version 3 or PostgreSQL is required as the database for running this plugin. |
| 56 | |
| 57 | === Plugin versions |
| 58 | |
| 59 | This plugin names its branches according to Trac versions: |
107 | | options controlls number of items displayed in topic and message lists at each page of pagination. |
108 | | 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. |
109 | | |
110 | | |
111 | | If you run Trac in environment which needs to enable plugins explicitly put in trac.ini these lines: |
| 134 | options controls number of items displayed in topic and message lists at each page of pagination. |
| 135 | You can type list of email addresses into {{{smtp_always_cc}}} option to send all discussion plugin email notification to them. Previous example shows default values for these options. |
| 136 | |
| 137 | If you run Trac in an environment which needs to enable plugins explicitly, put in `trac.ini` these lines: |
139 | | Discussion plugin defines five permissions. With DISCUSSION_VIEW permission you can view all topics and you can post replies to them with DISCUSSION_APPEND permission. Attachments can be added to the topics with DISCUSSION_ATTACH 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 web administration interface to do it for you. |
| 163 | This plugin defines the following permissions: |
| 164 | * With `DISCUSSION_VIEW` permission you can view all topics and you can post replies to them with `DISCUSSION_APPEND` permission. |
| 165 | * Attachments can be added to the topics with `DISCUSSION_ATTACH` permission. |
| 166 | * The `DISCUSSION_MODERATE` permission gives you rights to delete replies or topics where you are defined as a moderator. |
| 167 | * The `DISCUSSION_ADMIN` permission gives you administrator rights to create, modify or delete forum groups, forums and topics. |
| 168 | |
| 169 | You can add these permissions by typing the following commands from commandline or you can use web administration interface to do it for you: |
142 | | # trac-admin <path_to_environment> permission add <user> DISCUSSION_VIEW |
143 | | # trac-admin <path_to_environment> permission add <user> DISCUSSION_APPEND |
144 | | # trac-admin <path_to_environment> permission add <user> DISCUSSION_ATTACH |
145 | | # trac-admin <path_to_environment> permission add <user> DISCUSSION_MODERATE |
146 | | # trac-admin <path_to_environment> permission add <user> DISCUSSION_ADMIN |
| 172 | $ trac-admin <path_to_environment> permission add <user> DISCUSSION_VIEW |
| 173 | $ trac-admin <path_to_environment> permission add <user> DISCUSSION_APPEND |
| 174 | $ trac-admin <path_to_environment> permission add <user> DISCUSSION_ATTACH |
| 175 | $ trac-admin <path_to_environment> permission add <user> DISCUSSION_MODERATE |
| 176 | $ trac-admin <path_to_environment> permission add <user> DISCUSSION_ADMIN |