Hide Banned Members

Started by Deaks, Nov 21, 2026, 06:30 PM

Previous topic - Next topic

0 Members and 0 Guests are viewing this topic.

Deaks

Hide Banned Members - v1.0.2
Keep Banned Accounts Out of Member Lists

By BoredSkull
SMF 2.1.x | ISC Licence



Overview

Hide Banned Members automatically removes banned accounts from your forum's member lists without deleting accounts or changing SMF's existing ban system.

The modification uses SMF's existing database records to identify banned members, ensuring they are hidden while their ban is active and can reappear when the ban is removed.

Administrators can now customise the modification through a dedicated settings page under Admin > Members > Members List > Hide Banned Members.

Uses SMF integration hooks. No core or theme edits required!



Features

  • Hide Banned Members - Automatically excludes banned accounts from enabled member lists.
  • Admin Member List - Hides banned accounts from the administration member directory.
  • Member Search Filtering - Excludes banned accounts from supported member searches.
  • Accurate Admin Pagination - Filters banned accounts before calculating member counts and pagination in the administration list.
  • Automatic Updates - Members can reappear when their ban is removed or their banned status is cleared.
  • Dedicated Settings - Administrators can control where and how the modification operates.
  • Optional Hidden Count - Display the number of hidden accounts in the administration member list.
  • No Account Deletion - Member accounts, posts and ban records remain intact.
  • BoredSkull Integration API - Provides integration functions for other modifications to identify and filter banned members.
  • Hooks Only - No manual modifications to SMF core files or themes.



Administration Settings

Settings can be found at:

Admin > Members > Members List > Hide Banned Members

Available options include:

  • Enable or disable Hide Banned Members.
  • Hide banned accounts from public member lists.
  • Hide banned accounts from administrator member lists.
  • Hide banned accounts from supported member searches.
  • Show or hide the administrator hidden-account count notice.

All options are enabled by default.



How It Works

The modification checks SMF's existing database for:

  • Accounts marked as banned through SMF's built-in member status.
  • Active, member-specific bans preventing login or forum access.

IP-only and email-only bans do not automatically cause an account to be hidden unless its account status also identifies it as banned.

Important: Hidden accounts are not deleted. Their existing posts and profiles remain available subject to normal SMF permissions. Public member-list pagination may still include hidden accounts in its counts, and third-party member lists require integration with the supplied API.



Installation

1. Go to Admin > Package Manager > Download Packages.
2. Upload the modification ZIP.
3. Select Install Now.
4. Clear SMF's cache after installation.

Updating from an earlier version:

Uninstall your existing Hide Banned Members package before installing v1.0.2.

Existing member accounts, bans and forum content are preserved.



Changelog

v1.0.2
  • Fixed an undefined function error when accessing the administration settings page.
  • Corrected loading of SMF's database settings helper functions.
  • Retained the dedicated settings page under Admin > Members.

v1.0.1
  • Fixed banned accounts appearing in Admin > Members List.
  • Added recognition of SMF's built-in banned account status.
  • Improved administrator member-search filtering.
  • Corrected administration member counts and pagination.
  • Added configurable administration settings.

v1.0.0
  • Initial release.
  • Public member-list filtering.
  • Account-specific ban detection.
  • BoredSkull integration API.



Compatibility & Notes

  • Designed for SMF 2.1.x.
  • No additional database tables required.
  • Uses SMF integration hooks without core or theme edits.
  • Does not delete existing member accounts or ban records.
  • SMF 3.0 compatibility is not yet confirmed.



Support & Downloads

Download the latest release using the attachment below.

For support, bug reports and suggestions, visit BoredSkull.net.

Feedback and suggestions are always welcome!

https://custom.simplemachines.org/index.php?mod=4538
  • 👍 1

    Members who reacted