Moderator management system
 

tested with 3.0.3

You went into a lot of trouble selecting the moderators for your forum, you created a set of rules, told them what you expected from them. Now, how do you know if they are really moderating?

Of course, if you have 3 forums and 3 moderators, it's not big deal. But if you have 5+ moderators then this tool might be useful.

I wanted to receive an alert when my moderators were absent, or when they were in the forum but weren't doing any moderation at all... also I want my moderators to be active posters. But checking on every one of them is time consuming. That's why I made this tool.

With it you receive an alert pm if:

• a moderator has been absent for more than x days
• a moderator has not modded (edited/deleted/moved/closed) for more than z days
• a moderator has not posted in HIS forum for more than y days
• a moderator has nos posted for more than y days
• a moderator has not created a new thread in HIS forums for more than y days
• a moderator has not created a thread globally for more than y days
• a moderator has failed to OPEN and potentially read at least x percent threads in HIS forum in the last week

Installation instructions:

1)
Upload the files in the .zip file to your forum. Make sure that you follow the directory structure in the zip file.
modmanagement.php goes in the root of your forum
functions_modmanagement.php goes to the includes/ directory
modmanagement_cron.php goes into the includes/cron/ directory
modmanagement_install.php goes into the admincp directory

2)
Open the modmanagement_install.php in your browser

3)
That's it :) No file modifications, no template modifications

Customization:
- Go to vbulletin options and change how many posts a moderator should do in how many days, how long can someone be inactive, etc.
- Go to the scheduled tasks and you can change the cron job. By default, it sends the alerts sunday morning.

Other options:
Open modmanagement.php in your browser to see a summary of the moderators activity.

Even more customization:
Note: You should really test that the hack is working and that you like it before doing anything else :)

*optional* For integration in the admincp and a link in every page, you need some file modifications, here: https://vborg.vbsupport.ru/showpost....5&postcount=27

*optional* The summary page can only be accesed by administrators. If you want to give access to supermoderators or moderators, here:
https://vborg.vbsupport.ru/showpost....9&postcount=64


Info for hackers:
You may modify, improve, upgrade, redistribute this hack, include it
in another hack or yours or translate it provided you do it free of
charge and you distribute it in www.vbulletin.org at least, there is no
need to pm me asking for permission
Some portions of the code are (c) Jelsoft Enterprises Ltd.

There is an extra option in the hack, but it needs additional modifications so I'm posting it apart.

THIS IS OPTIONAL AND ONLY IF YOU WANT THE EXTRA FUNCTIONALITY



You need my "who viewed thread" hack installed:
https://vborg.vbsupport.ru/showthread.php?t=61225 (yes, it works with 3.0.3)

after you install that other hack:

1)
open includes/functions_modmanagement.php

2)
change:
define('ENABLE_MODERATOR_READ', false);
to this:
define('ENABLE_MODERATOR_READ', true);


you will get an extra column that shows the % number of threads that your moderator has read. If it is a really good moderator then he reads 100% of the threads in his forum, right?

Check the last column in the following screenshot for an example of this extra option.

Excellent hack :D Hopefully I'll be able to scare my mods into being more active with this thing ;)

Could there also be an email to the moderator who has been unactive for x days or has not posted x amount of threads to remind them of their duties?

OUTSTANDING hack! Can't wait to install thi

Great Hack! You should have a link or something to the modmanagement.php file in the quick links bar somewhere that only admins and mods can see so we won't always have to remember that filename, other than that great hack!

~~now its time to show this to my mods so it can wake them up~~

I like the concept. I'm going to recommend it to a few people, and consider installing it on my own forum.

its good but every body can see this right ?!!
users guest everybody
if i put modmanagement.php under the admicp/ folder will this work

nice work!

No. Only the admin can see it. Other people get a nopermission screen.

The Master is back! ;)

Another quality hack, sir. ;)

[high]* Boofo clicks the install button[/high]

very very nice, i love this one

very nice indeed

This is a god send.

/me worships

Nice job

Thanks for the hack !

Kentaurus, dejame te comento que eres mi heroe xDDDD

Muchas gracias !!! este hack me va a servir de muchiiisimo ;)

very nice. However, sorting by lastvisit doesnt work very well.

agrrrrrrrrr

I have about 70 mods, and ...
Page generated in 3.61179 seconds with 12293 queries

Anyway to see supermods as well? Great hack!

Small note:

