Show Thread Enhancements - Who has read a Thread

This modification is no longer available or supported.

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, and (optionally) what IP address they viewed it from (Note: as of v3.34 you can only view the ip addresses in the 'View-All' display).

There is now 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.

A new time set/reset facility has been added. Members allowed to use this facility can click on the 'set' link and it will set a personal 'cutoff' time - only showing who has read the thread after that time. The time can be reset as many times as you want, 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.

A cron job has now been added that can (optionally) delete 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.

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.


There are 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.

New in v3.28

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.

New in v3.39

9. Clicking on a user will display a page of their thread viewing history, most recent first.


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.


History:

v3.20 : First Release for vb 3.6, a few code changes.
v3.21 : Dependancies updated for 3.6.0 Gold.
v3.22 : Updated for Version Checking.
v3.23 : Internal Development version.
v3.24 : Internal Development version.
v3.25 : Internal Development version.
v3.26 : Internal Development version.
v3.27 : Private release.
v3.28 : Public release of new features.
v3.29 : Fixed bug in clean-up, the setting was hours, not days.
v3.30 : Added options to disable/change auto template insert (not released).
v3.31 : Internal Code Changes, Settings Group renamed.
v3.32 : Minor template change.
v3.33 : SQL Changes to use slave.
v3.34 : Added new template for username display code, made 'View-All' always available.
v3.35 : Added last post marker to 'View-All' display.
v3.36 : Fix uncached templates.
v3.37 : Fixed missing date/time display when 'set' function is used.
v3.38 : Moved auto-template options to mods main settings group.
v3.39 : Version infomation added, display of user thread reading activity added.
v3.40 : Bugfix : Correct bugs reported in posts #308 & #318.
v3.41 : Minor changes to install code only.

[gummerz]

cheers paul this is a must have

[Muellmann]

it doesn't list the people who have readed on some threads now after a while.
on the beginning it listed all threadreaders correctly. now i recognized that on some new threads no reading people exists (i mean no members exists who readed the thread, in the list), but many members readed the thread already.

the old hack works fine (for 3.5) with all threads. the new hack must have a bug somewhere because i set all settings surely correctly (its not my first installed hack). the first five hours it works and then on some threads beginner to be no new readers displayed. i have a clean 3.62 engl. version.

i needed to uninstall and i hope on a soon fix. till it i will use your older working one.

[Paul M]

Hmm, do you have a value set in the Table Clean-up setting ?

[Paul M]

There was a bug in the records clean-up code - the setting was being treated as hours, not days, so if you set it to (say) 180, it would remove records after a week, not six months. The default on installation was for this option to be disabled, so you would only be affected if you changed this. To upgrade simply import the new product XML.

[grazianno]

i got tis error when i updated the plugin

### INSERT QUERY GENERATED BY fetch_query_sql() ###
INSERT INTO vbplugin
(`active`, `executionorder`, `title`, `hookname`, `phpcode`, `product`)
VALUES
('1', '5', 'Display Thread Readers (1)', 'cache_templates', 'if ($vbulletin->options[\'whohasread\'])\r\n{\r\n $groups = explode(\',\',$vbulletin->options[\'whohasreadgrps\']); \r\n if (is_member_of($vbulletin->userinfo,$groups) OR $groups[0] == 0) \r\n {\r\n $show[\'whohasread\'] = true;\r\n $globaltemplates[] = \'Display_Readers\';\r\n }\r\n else \r\n {\r\n $show[\'whohasread\']= false;\r\n }\r\n $wripgrps = explode(\',\',$vbulletin->options[\'whoreadipgrps\']); \r\n if (is_member_of($vbulletin->userinfo,$wripgrps)) \r\n {\r\n $show[\'whohasreadip\'] = true;\r\n }\r\n else \r\n {\r\n $show[\'whohasreadip\'] = false;\r\n }\r\n}\r\nelse\r\n{\r\n $show[\'whohasread\']= false;\r\n}\r\nif ($vbulletin->options[\'whoreadauthor\'])\r\n{\r\n $globaltemplates[] = \'Display_Readers\';\r\n}', 'paulm_20050716');

MySQL Error : Unknown column 'executionorder' in 'field list'
Error Number : 1054
Date : Tuesday, October 10th 2006 @ 12:30:22 PM

[DJGavin]

I must say how much I love this add on. It is so useful to see who has read a thread and when - especially with some of the +++++ier comments my members make about people (well one sensitive person in particular). Also nice to see such prompt support.

[Shazz]

Thanx for another update

[Gripemaster]

Thanks yet again Paul... I love the reset feature... great for announcement threads.

so let me make sure I have this right:

Who read records older than this number of days will be purged from the database, this is an optional housekeeping function - set to 0 to disable.

If I set the value to "30", all entries over 30 days old will be automatically cleansed from the table?

Thanks as always.

[Paul M]

Originally Posted by grazianno

i got tis error when i updated the plugin

.......

MySQL Error : Unknown column 'executionorder' in 'field list'
Error Number : 1054
Date : Tuesday, October 10th 2006 @ 12:30:22 PM

You cannot install a 3.6 modification on a 3.5 forum.

[Paul M]

Originally Posted by Gripemaster

If I set the value to "30", all entries over 30 days old will be automatically cleansed from the table?

Yes.