Plugin: comments
Author: Simon McVittie
Included in ikiwiki: yes
Enabled by default: no
Included in goodstuff: no
Currently enabled: no

This plugin adds "blog-style" comments. Unlike the wiki-style freeform Discussion pages, these comments are posted by a simple form, cannot later be edited, and rss/atom feeds are provided of each page's comments.

When using this plugin, you should also enable htmlscrubber and either htmltidy or htmlbalance. Directives are filtered out by default, to avoid commenters slowing down the wiki by causing time-consuming processing. As long as the recommended plugins are enabled, comment authorship should hopefully be unforgeable by CGI users.

The intention is that on a non-wiki site (like a blog) you can lock all pages for admin-only access, then allow otherwise unprivileged (or perhaps even anonymous) users to comment on posts. See the documentation of the lockedit and anonok pages for details on locking down a wiki so users can only post comments.

Individual comments are stored as internal-use pages named something like page/comment_1, page/comment_2, etc. These pages internally use a [[!_comment ]] directive.

There are some global options for the setup file:

comment moderation

If you enable the blogspam plugin, comments that appear spammy will be held for moderation. Wiki admins can access the comment moderation queue via a button on their Preferences page.

The comments are stored in .ikiwiki/comments_pending/, and can be deleted, or moved into the wiki's srcdir to be posted.