vBulletin LTS

Banned Members Log
Mod Version: 3.7.007, by Mosh

Hack Support

This hack is now discontinued - this means that while it will remain available for download and use, there will be no further updates, nor will support be provided as the thread is no longer monitored. You can now check out the 3.8.x version of this hack, as it also works with v3.7.3 PL1, v3.6.11 PL1 (and maybe even earlier versions).

Please click Mark as Installed if you are using this hack.

Branding

There is a small unobtrusive block of copyright branding text at the bottom of each page generated by this hack, which is there to promote my work and allow you to use this hack for free.

You are NOT allowed to remove my copyright branding from this hack.

vBulletin Version Compatibility

This hack can be used with v3.6.10 and v3.7.x. This has not been tested with earlier versions of v3.6.x, but should work.

What Does This Hack Do?

This hack displays a log of all temporary and permanently banned members on it's own page, it is paginated (with page count on the permanent bans section) if there are more results than you selected per page in the AdminCP, temporary bans are only displayed on page 1 (if you have more temporary banned members than one page, you must be doing something wrong), along with a count on how many temporary and permanent banned members there are. Any users displayed on the page(s) will have links to display their profile, if clicked on.

It can also show an altered total member count on your forum's homepage (if enabled) to either show the altered members count (exclude all banned members), show the altered members and unconfirmed (Users Awaiting Email Confirmation) members count, show the altered members, unconfirmed members and banned members count, or you can disabled it altogether (so it shows the unaltered members count). Enabled or disabled, it does not generate any extra queries.

You can optionally add a link on either the navbar proper or quick links.

This hack is controlled by usergroup permissions.

As an added bonus (if enabled), if a usergroup has permissions to view the banned members log, then the banned members count on the forumhome page will be clickable and will load the banned members log if clicked on (if no permission, then it will not be clickable).

This hack was created because I liked the idea of this hack by jredrum, and as it is not supported, not phrased at all, has no pagination, and has no usergroup permissions to speak of, I decided to use the idea of that hack and rewrite it from scratch based on the ModCP file banning.php, I have also integrated my Total Member Count Excluding Banned Members hack into this one and have now retired it.

There is only one file change (to config.php), but no template changes at all and is fully phrased. This generates no extra queries on the forum homepage at all, and generates 7-9 queries (depending on options selected and if logged out/logged in) on the ban_log.php page.

Installation Instructions

The InstallInstructions.txt instructions file is included in attached .zip file.

Uninstall Instructions

1. Delete ban_log.php from your forum's root directory.
2. Delete ban_log_cron.php from your forum's /includes/cron directory.
3. Delete hooks_ban_log.xml from your forum's /includes/xml directory.
4. Edit config.php in your forum's /includes directory.
   Find and delete:
   
   PHP Code:

       // add Mosh's datastore to specialtemplates, so it is loaded on with the main datastore
    $GLOBALS['specialtemplates'][] = 'ms_datastore'; 

5. Uninstall the product in vB using the AdminCP Product Manager.

Translations

I would like to thank the following people for their translations:

• Full Italian translation (including AdminCP options) (v3.7.003) by KURTZ

NOTE: If you would like to make a translation into your language and have it posted here, then send me a PM for a list of phrases that you will need to translate.

Version History

v3.7.007 - Friday 29th August 2008
-- Final Release
-- Fixed: Usergroup permission checkboxes not working with vBulletin v 3.6.x

v3.7.006 - Wednesday 27th August 2008
-- Changed: Banned Members Log (2) plugin, to get banned members count from the new datastore instead
-- Changed: ban_log.php
-- Changed: ban_log_cron.php, added new query to cron job
-- Changed: Usergroup permissions, now checkboxes instead of comma seperated numbers
-- Added: Extra phrase
-- Added: File edit in config.php, to allow new datastore to be loaded with the main datastore
-- Added: Banned Members Log (6) plugin, for processing usergroup permissions
-- Added: Users Awaiting Email Confirmation member count

v3.7.005 - Sunday 24th August 2008
-- Changed: Banned Member Count on forumhome page, now a datastore item
-- Changed: variable name changed in Banned Members Log (3) plugin, in case of naming conflict
-- Changed:ban_log.php
-- Added: ban_log_cron.php
-- Added: Scheduled cron job

v3.7.004 - Thursday 21st August 2008
-- Changed: banned_count template
-- Changed: banned_log template
-- Changed: Banned Members Log (2) plugin
-- Changed: ban_log.php
-- Changed: AdminCP Options that displays banned members count on forumhome page
-- Updated: Screenshots
-- Added: Pagination
-- Added: Page count on banned members section (if more than 1 page of results)
-- Added: AdminCP Option for amount of results per page

v3.7.003 - Wednesday 20th August 2008
-- Changed: banned_none template again
-- Changed: banned_log template
-- Changed: ban_log.php
-- Changed: Query that calculates members and banned members on forumhome page
-- Changed: Different messages now, when there are no temporary and/or banned members
-- Updated: Screenshots
-- Added: Counts for temporary and permanent banned members on the Banned Members Log page
-- Added: Extra AdminCP Options on display order of permanent banned members on Banned Member Log page
-- Added: Couple of extra phrases

v3.7.002 - Tuesday 19th August 2008
-- Changed: banned_none template
-- Changed: SQL queries in ban_log.php
-- Updated: Screenshots
-- Added: Message if no banned usergroups have been defined
-- Added: AdminCP Option to display or not display the split member count on forum home page
-- Added: AdminCP Options on display order of banned members on Banned Member Log page

v3.7.001 - Monday 18th August 2008
-- Initial Release

Show Your Appreciation

Although not required, if you have enjoyed the benefits of this hack, and would like show your appreciation for my efforts, then please feel free to click on the Support Developer link and donate any amount you feel is appropriate.