By default vBulletin shows in a color legend the activity of your moderators - check 'view all moderators' through the admin control panel.

wow, great this Hack is saving a lot off time :)

mmmm

i have this problem in modmanagement.php

Warning: array_key_exists(): The second argument should be either an array or an object in /home/digizona/public_html/foro/includes/functions_modmanagement.php on line 251

First of all, very nice hack!

Would it be possible to generate any kind of statistics for Super Moderators, too?

I have the same problem, and it annoys me. Is there something we can do about it?

Tnx, looks interesting.

Kentaurus truly its a very nice hack :), you can definetly add loads of features to same.. (i will myself recommend a few more things needed)

I appreciate your efforts for this hack http://forums.tech-arena.com/images/...s/notworth.gif


Warm Regards,
Sandy...

What can I say? I am really sorry. I was hoping there was a cache for moderator permissions... there is not. 12293 queries is not acceptable. In my defense 12293 queries in only 3.6 seconds? Those must be light-speed queries.

It is fixed now, please use the modified functions_modmanagement.php in the zip (reupload it in your includes/ directory), I wrote a custom fetch_permissions and it uses A LOT less queries. Please let me know if it helped, I know it will.

Also for the array_key_exists() warning (I have never had that on my forum btw) I added code to fix that, please also reupload that file, you'll need to redownload the zip.

Me clicked 'Install'.

Now, all I have to do is to find a way to integrate it into my AdminCP. This vB software can always keep you busy.

Thanks for a lovely hack.

Rgds

well this is one awsome mod, thx, ill make sure ill install this one.

If you really need to do that (I was aiming at a no file no template modification hack, I am tired of rehacking everything every month ;))

For a link in you admincp, it will be below "View permissions" in the "Forums & Moderators" box

In admincp/index.php
find:
add ABOVE:

For a link in your footer template, it will appear just next to your "admincp" link

in your 'footer' template
find:
REPLACE it with:

Before somebody asks.... If you don't like the alerts that the system sends you can always delete the cron job, it is called "Moderator Management alerts" and you can delete it at the:

Scheduled tasks -> Scheduled tasks manager -> find "Moderator Management alerts" and delete it.

You can also run the task to see an example of how you'd see the alerts. I find the alerts a main feature of the system but you can get a lot of alerts if you have many moderators and they are all inactive :)

Nice Mod! Thanks for sharing Kentaurus

/me clicks install

I get the pm alerts, but I get a blank page for the modmanagement.php and templates are there

Was the file modmanagement.php uploaded correctly? Check the length of the file against the one in the zip.

You shouldn't get a blank page at all, you should get the summary page if you are an admin or a no permission page if you login with any other group. Try editing the templates and re-saving it, in case the styles weren't updated correctly, but that is unlikely.

this is gonna help alot. i have 25+ mods

Great job

Thanks for sharing.

This sounds like one of the first hack since weeks useful :D
Should be a standard function for version 3.0.4 or 3.1.

Kentaurus this modd is too siick. You have taken lead as my fave programmer on here. Great work, please keep it up. :)

Question: Is there also an uninstaller?

Just remove the files, after that you can put the variable of

$debug = 1; in your includes/config.php

and remove the settings in your vBull settings that way.

that is if it adds a setting to the settings menu.

hope that helps.

i will ask as well, is there a way to track supermods and other administrators?

I suppose i could look at the code, but I wasn't going to download it till i was going to use it, and this is a feature i'd like. :)

But Great work on a hack that is most usefull.

Currently only moderators are tracked, administrators and supermoderators are not considered unless they moderate a forum. You can always create a dummy forum and add your supermoderadors and admin to them. Some stats like "how many posts have the administrator made in his forum" will be always in 0. I'm considering however adding this to the hack to avoid using clever tricks.

There is not an uninstaller, but I am already making one since it will be a useful tool for upgrades to this hack. (uninstall the last version, install the new...). If you really need to know what was modified download the attached file.

As I said, great hack. However, I would prefer if I call it "Moderator Statistics" instead of "Moderators Management". I've searched the files and the templates, and I can't find where that phrase comes from. I am talking about the phrase that appears in the welcome box, as shown in the attached picture.

Any ideas would be greatly appreciated.

Rgds
-----------
John

This is crazy. I just reuploaded (same size). I tried to change the template name to another one, yet still empty!!!

Ah! Forgot to say I am using 3.01