summaryrefslogtreecommitdiff
path: root/doc/plugins
diff options
context:
space:
mode:
authorJoey Hess <joey@gnu.kitenet.net>2009-01-16 22:39:11 -0500
committerJoey Hess <joey@gnu.kitenet.net>2009-01-16 22:39:11 -0500
commit7ee92cab4095fb22d77a0b0100a472c6901eb519 (patch)
tree805b6bf94c98083bb4fba06665f17b34f55397d5 /doc/plugins
parent16c56af605f40db843b859c537d42494e33ae4c4 (diff)
blogspam: New plugin, adding spam filtering for page editing / comment posting using the BlogSpam.net API.
Diffstat (limited to 'doc/plugins')
-rw-r--r--doc/plugins/blogspam.mdwn23
1 files changed, 23 insertions, 0 deletions
diff --git a/doc/plugins/blogspam.mdwn b/doc/plugins/blogspam.mdwn
new file mode 100644
index 000000000..307d4646d
--- /dev/null
+++ b/doc/plugins/blogspam.mdwn
@@ -0,0 +1,23 @@
+[[!template id=plugin name=blogspam author="[[Joey]]"]]
+[[!tag type/auth]]
+
+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.
+
+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.
+
+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(*)".
+
+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
+different server implementing the same API. Note that content is sent
+unencrypted over the internet to the server, and the server sees
+the full text of the content.