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.

[AndyCr15]

Where am I supposed to see the results of this plugin? I've added it, no errors, says it's all on in the options, but I don't see any extra's in a thread?

[Paul M]

Originally Posted by nonspin

old version only has

PHP Code:

$oldpid = 'paulm_20050716'; 


set

while the new has

PHP Code:

// Start v3.8.003 //
$pidlist = array(
'paulm_20050716',
'paulm_wrt_38',
); 


Erm, where did you get that code from ?

This does not contain that code, it has the following ;

PHP Code:

$pidlist = array(
'paulm_20050716',
'paulm_wrt_37',
); 


Note that it is wrt_37, not wrt_38.

paulm_wrt_38 is this product, if it tried to delete itself on installation, I have no idea what would happen, but I doubt it would be good. Download the proper version from the first post, and install it.

[nonspin]

sorry, it was a typo on my side.
Anyway, upon install it removes the existing one.

Like i said, because the update proicedure checks a list of pids
to cover older and newser versions..

PHP Code:

$pidlist = array( 
'paulm_20050716', 
'paulm_wrt_38', 


.. since 'foreach' is used it processes the complete $pidlist.
if 'paulm_20050716' is found, the whole pidlist will be processed.
-> 'foreach'

.. Now .. to me trying the DELETE a not existing productid from the db might cause
some errors, -> Error Number : 2006 to be exact.


... but then again, what do i know.

[Paul M]

.. since 'foreach' is used it processes the complete $pidlist.
if 'paulm_20050716' is found, the whole pidlist will be processed.

Yes, the whole list will be processed, but if you actually read the code, you would see that each product is checked to see if its installed, and only deleted if it exists.

.. Now .. to me trying the DELETE a not existing productid from the db might cause
some errors, -> Error Number : 2006 to be exact.

Nope, a record not existing will not cause that error.

... but then again, what do i know.

[nanaimobar]

Originally Posted by hornstar1337

I just had an idea from this mod. MAybe you could create a new mod called "who has downloaded an attachment" and that way you can see which members have downloaded the attachment. Might be useful to know that info.

There is an older mod for what you want, and which allows you to freely copy his code and reuse it as long as it is for free, and works on 3.8.

Mod and my comments on it are here.

[TheeMadame]

I just downloaded this to my computer to upload to my message board.
Upon my attempt to install it as a plug in, it gives me this message: XML Error: empty document at line one.
I apologize, but I don't know what this means, can anyone help?

[odln018]

Just got this upon attempting to import.

Database error in vBulletin 3.8.2:

Invalid SQL:
INSERT DELAYED INTO whoread
(userid, threadid, dateline, ipaddress)
VALUES (1, 367, 1242237395, '');

MySQL Error : DELAYED option not supported for table 'whoread'
Error Number : 1616
Request Date : Friday, May 15th 2009 @ 10:54:22 AM

[Paul M]

That probably means your table is not MYISAM format - which is the normal default.

[TheeMadame]

Finally got it installed, works good, thanks.

[odln018]

Originally Posted by Paul M

That probably means your table is not MYISAM format - which is the normal default.

How would I fix this? Ok, I resolved this.

How do I get the mod to actually appear? I'm not sure of how this works: showthread_after_activeusers