Major Additions - Banned Members Log

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.

[Mosh]

Originally Posted by macc

before this mod i had in my forum statistics

Threads: xxxx, Posts: xxxx, Members: xxxx

after your mod i get this

Threads: xxxxx, Posts: xxxx, Banned: xxxx Members: x


reg


macc

I am not quite sure why that happen, it looks as if you manually added stats to your homepage, as Banned should appear after Members, and not before it.

Is that the case?

[Mosh]

Originally Posted by KURTZ

italian translation

Thanks KURTZ Am adding a link to your post in the main hack.

[macc]

Originally Posted by Mosh

I am not quite sure why that happen, it looks as if you manually added stats to your homepage, as Banned should appear after Members, and not before it.

Is that the case?

no ...i do not add manually nothing ...that come up after i installed mod ... unistalled and come back normal ...

reg

macc

[Mosh]

Originally Posted by macc

no ...i do not add manually nothing ...that come up after i installed mod ... unistalled and come back normal ...

reg

macc

I can not recreate this problem, [s]so I am going to have to look at your installation.

If you want me to take a look then feel free to PM me your site address, a temp admin user (with admin permissions - Can Administer Settings for editing options, Can Administer Styles for editing templates, Can Administer Language Settings for editing phrases and finally Can Administer Plugins for editing products and plugins), and ftp access details, without these I can not help you. I will look when I have time, and even if I have a look, I can not guarantee that I will be able to fix it, if your site is not in English (I only read/write in English), so it is up to you what you want to do. You can revoke these after I have helped you out.[/s]

[Mosh]

Update: v3.7.002
-- 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

[NeitherSparky]

Thanks, looks good...it's very late now but I'll install this tomorrow.

[macc]

hello!

now is like this: Forum Statistics: 267, Banned: 8 Members, 166 Threads, 1,742 Posts

Here is phrase

PHP Code:

Forum Statistics: <b>{1}</b> Members, <b>{2}</b> Threads, <b>{3}</b> Posts<br /> 


in $vbphrase[wp_forum_stats]
in my " welcome templete rewrite " mod


reg

macc

[Mosh]

Originally Posted by macc

hello!

now is like this: Forum Statistics: 267, Banned: 8 Members, 166 Threads, 1,742 Posts

Here is phrase

PHP Code:

Forum Statistics: <b>{1}</b> Members, <b>{2}</b> Threads, <b>{3}</b> Posts<br /> 


in $vbphrase[wp_forum_stats]
in my " welcome templete rewrite " mod


reg

macc

This works with an un-altered forumhome template, you have altered yours, so may have to fiddle with it to get it working. If you can not, you can always disable the banned member count from your AdminCP options, and the rest will still work fine.

[KURTZ]

thx for the update Mosh

ps. the 'show banned members in forumhome' needs 1 query ...

[Mosh]

Originally Posted by KURTZ

thx for the update Mosh

ps. the 'show banned members in forumhome' needs 1 query ...

I know, I had noted that in the original thread since I released it yesterday