From a2c32fa15dab266a237c07028f1366f56853d5f8 Mon Sep 17 00:00:00 2001 From: William Jacoby Date: Thu, 3 Sep 2026 18:44:38 -0500 Subject: [PATCH] Update README to cover SFS reporting, MCP integration, and restrict-to-group The feature description hadn't been touched across the last several merged PRs (MCP Ban Hammer link, email-domain-ban, restrict-instead- of-ban) and only mentioned the original ban-from-profile flow. Also adds the PHP/phpBB version requirement and an Installation section, neither of which existed before. Co-Authored-By: Claude Sonnet 5 --- README.md | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 2381532..9b820f5 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,15 @@ # ban-hammer Ban Hammer for phpBB 3.3.x line (was One Click Ban) -Gives possibility to ban users directly from their profile. Along with banning you can automatically move the user to a certain group, delete their posts, delete their private messages, delete their avatar, signature, and profile information. +Gives moderators a one-click way to ban a user directly from their profile or from the MCP post-approval queue: ban the username, email, and/or IP, delete their posts, private messages, avatar, signature, and profile fields, optionally move them into a group, and optionally report them to Stop Forum Spam. As an alternative to banning outright, a moderator can instead restrict a user into a heavily-limited group for a set time (or permanently), with their original group automatically restored once the restriction expires. A "Ban email domain" action is also available from the MCP approve-details page. + +Requires PHP 7.4+ and phpBB 3.3.17+. + +## Installation + +1. Copy (or clone) this extension to `phpBB/ext/phpbbmodders/banhammer`. +2. In the ACP, go to Customise → Manage Extensions and enable Ban Hammer. +3. Configure it under ACP → Ban Hammer: what a ban deletes, an optional group to move banned users into, an optional group to restrict users into instead of banning, ban length options, and (optionally) a Stop Forum Spam API key. ## Automated testing