====== botbouncer Plugin ======

---- plugin ----
description: Use online anti-commentspam-services to block access
author     : michiel 
email      : hello@botbouncer.org
type       : action, admin
lastupdate : 2013-04-23
compatible : Weatherwax
depends    : 
conflicts  : 
similar    : captcha
tags       : spam

downloadurl: https://github.com/michield/dokuwiki-plugin-botbouncer/archive/master.zip
bugtracker : https://github.com/michield/dokuwiki-plugin-botbouncer/issues
sourcerepo : https://github.com/michield/dokuwiki-plugin-botbouncer
donationurl: 

screenshot_img : #tba
----

This plugin contacts four anti-comment-spam services to determine whether a visitor to the Wiki is a spammer. I'm still experimenting, but the basics work. It will not block spammers 100%. On my site, I have not installed the captcha plugin, in order to see how well this plugin performs and I still get spam signups. 

The plugin works with 

StopForumSpam
http://www.stopforumspam.com/ is a free service, although donations are welcome. This plugin will always use this service. 

Akismet
http://akismet.com is an anti-comment-spam service from the makers of Wordpress. When you sign up, you get an API key, which you can enter in the configuration for this plugin to activate it.

Mollom
http://mollom.com is an anti-form-spam service from the makers of Drupal. They have a free service for sites with little activity, and as you to upgrade once you reach a certain activity level.
When you sign up, you get a private and a public key string, which you can enter in the configuration of this plugin to active using this service.

Project Honey Pot
http://www.projecthoneypot.org?rf=96521 is a free service that uses the DNS system to manage blocking. You need to sign up to get an API key, which you can enter in the configuration for this plugin, to use this service.


===== Installation =====

Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.

===== Examples/Usage =====

Once installed, you can enter the necessary API keys for the services mentioned. You will need to register to each of them. You can choose not to use all of them. The plugin will always use the StopForumSpam service.

=== Change Log ===

History:
  * 2013-04-24 - handle registration differently, bug fixes
  * 2013-04-23 - add some initial statistics
  * 2013-04-22 - add whitelist, and central logging
  * 2013-04-03 - initial setup allowing config and blocking

=== Known Bugs and Issues ===

The actual blocking is done by the services, not by this plugin. Therefore the effectives relies on the services.

=== ToDo/Wish List ===

  * give a nicer error message
  * more statistics and research on false positives
  * cleanup of logfile, to avoid it getting large

===== Discussion =====

(Sep 2013) I'd be interested to hear feedback about the effectiveness of this plugin. I use it on my [[http://resource.phplist.com|own Wiki]] but it is not really working very well, as I still get a lot of spam registrations. In my case, it's not a big problem, as I manually mark people editor to actually be able to edit the Wiki pages. It is probably advisable to use the [[plugin:captcha|Captcha plugin]] as well. I don't do that for research purposes.