Moderators Functions - Moderator Checkpoint System

Moderator Checkpoint System

For boards with a large moderating staff, it can be difficult to know who has checked what post and which threads are completely checked. The goal of the Moderator Checkpoint System is to ensure that moderators don't read over the same post(s) twice, leaving them to spend this time checking other posts/threads.

The core functionality of the Moderator Checkpoint System (MCS) is the ability (for those with appropriate permission) to mark threads/posts as having been "Checked" - indicating that no further action is required and the thread(s)/post(s) has/have been given the OK by a Staff Member. When a post is marked as checked, the checking user's User ID, Username, and a timestamp is stored in the database. This information then appears on the checked post(s), and the post will change markup (depending on your customizations through the included options) indicating the post has been checked. This process is, of course, completely invisible to the community at-large, and only those Users with adequate permission will be allowed to Check/Uncheck and view Checked posts/threads.

Because some Moderators may like to browse forums normally, a feature has been integrated that will allow each user to Enable/Disable viewing the forum in "Moderation Mode" at their leisure. Disabling Moderation Mode will return the display of posts/threads to their normal state.

Features

• Forumdisplay
  • Threads can be (Admin Optional) colored according to whether they are completely checked -OR- contain unchecked posts.
  • A new column next to "Views" will display the number of Unchecked Posts in each thread.
  • Clicking the "Unchecked" column's header will allow the user to sort threads by the least/most number of unchecked posts, allowing them to see which threads need the most attention.
  • Threads can be (Admin Optional) marked as "Checked", thereby checking ALL the posts in a thread. This is useful for large, old threads which you know contain no problem posts.
• Showthread
  • Posts can be (Admin Optional) colored according to whether they have been checked -OR- remain to be checked.
  • Checked posts will display the Date/Time they were Checked and the Moderator Username/User ID who checked it. (Unchecked posts will have text indicating as much)
  • Posts can be marked as Checked/Unchecked via Inline Moderation.
  • "Active Checking" is utilized.
    • Active Checking is a feature which each User can Enable/Disable at their leisure. When Active Checking is Enabled, each time the User visits a thread, the posts displayed on that page will be marked as "Checked". The idea is that when in Active Checking mode, the User is actively reviewing the posts that they are reading, thus each can be marked as Checked.
  • Newly Checked Posts can be (Admin Optional) colored to indicate their recent activity. This coloring is visible only to the Checking User and is intended to serve as a guide for them to see which posts they, in their current session, have checked.
• Update Counters
  • If you ever feel your counters (Unchecked Count per Thread) are off, there is an Update Counters feature included in the modification. To access this feature, go to your AdminCP -> Maintenance (Very bottom) -> Update Counters -> Update Checkcount Counters (Very bottom).
    

Installation

1. Import the Product XML file.
   1. (a) IMPORTANT: THIS PRODUCT ADDS COLUMNS TO YOUR DATABASE'S POST TABLE. IF YOU HAVE A LARGE NUMBER OF POSTS, THE IMPORT PROCESS WILL TAKE SOME TIME (AND MAY APPEAR TO HANG); IT IS *IMPORTANT* THAT YOU DO NOT EXIT YOUR BROWSER DURING THE INSTALLATION PROCESS
2. Follow the instructions included in the ZIP archive to edit your templates.
3. Configuration Options are accessible through AdminCP -> vBulletin Options -> Moderator Checkpoint Configuration. Permissions are accessible through the Moderator Permissions panel (AdminCP -> Forums & Moderators -> Show All Moderators -> Edit Permissions.

Upgrade

• Upgrading from 1.0.9 to 1.1.1: https://vborg.vbsupport.ru/showpost....9&postcount=44
• Upgrading from 1.1.1 to 1.1.5: https://vborg.vbsupport.ru/showpost....5&postcount=76
• Upgrading from 1.1.5 to 1.1.6: https://vborg.vbsupport.ru/showpost....6&postcount=88
  

If you like this modification, feel free to Nominate it for Modification of the Month. Please click Install if you're actively using it, so you can receive updates about new releases.

This modification was written by request for Spinball, whose MCS Concept was utilized throughout development.
------------------------------------------------------------

Version History:
1.1.7 - Fixes Checkcount Display Bug in Forumdisplay
1.1.6 - Fixes Announcement Bug in Forumdisplay
1.1.5 - Prevents Checks/Unchecks from being written to the Moderator Log
1.1.4 - Added option for Default Moderation Mode
1.1.3 - Bug fixes
1.1.2 - Bug fixes
1.1.1 - Bug fix for soft-deleted post redirection issue
1.1.0 - Core code consolidated - numerous bug fixes
1.0.9 - Minor SQL Query fix
1.0.8 - Bug fix to correct issue with Forumdisplay sorting of Unchecked Threads
1.0.7 - Bug fix to correct counters not carrying over when merging threads
1.0.6 - Initial Release to Community

[civil78]

That’s great news, I thought that this mod discontinued.

[karamayros]

I am using this for quite a time now and I noticed few things:

1) In a forum running on a machine with php v5.1.6 installed quite often when one moderator attempts to enable moderation mode the result is a empty page and the error reported in error.log "'PHP Fatal Error : Allowed memory size of (64M) exhausted". Any ideas ?

2) Everytime a moderator logs out and relogs in the moderation mode has been set to disabled. Is there a way to leave the moderation mode permanently enabled ?

[logicuk]

has anyone got this working on vb 3.7 yet? thanks

[Kirk Y]

Version 1.1.1 has been released (version 1.1.0 was a private beta).

Much of the core code has either been rewritten or consolidated to improve performance and efficiency. Several template edits are now no longer necessary as of the release of vBulletin 3.7.0. With that said...

Moderator Checkpoint System v1.1.1 requires vBulletin 3.7.0 (or higher). Boards wishing to upgrade to the latest release must first upgrade to the latest release of vBulletin.
--------------------
Upgrading from 1.0.9 to 1.1.1

Find and remove in your threadadmin_deleteposts template:

<input type="hidden" name="checkedposts" value="$mcscount" />

Find and remove in your SHOWTHREAD template:

<if condition="$show['cancheck'] AND $inmodmode"><option value="markmoderated">$vbphrase[mark_checked]</option>
<option value="markunmoderated">$vbphrase[mark_unchecked]</option></if>

Find and remove in your FORUMDISPLAY template:

<if condition="$show['candothreads'] AND $inmodmode">
<option value="markthread">$vbphrase[mark_thread_moderated]</option>
<option value="unmarkthread">$vbphrase[unmark_thread_moderated]</option>
</if>

Find and remove in your HEADINCLUDE template:

<script type='text/javascript'>
<!--

    function mcsRequestData(Location,Handler){
    IE = (window.ActiveXObject)? true : false

        if(IE){
        Request = new ActiveXObject("Microsoft.XMLHTTP")
        } else {
        Request = new XMLHttpRequest()
        }

        if(Request){
        Request.onreadystatechange = function(){mcsCollectData(Handler)}
        Request.open("GET", Location + '&nocache=' + Math.random(0,9999), true)
        Request.send('')
        }
    }

    function mcsCollectData(Handler){
        if(Request.readyState == 4){
            if(Request.status == 200){
            eval(Handler + '(Request)')
            }
        }
    }

    function parseActiveData(Request){
    Data = Request.responseXML.documentElement
    ActiveStatus = Data.getElementsByTagName('activemode')[0].firstChild.data
        if(ActiveStatus == 0){
            document.getElementById('data3').innerHTML = '$vbphrase[mcs_disabled]'
        }else{
            document.getElementById('data3').innerHTML = '$vbphrase[mcs_enabled]'
        }
    }

-->
</script>

Find in your postbit/postbit_legacy template:

<if condition="$inmodmode AND THIS_SCRIPT == 'showthread' AND $show['cancheckforum']">

Replace with:

<if condition="$show['canbechecked']">

1. Import the 1.1.1 product XML, ensuring to check "Allow Overwrite".
2. Run a counter update via AdminCP -> Maintenance -> Update Counters
-- You must update the MCS Post Counters *and then* update the MCS Thread Counters.

[Spinball]

Couldn't install it Kirk because I just upgraded to 3.7.2 and the install scripts says that dependencies are not met.

[Kirk Y]

Apologies for that Stuart. This is the first time I've ever had the need to integrate dependencies in a product.

PS. AVForums should already be running 1.1.1.

[CrankyFC]

Originally Posted by Kirk Y

Apologies for that Stuart. This is the first time I've ever had the need to integrate dependencies in a product.

PS. AVForums should already be running 1.1.1.

Please fix this, I would like this. Please and thanks.

[Kirk Y]

Originally Posted by CrankyFC

Please fix this, I would like this. Please and thanks.

As of my previous posting, the problem had already been identified and fixed...

[EagleNick]

Very cool MOD, good idea.

However, it would get very annoying very fast to have to check each post, and then scroll to the bottom and use the moderation menu everytime.
A simple button in a post using AJAX like the Post Thanks hack would be a good idea, and more effective

[Kirk Y]

That's why "Active Checking" was implemented. But AJAX is something I may implement at some point in the future.