vBulletin Mods

The Official vBulletin Modifications Site

vBMQN - Moderation Queue Notifications + Desktop App
by Lee Roberts
11 Feb 2013 13:37

7 Attachment(s)

There are many scenarios where this mod would come in handy for administrators. There are too many for me to cover them all, so I will give you the scenario this mod was developed for...

If you have a hand full of moderating staff and a large number of forums, adding each moderator to each forum can be quite a pain, however doing it that way would give you notifications for those moderators when something dose need their attention from within those said forums...

Another option would be to setup staff to be Global Moderators, this removes the need to add them to specific forums but it also removes queue notifications because moderators wouldnít be assigned to individual forums...

We require new members to be moderated and/or that their first submissions to the forum require moderating, this can become quite a pain because again staff would need to continually check the moderation queue for new items...

The Solution and Requirements
What we need is moderation queue notifications via email and possibly a desktop app for those staff that would rather not use their email/inbox.

- Email Notifications for multiple users/addresses
- Notifications for every item type (posts, threads, attachments etc.)
- Email sending using the vB mail method/system (plain text emails)
- Email generation should use the vB Phrase system (multi-language support)
- Automated checking of the moderation queue (vB Cron system)
- Should support the Scheduled Task log system (debugging, report actions taken)
- Support for external applications and their development (xml based status)

All of the above are present in the first release of this mod (v1), please see the screen shots.

This mod is setup as a vB Cron task; I could not see/find a better way to make this an automated system working with anything else from within the vB system. By default the Cron task is setup to run every 30 minutes, if you would like to adjust this, simply go in and adjust the Cron job as you wish.

Desktop App
At the moment I am still developing a windows (.net) desktop app to work with this, right now we donít have a big need for this so itís not a priority for me to develop this and get it out to you any time soon, when the moderation queue is checked regardless of its current state the included xml file is updated to reflect this. So all your own app would need to do is read in this xml file and take the action you require.

If there is a massive interest in the desktop app for this I could be persuaded to push it to the top of my job list, for now though it is work in progress and with no planned deadline or release date.

We have been using this mod in a production environment for almost 12 months now with no problems at all, it is really quite a simple mod and Iím surprised it hasnít been done already, given the number of requests I have seen.

I will support this as best I can, I am a busy guy so you will need to understand this if you do run into any problems and request support.

Installing this mod is much like any other, upload the files in the download to the same locations on your server, import the product xml file, go to the Admin > Settings > Options > vBMQN: General Options page and configure as you wish. If you are upgrading from an older version simply follow the same steps as installing for the first time.

Change Log
v1.0 - 11 Feb 2013
- First version

v2.0 - 12 Feb 2013
- Added support for table prefix's ( config.php > $config['Database']['tableprefix'] = ''; )
- Rewrite of the database query code, now uses the vB Database Class ( $vbulletin->db->query_first )
- Changed from the use of the php "number_format" function to the vB function "vb_number_format"
- Added instant email notification rather than sending emails to the vB mail queue ( $notsubscription = true )

This has helped us allot and I hope those of you who have requested this before find it to be ďjust the jobĒ as well.

Lee Roberts

Lee Roberts 11 Feb 2013 14:04

** Reserved **

Dont forget to mark as Installed, Nominate and Rate/Vote for it !


Bluemax712 11 Feb 2013 19:36

Installed on a vB4.20 test forum with only this mod installed
but no luck so far getting it to send email notifications

The Scheduled Task Log viewer shows vBMQN "Queue Checked"evertime it is run
but never shows a "Notification Sent" even though there are messages waiting in the mod queue.
The Sendmail log shows no activity or errors.

Have also tried manually running the Process E-Mail Queue and then vBMQN scheduled tasks with same results.

Lee Roberts 11 Feb 2013 20:25


Humm that is a strange one, i've used the "$notsubscription = true" in my code and this means "do not use the mail queue and send immediately" so i dont think its that.

How is the test forum setup to send mail? my test forum is setup to use SMTP for sending mail, however your cron log is telling you "Queue Checked" not "Notification Sent"...

What settings have you used for the Admin > Settings > Options > vBMQN: General Options page?


Bluemax712 11 Feb 2013 20:38

for vBMQN General Options:
- Moderator Control Panel (tried leaving blank and using modcp)
- Email Notification: Yes
- Notification Recipients: [email protected]
(this email works when sending a test message via VBulletin CP)
-Desktop Notification: Yes (but also tried No)

