Table of Contents

Description

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.

Components

Discussion Comments

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

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 existing discussion but don't want to allow new comments / replies, use ~~DISCUSSION:closed~~.

After each comment there may be up to three buttons (depending on rights):

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.

There is no toolbar. I don't consider this a major drawback, as raw text is usually enough for comments. Advanced users who know the wiki syntax are still free to use it. A toolbar for inexperienced users would be nice, but it's currently not possible to reuse the DokuWiki toolbar or a subset thereof.

How to discussion in the wiki?