It's better when it's simple

User Tools

Site Tools


Bad Behaviour Plugin

Compatible with DokuWiki

2009-12-25, anteater, Weatherwax

plugin Test various headers and other HTTP related behavior for bad spiders and spammers

Last updated on
Admin, Action
Conflicts with

Tagged with blacklist, spam

Bad Behavior is a set of PHP scripts which prevents spambots from accessing your site by analyzing their actual HTTP requests and comparing them to profiles from known spambots. It goes far beyond User-Agent and Referrer, however.

This plugin integrates the Bad Behavior toolkit into DokuWiki.

Download and Install

Please use the download link given above to install the plugin manually or via the plugin manager.

:!: This plugin uses the legacy version of the badbehavior library which is not updated anymore. Until this plugin gets updated, it is not recommened to use.



You should set an email address in the Config Manager, for letting people contact you if they are blocked unintentionally. Or add it manually to your local.conf:

$conf['plugin']['badbehaviour']['email'] = '';

Bad Behaviour checks certain blacklists, normally used in email anti spam mechanisms for blacklisted IPs. This can cause innocent users to be blocked because their dynamic IP address was used by some spam bot before. If you don't want to use this check you can skip it:

$conf['plugin']['badbehaviour']['skipblackhole'] = 1;


All blocked accesses are logged to data/cache/badbehaviour.log. Each line contains the following tab separated keys:

  • Timestamp
  • IP address
  • Request method
  • Request URI
  • Server protocol
  • User Agent
  • Blocking reason key. You can lookup this key in the lib/plugins/badbehaviour/bad-behavior/ file
plugin/badbehaviour.txt · Last modified: 2016-07-06 20:42 by andi