Changes between Version 94 and Version 95 of DiscussionPlugin
- Timestamp:
- Apr 28, 2014, 11:47:30 PM (10 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
DiscussionPlugin
v94 v95 1 1 [[PageOutline(2-5,Contents,pullout)]] 2 = Discussion Forum Plugin =3 4 == Description ==2 = Discussion Forum Plugin 3 4 == Description 5 5 6 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 7 8 == Screenshots ==8 == Screenshots 9 9 10 10 To get an idea how the forums look, see [attachment:discussion_list.png], [attachment:admin.png] and [attachment:thread.png]. 11 11 12 == Request for Adoption ==12 == Request for Adoption 13 13 14 14 The plugin is not actively developed anymore. If you would like to adopt its development contact user Blackhex. 15 15 16 == Bugs/Feature Requests ==16 == Bugs/Feature Requests 17 17 18 18 Existing bugs and feature requests for DiscussionPlugin are [query:status!=closed&component=DiscussionPlugin&order=priority here]. … … 21 21 [/newticket?component=DiscussionPlugin&owner=Blackhex new ticket] but read BugReporting page first, please. 22 22 23 == Download ==23 == Download 24 24 25 25 Download the zipped source from [download:discussionplugin here]. 26 26 27 == Source ==27 == Source 28 28 29 29 You can [http://trac-hacks.org/svn/discussionplugin check out] !DiscussionPlugin using Subversion, or [source:discussionplugin browse the source] with Trac. 30 30 31 == Dependencies ==31 == Dependencies 32 32 33 33 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. 34 34 35 == Plugin Versions ==35 == Plugin Versions 36 36 37 37 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: … … 40 40 || 0.9 || 0.9-stable || 0.5 || 41 41 || 0.10 || 0.10-stable || 0.5 || 42 || 0.11 || 0.11-stable (and forward s-compatible up to Trac 1.1.1 by now) || 0.9dev ||42 || 0.11 || 0.11-stable (and forward-compatible up to Trac 1.1.1 by now) || 0.9dev || 43 43 44 44 Main difference between 0.5 and 0.6 version is that 0.6 uses Genshi templates and 0.5 !ClearSilver ones. 45 45 46 == Installation ==46 == Installation 47 47 48 48 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: … … 113 113 If you run Trac in environment which needs to enable plugins explicitly put in trac.ini these lines: 114 114 115 {{{ 116 #!ini 115 {{{#!ini 117 116 [components] 118 117 tracdiscussion.admin.DiscussionWebAdmin = enabled … … 132 131 The next step is to upgrade your environment: 133 132 134 {{{ 135 #!sh 133 {{{#!sh 136 134 # trac-admin <path_to_environment> upgrade 137 135 }}} … … 139 137 For now sqlite version 3 or PostgreSQL is required as SQL backend for running this plugin. 140 138 141 == Permissions ==139 == Permissions 142 140 143 141 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. 144 142 145 {{{ 146 #!sh 143 {{{#!sh 147 144 # trac-admin <path_to_environment> permission add <user> DISCUSSION_VIEW 148 145 # trac-admin <path_to_environment> permission add <user> DISCUSSION_APPEND … … 152 149 }}} 153 150 154 == Macros ==151 == Macros 155 152 156 153 There are few wiki macros available: … … 191 188 Displays list of recently changed topics in a forum <forum_id> or in all forums, if <forum_id> is not specified, grouped by the day of their last change. Second argument <number_of_topics> limits the number of recently changed topics displayed. 192 189 193 === Example ===190 === Example 194 191 195 192 {{{ … … 198 195 }}} 199 196 200 == Attachments ==197 == Attachments 201 198 202 199 Foreign files can also be attached to topics and then linked in replies. For this purpose you can use general Trac attachment link syntax with discussion domain and topic resource: … … 215 212 }}} 216 213 217 == Planned Features ==214 == Planned Features 218 215 219 216 - Better permission system (maybe using 0.11 permissions policies). 220 217 - [https://subtrac.sara.nl/oss/email2trac email2trac] support. 221 218 222 == Notes ==219 == Notes 223 220 224 221 - Branches 0.9 and 0.10 of the plugin are considered as deprecated and not developed anymore. User-contributed backporting patches are welcomed though. 225 222 - Branch 0.11 of the plugin is tested mainly with Trac>=1.0. If your sure that you've encountered a problem on Trac 0.11, just create a ticket about it. Separate branch 1.0 will be created only before significant changes to the plugin. So this will likely not happen before adoption of Trac 1.0 db API changes. 226 223 227 == Support ==228 229 If you have any troubles with plugin's installation or configuration and your problem is generally Trac related, you can ask on #trac channel at Freenode IRC network to get the quickest answer, or use the trac-users mailing-list.230 231 == Feedback ==224 == Support 225 226 If you have any troubles with plugin's installation or configuration and your problem is generally Trac related, you can ask on [trac:IrcChannel #trac channel] at Freenode IRC network to get the quickest answer, or use the [trac:MailingList trac-users mailing-list]. 227 228 == Feedback 232 229 233 230 [[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;)]] 234 231 235 == Change Log ==232 == Change Log 236 233 237 234 [[ChangeLog(/discussionplugin, 3)]] 238 235 239 == Author/Contributors ==236 == Author/Contributors 240 237 241 238 '''Author:''' [wiki:Blackhex Blackhex] [[BR]] 242 '''Maintainer:''' ''none''[[BR]]239 '''Maintainer:''' [[Maintainer]] [[BR]] 243 240 '''Contributors:''' [wiki:athomas], [wiki:hasienda], [wiki:lucid], [wiki:rjollos][[BR]]