X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/blobdiff_plain/30308664a698102bdb15995d9d0d65e213c49964..98f0727a3521d5e3829f2f4cd7779b491580d86f:/doc/plugins/blogspam.mdwn diff --git a/doc/plugins/blogspam.mdwn b/doc/plugins/blogspam.mdwn index 466afd8d9..3dd017f61 100644 --- a/doc/plugins/blogspam.mdwn +++ b/doc/plugins/blogspam.mdwn @@ -1,5 +1,5 @@ [[!template id=plugin name=blogspam author="[[Joey]]"]] -[[!tag type/auth]] +[[!tag type/auth type/comments]] This plugin adds antispam support to ikiwiki, using the [blogspam.net](http://blogspam.net/) API. Both page edits and @@ -15,12 +15,15 @@ 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 problimatic tests. +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 all edits. If you only want to check [[comments]] (not wiki page edits), -set it to "postcomment(*)". +set it to "postcomment(*)". Posts by admins are never checked for spam. By default, the blogspam.net server is used to do the spam checking. To change this, the `blogspam_server` option can be set to the url for a