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 NeitherSparky

No, when this hack is disabled, those problems do not occur.

I guess I'll just use your old hack, that works fine. Thanks though.

So, are you are saying that with all hacks disabled apart from this one, and with an un-altered default style being the current style, and with just the Banned Members Log (3) plugin disabled that the problem goes away?

If the answer is:

1. Yes - Then it sounds like one of the variables used in that plugin is messing with one of the default vBulletin ones, which I can probably fix.
2. No - Then I am at a loss as to what the issue is, and as I can not replicate the issue, and nobody else has said this is an issue, I would have to look at your installation to find how the problem is occurring and then to fix it, as the problem would seem to be unique to your installation.

Once you have confirmed this either way, and have clicked Mark as Installed again, I can look into it further, otherwise there is nothing I can do, or suggest.

[NeitherSparky]

Originally Posted by Mosh

Disable Banned Members Log (3) plugin, again with all other hacks disabled and on the default style, is it still happening?

Sigh...I had a scary day and my brain was fried. I misunderstood this before, sorry. I have disabled the Banned Members Log (3) plugin, and YES the issues have gone away. Shall I continue to run the hack with this plugin disabled? Would that be fine?

[Mosh]

Originally Posted by NeitherSparky

Sigh...I had a scary day and my brain was fried. I misunderstood this before, sorry. I have disabled the Banned Members Log (3) plugin, and YES the issues have gone away. Shall I continue to run the hack with this plugin disabled? Would that be fine?

Yes, running the hack with Banned Members Log (3) plugin disabled will be fine (or you should be able to just set Automatic Link Creation to No in the AdminCP Options), as it is only automatically adds a link to the page on the navbar or quicklinks, and you can add a link manually with no problems.

[NeitherSparky]

Okay. (And I did have the automatic link creation thing set to no before, but with the (3) plugin enabled it was doing those two weird things anyways). Thanks.

[digicom]

Thanks Installed :up:

[Mosh]

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

This should hopefully fix NeitherSparky's issue. Also it removes the extra forumhome page query, previous versions added 1 query per page load, now there are none (as the count is now a datastore item).

NOTE: There is no need to update the hack if you don't need to or want to. I just wanted to see if I could use the datastore to save a query.

[Hasann]

vauww you are crazy coder mosh hahaha good work

[NeitherSparky]

Thanks Mosh. I still had the same issues though so I disabled the (3) plugin again.

[Mosh]

Originally Posted by NeitherSparky

Thanks Mosh. I still had the same issues though so I disabled the (3) plugin again.

I honestly do not know why you are having the problems you are having, as quite a few of my hacks and a lot of other hack authors use exactly the same method to add links to the navbar, and this is the first time I have heard of, or come across this problem.

This is not a bug, and the reason I am saying that, is that I would have received a lot feedback from other people indicating that they are also having the same problem (not with just this hack, but from my other half a dozen hacks that add to the navbar as well. Other hack authors would also have had a lot of the same feedback too), and bugs can usually be replicated.

This problem would seem to be unique to your installation, and that is what has me really puzzled, so, if I ever manage to replicate this issue, I will endeavor to resolve it asap, but until then I would suggest you do what you are currently doing, i.e. disabling the Banned Members Log (3) plugin and manually adding a link to the navbar where you want it.

Sorry I can not give you better news about your problem

[NeitherSparky]

That's okay Mosh.

I do have something new to report though that happened when I installed the latest version - it reset my Most Members Ever Online number back to 0. I saw a way to reset it to a specific number (which one of my moderators remembered), so I'm not fussed, I just wanted to report it. Again, I bet it's just my board, lol...