The Discussion Plugin adds a discussion section after your wiki page for user comments. This is useful to separate page content and the discussion thereof and also, if you don't want to give normal users the right to edit the page but still want user contributed notes.

A second component of this plugin shows a list of all pages in a namespace with a discussion section (called discussion threads) ordered by most recent comments. This allows you to create a very simple discussion forum in your wiki.

This is the main part of the plugin. By including the ~~DISCUSSION~~ instruction in your wiki page, a discussion section will be appended after the normal wiki page content. To turn it off again, use ~~DISCUSSION:off~~. If you want to show the existing discussion but don't want to allow new comments / replies, use ~~DISCUSSION:closed~~.

~~DISCUSSION~~
~~DISCUSSION:off~~
~~DISCUSSION:closed~~

A custom title can be appended after the separator |.

~~DISCUSSION|Custom Title String~~
~~DISCUSSION:closed|Custom Title String~~

After each comment in the discussion section there may be up to three buttons (depending on your rights):

• Reply: To reply to a comment (vs. commenting on the wiki page content), click the Reply button. The comment entry form will then be placed accordingly.
• Edit: Registered users can edit their comments; admins can edit all comments. To remove a comment, just edit it, clear the text and save the empty comment – like you would do with a wiki page.
• Delete: Registered users and admin all comments.
  Attention: If there are replies to a comment, removing it will also remove all replies!
• Hide / Show: Admins can deactivate and reactivate comments easily by this button. Hidden comments aren't shown to normal users and are displayed dimmed to admins. Registered users can only hide their own comments.

Of course, the whole DokuWiki syntax can be used in comments as well. But there are problems with headers and footnotes as they may produce conflicting IDs and thus invalid XHTML. I'm looking for a way to either allow only a subset of the wiki syntax or automatically create unique IDs.

This displays a list of all pages of the given namespace with a discussion section. The list is sorted by the most recent comment.

{{threads>[namespace]&[count=n]&[flags]&skipempty}}

Default a new thread form is shown below the list. See threads_formposition setting for moving it to the top of the list, or to disable this form.

The plugin can be configured using DokuWiki's configuration manager available in the admin menu.

Please report bugs or feature requests at the Bug tracker.

• Merge pull request #219 from dokuwiki-translate/lang_update_107 (2016-09-30 11:54)
• translation update (2016-09-29 17:30)
• Merge pull request #218 from dokuwiki-translate/lang_update_98 (2016-09-28 19:26)
• translation update (2016-09-24 13:35)
• Release new version 2016-09-18, fixes compatibility with current Doku… (2016-09-18 16:04)
• Merge pull request #216 from dokuwiki-translate/lang_update_54 (2016-08-24 15:18)
• translation update (2016-08-24 15:00)
• Merge pull request #214 from pdbogen/pdbogen-preview-visibility-fix (2016-08-18 21:15)

• 2013-10-29:
  • Use the current mailer API of DokuWiki, this fixes problems with PHP installations with disabled /e modifier. This makes the plugin incompatible with DokuWiki versions older than Adora Belle (2012-09-10)
  • Fix the unsubscribe link in notification mails for logged in users
  • Re-implemented the enable/disable handling, comments are disabled automatically now when the discussion syntax is removed and automatic discussions are disabled.
  • Translation updates
• 2013-07-01: Fix the captcha check for logged-in users
• 2013-06-18:
  • Make the discussion plugin compatible with current versions of the captcha plugin
  • Add the option to specify separate moderator groups for comments
  • Use jQuery instead of the old JavaScript library, this makes the plugin compatible with DokuWiki version Weatherwax
• 2013-02-15: Security fix (XSS vulnerability), if you are using an older version of the discussion plugin you should upgrade ASAP!

I have DokuWiki formatting allowed in comments. I also have a LaTeX plugin. <math>\sum_x{x+5}</math> is not rendered within a discussion.

The plugin has built-in support for the CAPTCHA plugin. Additionally, one might also consider to use the Bad Behavior plugin.

You're probably not running the latest version of the plugin. Try to update to the latest version first.

Yes, use the newestfirst config option.

If you enable the notify option admins are notified for all comments.

The comments are saved in special meta files inside the <dokuwiki>/data/meta directory. Each page which has a discussion has a corresponding pagename.comments file.

You can change the size of the box by using the following CSS class:

div.dokuwiki div.comment_wrapper {}

Because it would break DokuWiki's revisions system.

Alternative: use the pagelist plugin to make an overview of “latest discussion” by using the {{threads>...}} syntax.

This is a know problem with the sidebar plugin which needs to be fixed by it's author. If you're looking for working alternatives in the meanwhile I suggest to have a look at the sidebarng plugin.

You can list all discussions with:

{{threads>*}}

Discussions aren't stored like regular wiki pages. This will not work.

This is possible using the feed plugin, please see there how it works.

The plugin disables subscription for logged-in users when the option “subscribers” ($conf['subscribers']) is activated in the configuration.

You will need to edit a line in the 'action.php' file which can be found in lib→plugins. Find the following line (281)

$comment['user']['id'] = 'test'.hsc($_REQUEST['user']);

and replace it with

$comment['user']['id'] = 'GUEST: '.hsc($_REQUEST['name']);

I'm not a developer of the plugin but I believe you can do this if you comment out the following lines 283-287 and 291:

                       
	// if(empty($_REQUEST['name']) or empty($_REQUEST['mail'])) return;
	// if(!mail_isvalid($_REQUEST['mail'])) {
		// msg($lang['regbadmail'], -1);
		// return;
	// } else {
		$comment['user']['id'] = 'test'.hsc($_REQUEST['user']);
		$comment['user']['name'] = hsc($_REQUEST['name']);
		$comment['user']['mail'] = hsc($_REQUEST['mail']);
	// }                  

and lines 983 - 988:

              <!--<div class="comment_mail">
                <label class="block" for="discussion__comment_mail">
                   <span><?php echo $lang['email'] ?>:</span>
                      <input type="text" class="edit<?php if($_REQUEST['comment'] == 'add' && empty($_REQUEST['mail'])) echo ' error'?>" name="mail" id="discussion__comment_mail" size="50" tabindex="2" value="<?php echo hsc($_REQUEST['mail'])?>" />
                </label>
              </div>--> 
              

in action.php inside the plugins directory. Anonymous users won't be able to subscribe tho. Please correct me if I'm breaking some other function with this. Until now there hasn't been a problem tho. Andy

Please report any bugs or feature wishes in the issue tracker!

• Please don't simply add other plugins as conflicts without explaining which part is broken either by reporting an issue (preferred) or explaining it on the discussion page.
• You can add and improve translations at http://translate.dokuwiki.org/plugin/discussion

For the discussion refer to the discussion page.