X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/blobdiff_plain/0993933ea30f4fb28402f12a033cdd37015da427..a5d825f28632655b608564893428ef9142dddb04:/doc/plugins/blogspam.mdwn?ds=inline diff --git a/doc/plugins/blogspam.mdwn b/doc/plugins/blogspam.mdwn index 307d4646d..a13b6e8f4 100644 --- a/doc/plugins/blogspam.mdwn +++ b/doc/plugins/blogspam.mdwn @@ -3,13 +3,22 @@ This plugin adds antispam support to ikiwiki, using the [blogspam.net](http://blogspam.net/) API. Both page edits and -[[comment|comments]] postings can be checked for spam. Currently, -detected spam is not saved for human review, it is just rejected. +[[comment|comments]] postings can be checked for spam. Page edits that +appear to contain spam will be rejected; comments that look spammy will be +stored in a queue for moderation by an admin. -You can control how content is tested via the `blogspam_options` -setting. By default, the options are configured in a way that is -appropriate for wiki content. This includes turning off some of the -more problimatic tests. +To check for and moderate comments, log in to the wiki as an admin, +go to your Preferences page, and click the "Comment Moderation" button. + +The plugin requires the [[!cpan RPC::XML]] perl module. + +You can control how content is tested via the `blogspam_options` setting. +The list of options is [here](http://blogspam.net/api/testComment.html#options). +By default, the options are configured in a way that is appropriate for +wiki content. This includes turning off some of the more problematic tests. +An interesting option for testing is `fail`, by setting it (e.g., +`blogspam_options => 'fail'`), *all* comments will be marked as SPAM, so that +you can check whether the interaction with blogspam.net works. The `blogspam_pagespec` setting is a [[ikiwiki/PageSpec]] that can be used to configure which pages are checked for spam. The default is to check