I've tried setting to SMTP too
and enabling/disabling the Email Queue system
and trying with and without the -f parameter

test messages from the CP -send test email to all users - work fine.

Lee Roberts 11 Feb 2013 20:47

Have you got another email address you can test with, i am wondering if there is an issue with the "dots" in that address?

Will see if i can replicate this now...

I just used that email address on my test forum and i got "Notification Sent".

The email was also recived by my mail server.

What items do you have in your mod que at the momment?


Bluemax712 11 Feb 2013 21:31

I've just been creating new "threads" everytime for testing -
it shows the awaiting messages count increase in the the admin control front status page under Threads to Moderate

I've then been running the vBMQN cron script manually

Don't have any other emails to try yet
only [email protected] type of emails addreses work for now with my setup
- vBulletin gives me "invalid email address" if I try to set a user's address to : [email protected]
though it does work if I mail from the command line

Installed on another server 4.1.12 (production) which has a few other plugins installed
inc Glowhost Spam-O-Matic + FractalizeR and a few others.

I get this error when running the vBMQN cron script manually

================================================================================ ===================================================


Warning: mysql_fetch_array(): supplied argument is not a valid MySQL result resource in [path]/includes/cron/vbmqn.php on line 23

Warning: mysql_fetch_array(): supplied argument is not a valid MySQL result resource in [path]/includes/cron/vbmqn.php on line 26

Warning: mysql_fetch_array(): supplied argument is not a valid MySQL result resource in [path]/includes/cron/vbmqn.php on line 29

Warning: mysql_fetch_array(): supplied argument is not a valid MySQL result resource in [path]/includes/cron/vbmqn.php on line 32

Warning: mysql_fetch_array(): supplied argument is not a valid MySQL result resource in [path]/includes/cron/vbmqn.php on line 35

Warning: mysql_fetch_array(): supplied argument is not a valid MySQL result resource in [path]/includes/cron/vbmqn.php on line 38
Queue Checked
================================================================================ ===================================================

Edit 3: Also tried installing it on a test vB 3.8.7 with FractilezeR installed - got no errors when running the vBMQN script
but same results as the test vB4 server receive no emails
- Scheduled Task log only shows "vBMQN Queue Checked" (never says Emails Sent)

Edit4 : noticed if I purposely set the "modcp" setting to the wrong name - nothing changes - no errors shown
everything functions same

Jeromedia603 11 Feb 2013 23:38

This could be a great mod! Spot Reserved for when I have time to take a better look!

Bluemax712 12 Feb 2013 00:24


Originally Posted by Jeromedia603 (Post 2403625)
This could be a great mod! Spot Reserved for when I have time to take a better look!

I know- can only pray will be able to get this to work
thanks much Lee :)

Bluemax712 12 Feb 2013 03:37

Not sure if I'm the only one having trouble and only know basics of programming but ...
Since it's only version 1.0 - it would be cool if could add a debug function to print out all the variables on a separate page while it's running :)

Lee Roberts 12 Feb 2013 10:44

Hi guys,

I dont think any other mods would/will give this mod any problems its far to simple for that and the info it needs from the database is unlikely to change unless vB make an update or change and i really cant see that happening.

The "Moderator Control Panel" setting dose nothing more then setup the link in the email that you recive, you should have this set to "modcp" unless your moderator control panel is in a folder with another name.

Your welcome, hopefully I can make this happen for you.


Bluemax712 12 Feb 2013 12:51

Thanks for the quick response Lee! Sent you a PM with the output

Lee Roberts 12 Feb 2013 20:29


Today it was clear I needed to do some more work on this mod as it was failing for people, today I have released version 2 and would like you to download and install this version.

Please see the "Change Log" section of the main description for the things that have been done. Version 2 also fix's the problems apsrfvb4 has been having, so generally version 2 is better, sorry for any inconvenience!


Bluemax712 12 Feb 2013 22:39

Everything works perfect now Lee
Thanks so much for this awesome mod.

Installed on a 4.1.12 PL2 and a 4.2.0 PL3 server

cdoyle 15 Feb 2013 15:21

Just installed, waiting for some moderated posts now :)

One thing for the next version that would be nice is to have an option so it just sends to all moderators.

All times are GMT. The time now is 21:12.

Powered by vBulletin® Version 3.8.14
Copyright © 2021, MH Sub I, LLC dba vBulletin. All Rights Reserved. vBulletin® is a registered trademark of MH Sub I, LLC
Copyright ©2001 - , vbulletin.org. All rights reserved.