About Blackhole

Trap bad bots, crawlers and spiders in a virtual black hole.

Category 1Logs/Monitoring
Modules that maintain activity logs or monitor and report activity in some form or another.
Category 2Other Modules
Modules that have a unique purpose not covered by existing categories.
Category 3Users and Access
Modules dealing with access in ProcessWire via Users, Roles or Permissions.
Release StateStable
Should be safe for use in production environments. *
Module Version1.0.2
Class NameBlackhole
Date AddedMarch 20, 2018
Recommended ByNew recommendations may take up to 1 day to appear.


This module's files should be placed in /site/modules/Blackhole/
How to install or uninstall modules



Originaly developped by Jeff Starr, Blackhole is a security plugin which trap bad bots, crawlers and spiders in a virtual black hole.

Once the bots (or any virtual user!) visit the black hole page, they are blocked and denied access for your entire site.

This helps to keep nonsense spammers, scrapers, scanners, and other malicious hacking tools away from your site, so you can save precious server resources and bandwith for your good visitors.

How It Works

You add a rule to your robots.txt that instructs bots to stay away. Good bots will obey the rule, but bad bots will ignore it and follow the link... right into the black hole trap. Once trapped, bad bots are blocked and denied access to your entire site.

The main benefits of Blackhole include:

Stops leeches, scanners, and spammers
Saves server resources for humans and good bots
Improves traffic quality and overall site security

Bots have one chance to obey your site’s robots.txt rules. Failure to comply results in immediate banishment.


Disable Blackhole for logged in users
Optionally redirect all logged-in users
Send alert email message
Customize email message
Choose a custom warning message for bad bots
Show a WHOIS Lookup informations
Choose a custom blocked message for bad bots
Choose a custom HTTP Status Code for blocked bots
Choose which bots are whitelisted or not


  1. Install the module
  2. Create a new page and assign to this page the template "blackhole"
  3. Create a new template file "blackhole.php" and call the module $modules->get('Blackhole')->blackhole();
  4. Add the rule to your robot.txt
  5. Call the module from your home.php template $modules->get('Blackhole')->blackhole();

Bye bye bad bots!


Enjoy :neckbeard: