Show Thread Enhancements - Who has read a Thread

As of 24 Nov 2017 this modification has been withdrawn.

This displays who has read a thread, and the time they last looked at it.

Hovering over a name will show when the member last viewed the thread, you can view the ip address the member used in the 'View-All' display.

There is also an option to allow a thread author to view who has read their thread when they are not in one of the allowed usergroups. The IP and number of days restrictions still apply.

The 3.8.001 release adds the option to restrict the display to certain forums only.

The set/reset facility allows members to click on the 'set' link which then sets a personal 'cutoff' time - only showing who has read the thread after that time. The time can be reset as many times wanted, and also completely cleared again. When using this facility there is also a link to allow you to view a seperate list of all readers of the thread.

Warning: When using the set/reset option - there is only a limited capacity of entries per thread (several thousand) - therefore you should only allow this feature to be used by a limited number of people - typically Staff usergroups. Allowing all members to use it will probably slow down your forum and cause errors if more than about 3000 members set a date on one thread.

A cron job (optionally) allows the deletion of records from the whoread table that are over a certain age - this is provided for large forums where the number of table entries can start to reach a million or more after 12 months. The delete age is a setting in the ACP.

There are also settings for the following (in vBulletin Options > Who Has Read a Thread) ;

1. Turn the system on/off.
2. Restrict the display to certain usergroups
3. Restrict the IP display to certain usergroups.
4. Restrict the display to a set number of days.
5. Option to allow thread author to view who read information.
6. Option to turn on the who read cutoff date (reset) function
7. Restrict use of reset function to certain usergroups.
8. Option to set whoread data records to be cleaned out after xxx days.
9. Clicking on a user will display a page of their thread viewing history, most recent first.
10. Restrict the display to certain forums only.

Note: When using option 4 or the set/reset facility, the data is still kept beyond this limit, so they can be changed at any time.

Download the zip, extract the XML file and import using the vb Product Manager.

Note: The experimental TMS support has been removed from the 3.8 Version - as of 3.8 Gold a template hook is available.

Template Hook

Please note that this modification uses the following template hook in the SHOWTHREAD template ;

showthread_after_activeusers

This must be present in any customised template/style you are using, otherwise this modification will not display.


History:

v3.8.001 : First Release for vb 3.8.
v3.8.002 : Changed to use template hook in 3.8.0 Gold.
v3.8.003 : Fix permission bugs when using the forum restrictions option.

[Paul M]

None of my mods will install on Alpha/Beta/RC versions. No one should be running them.

[ericgtr]

Originally Posted by Paul M

None of my mods will install on Alpha/Beta/RC versions. No one should be running them.

Okay, it does work on 3.8 RC2 though. I know that isn't your point but it does.

[Paul M]

Yes, I expect most of them will, but as you say, thats not the point. No one should be running a live site on a beta/RC version, I wont support them, so I (quite deliberately) restrict them from installing on such.

[meissenation]

I'm trying to figure out where the plugin code is where it looks for this showthread_after_activeusers - what plugin is that stored in? My template does not have that hook and as such does not display. I have to edit one or the other, the template or the associated plugin for this mod.

[meissenation]

Originally Posted by Whity

find in showthread template

PHP Code:

<!-- end currently active users --> 


after add

PHP Code:

$template_hook[showthread_after_activeusers] 


It is correct?

Thank you for posting that! It's amazing how the developers assume everyone knows what a hook is or how to add a hook to a template. Been using vB since 2005 and never experienced having to manually add a hook to a template before.

[Paul M]

Originally Posted by meissenation

Thank you for posting that! It's amazing how the developers assume everyone knows what a hook is or how to add a hook to a template. Been using vB since 2005 and never experienced having to manually add a hook to a template before.

Its already in the default vb template, you must be using an old customised version.

[cbiweb]

Okay, here's an issue that no one else seems to have had, or reported. I could not get this add-on to work, no matter what I tried. Everything looked correct, hooks in place, settings correct, etc. And here's how I fixed it...

In the SHOWTHREAD template, change the code seen here (vBulletin default!) in bold red text:

<if condition="$show['activeusers']">
<!-- currently active users -->
    <br />
    <table class="tborder" cellpadding="$stylevar[cellpadding]" cellspacing="$stylevar[cellspacing]" border="0" width="100%" align="center">
    <tr>
        <td class="tcat" colspan="2">
            <phrase 1="$totalonline" 2="$numberregistered" 3="$numberguest">$vbphrase[users_viewing_this_thread_x_y_z]</phrase>
        </td>
    </tr>
    <tr>
        <td class="alt1" colspan="2">
            <span class="smallfont">$activeusers</span>
        </td>
    </tr>
    </table>
<!-- end currently active users -->
</if>

to the code seen here in bold green text:

<!-- currently active users -->
<if condition="$show['activeusers']">
    <br />
    <table class="tborder" cellpadding="$stylevar[cellpadding]" cellspacing="$stylevar[cellspacing]" border="0" width="100%" align="center">
    <tr>
        <td class="tcat" colspan="2">
            <phrase 1="$totalonline" 2="$numberregistered" 3="$numberguest">$vbphrase[users_viewing_this_thread_x_y_z]</phrase>
        </td>
    </tr>
    <tr>
        <td class="alt1" colspan="2">
            <span class="smallfont">$activeusers</span>
        </td>
    </tr>
    </table>
</if>
<!-- end currently active users -->

So the HTML comments must be outside of the conditional statement. Otherwise, the following setting in ACP won't be activated:

Auto-Template Search Text : Who Read This Thread
Edit the text that the Auto Template Change searches for. Do not alter this unless
you understand what you are doing, otherwise the modification will stop working.

The default text string shown there is: <!-- end currently active users -->

Has no one else run across this problem when trying to get the add-on to work?

[Paul M]

Originally Posted by cbiweb

Okay, here's an issue that no one else seems to have had, or reported.
.
.

Has no one else run across this problem when trying to get the add-on to work?

No one has come across it, or reported it, for a very simple reason - it doesnt exist in the 3.8 version (which is what this thread is). This version uses a template hook, not previously available.

In previous versions (3.5/6/7) you will find the following clearly stated ;

Note: You must have the "Show Users Browsing Threads" option set in your vbulletin options for this to display.

Due to what you found above

[cbiweb]

Ah, that explains it. I just checked and see that I have version 3.41, and I was sure I had downloaded 3.8! My bad. Downloading again right now.


Edit: Yes, I did have 3.8 downloaded but I also had the older version on my hard drive, and mistakenly installed it on a new site.

[HitmanB2Z]

Installed. Many thanks !