Ban Hammer

Ban a user straight from their profile, with options to clean up their content and report them to Stop Forum Spam.

Features

• Ban Hammer form on member profiles, and on the MCP post-approval queue, for moderators with the right permissions.
• Ban by username, and optionally by email and IP.
• Optionally delete the user's avatar, posts and topics, private messages, signature and profile fields.
• Optionally move banned users into a chosen group.
• Instead of banning, restrict a user to a limited group for a set time (or permanently); their original group comes back automatically when it ends.
• A Ban email domain action on the MCP approve-details page.
• Optionally report the user to Stop Forum Spam (API key set in the ACP).
• An optional Ban list page and header link listing users banned by username, with ban dates, the reason shown to the user, and their warnings. Off by default; turn it on in the ACP and give groups the Can view the ban list permission (the standard and full user roles have it).

Requirements

• phpBB 3.3.19 or later, including phpBB 4.0 (tested on its 4.0.0-a3 development version)
• PHP 7.4 or later (phpBB 4.0 itself needs PHP 8.2 or later)

Installation

1. Copy the extension to /ext/phpbbmodders/banhammer
2. In the Administration Control Panel, go to Customise → Manage extensions
3. Enable the Ban Hammer extension
4. Choose the defaults under ACP → Extensions → Ban Hammer

TODO

Project TODOs and archived reviews: docs/TODO.md.

Contributing

Contributions are welcome!

• Bug reports: Open an issue.
• Everything else (questions, feature requests, ideas, general discussion): Use Discussions, or the community forum.
• Pull requests are welcome for bug fixes or discussed features.

Acknowledgments

• Based on the phpBB 3.0 One Click Ban MOD by phpbbmodders.net (co-authors Kailey and bonelifer; contributors EXreaction, RMcGirr83, Sniper_E and tumba25).
• Converted to a phpBB extension by Rich McGirr (RMcGirr83) and Jari Kanerva (tumba25).
• The avatar-deletion modernization (PR #21) is based on a fix by Rich McGirr in his fork, routing avatar deletion through phpBB's avatar.manager service instead of the legacy avatar_delete() function.
• Code review, bug fixes, and documentation assisted by Claude.

License

This extension is licensed under the GNU General Public License v2.0.

See license.txt for more information.