Changes between Version 94 and Version 95 of DiscussionPlugin


Ignore:
Timestamp:
Apr 29, 2014 1:47:30 AM (6 months ago)
Author:
rjollos
Comment:

Use the maintainer macro.

Legend:

Unmodified
Added
Removed
Modified
  • DiscussionPlugin

    v94 v95  
    11[[PageOutline(2-5,Contents,pullout)]] 
    2 = Discussion Forum Plugin = 
    3  
    4 == Description == 
     2= Discussion Forum Plugin 
     3 
     4== Description 
    55 
    66The 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. 
    77 
    8 == Screenshots == 
     8== Screenshots 
    99 
    1010To get an idea how the forums look, see [attachment:discussion_list.png], [attachment:admin.png] and [attachment:thread.png]. 
    1111 
    12 == Request for Adoption ==  
     12== Request for Adoption 
    1313 
    1414The plugin is not actively developed anymore. If you would like to adopt its development contact user Blackhex. 
    1515 
    16 == Bugs/Feature Requests ==  
     16== Bugs/Feature Requests 
    1717 
    1818Existing bugs and feature requests for DiscussionPlugin are [query:status!=closed&component=DiscussionPlugin&order=priority here]. 
     
    2121[/newticket?component=DiscussionPlugin&owner=Blackhex new ticket] but read BugReporting page first, please. 
    2222 
    23 == Download == 
     23== Download 
    2424 
    2525Download the zipped source from [download:discussionplugin here]. 
    2626 
    27 == Source == 
     27== Source 
    2828 
    2929You can [http://trac-hacks.org/svn/discussionplugin check out] !DiscussionPlugin using Subversion, or [source:discussionplugin browse the source] with Trac. 
    3030 
    31 == Dependencies == 
     31== Dependencies 
    3232 
    3333If 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. 
    3434 
    35 == Plugin Versions == 
     35== Plugin Versions 
    3636 
    3737As 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: 
     
    4040|| 0.9           || 0.9-stable               || 0.5            ||  
    4141|| 0.10          || 0.10-stable              || 0.5            || 
    42 || 0.11          || 0.11-stable (and forwards-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         || 
    4343 
    4444Main difference between 0.5 and 0.6 version is that 0.6 uses Genshi templates and 0.5 !ClearSilver ones. 
    4545 
    46 == Installation == 
     46== Installation 
    4747 
    4848For 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: 
     
    113113If you run Trac in environment which needs to enable plugins explicitly put in trac.ini these lines: 
    114114 
    115 {{{ 
    116 #!ini 
     115{{{#!ini 
    117116[components] 
    118117tracdiscussion.admin.DiscussionWebAdmin = enabled 
     
    132131The next step is to upgrade your environment: 
    133132 
    134 {{{ 
    135 #!sh 
     133{{{#!sh 
    136134# trac-admin <path_to_environment> upgrade 
    137135}}} 
     
    139137For now sqlite version 3 or PostgreSQL is required as SQL backend for running this plugin. 
    140138 
    141 == Permissions == 
     139== Permissions 
    142140 
    143141Discussion 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.  
    144142 
    145 {{{ 
    146 #!sh 
     143{{{#!sh 
    147144# trac-admin <path_to_environment> permission add <user> DISCUSSION_VIEW 
    148145# trac-admin <path_to_environment> permission add <user> DISCUSSION_APPEND 
     
    152149}}} 
    153150 
    154 == Macros == 
     151== Macros 
    155152 
    156153There are few wiki macros available: 
     
    191188Displays 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. 
    192189 
    193 === Example === 
     190=== Example 
    194191 
    195192{{{ 
     
    198195}}} 
    199196 
    200 == Attachments == 
     197== Attachments 
    201198 
    202199Foreign 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: 
     
    215212}}} 
    216213 
    217 == Planned Features == 
     214== Planned Features 
    218215 
    219216 - Better permission system (maybe using 0.11 permissions policies). 
    220217 - [https://subtrac.sara.nl/oss/email2trac email2trac] support. 
    221218 
    222 == Notes == 
     219== Notes 
    223220 
    224221 - Branches 0.9 and 0.10 of the plugin are considered as deprecated and not developed anymore. User-contributed backporting patches are welcomed though. 
    225222 - 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. 
    226223 
    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 
     226If 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 
    232229 
    233230[[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;)]] 
    234231 
    235 == Change Log == 
     232== Change Log 
    236233 
    237234[[ChangeLog(/discussionplugin, 3)]] 
    238235 
    239 == Author/Contributors == 
     236== Author/Contributors 
    240237 
    241238'''Author:''' [wiki:Blackhex Blackhex] [[BR]] 
    242 '''Maintainer:''' ''none'' [[BR]] 
     239'''Maintainer:''' [[Maintainer]] [[BR]] 
    243240'''Contributors:''' [wiki:athomas], [wiki:hasienda], [wiki:lucid], [wiki:rjollos][[BR]]