Who Viewed This Thread - Enhanced Version

Who Viewed This Thread - Enhanced Version v1.3.2


Version: 1.3.2
vB Version: 3.0.3
Developer: Ocean
Install Difficulty: Moderately Easy



The original hack this references was done by Gary King (https://vborg.vbsupport.ru/showthread.php?t=61222). I modified his hack in order to gain some additional functionality.

This hack is meant to be installed instead of Gary's original version - not in addition to it (for sanity's sake, as far as managing the code is concerned).


(This was submitted as a seperate hack with Gary's permission. If this belongs in a different group, I'm sure a Moderator will move it accordingly. )


Description:

This hack will allow you to see which users have viewed any given Thread. In addition, there is a second section that is resettable. What this means, is that there are two sections that show a list of users who have viewed the Thread in question.

The first section is a Master List - it shows all users who have viewed that thread at ANY point in time (since the hack was installed).

The second section works like your car's Trip Meter. You can Reset that second section at any time and it will then show only the users that have viewed that thread FROM THAT POINT ON. In addition, this second section will show you the Date/Time of the last Reset, so that you know from what point that second list is showing. This is useful, for example, if you want to be able to see which users have viewed a thread after you have updated it, or after a particular post of interest has been made.

You can choose which UserGroups can view the Who Viewed information, or even if you want all users to be able to see the first section - but only certain UserGroups to see the second.

You can also choose whether you want the Who Viewed information to be displayed directly on the ShowThread page, or if you would prefer to only show a link that opens a Pop Up Window with the Who Viewed information there.




Release Notes:


v1.3.2

Fixed the problem where the Pop-Up Link was visible to users who didn't have permission to view that information. (They still wouldn't be shown the information - but the link shouldn't have been visible to them in the first place)


v1.3.1

Minor modifications to the Aesthetics of the ShowThread page, as well as the Who Viewed Pop Up Window. No functional changes. If you are using v1.3.0, you do not need to upgrade, unless you wish to have the new aesthetics.


v1.3.0

Added the ability to choose whether you want the Who Viewed information to be displayed directly on the ShowThread page (as it was for all prior versions of this hack), or if you would prefer to only show a link that opens a Pop Up Window with the Who Viewed information there. Also consolidated and cleaned up the code.


v1.2.6

Fixed the problem with the "Who Viewed Since" table collapsing the wrong object


v1.2.5

Minor changes to optimize code. No functional changes. If you have v1.2.4, you do not need to upgrade to v1.2.5.


v1.2.4

Reworked the Security Sections so that they are exponentially easier to set. Now, other than choosing which UserGroups you want to have access to this hack, you only need to change ONE variable in order to choose which Security Layout you want to use.


v1.2.3

Updated all of the Security Sections to allow for more flexibility in selecting which UserGroups may view the WhoViewed Information.


v1.2.1

Upgrade Notes have been updated, and an Upgrade Script provided for those who have Gary's original version installed. If you have already successfully installed v1.2 of this hack, there is no need to do anything further.


v1.2

The original hack allowed you to see which users had viewed any particular thread on your board. It was and is an excellent hack - however, I desired some additional functionality, and so I made the following changes:


1. The format of stored User IDs has changed to a comma delineated format. This was done to optimize the code by stripping out the need for an additional explode() and implode().

2. An additional set of information is now being kept and maintained. However, unlike the first set (which will show you who has viewed a particular thread - ever), the second set is resettable at any time by Admins. This gives you a "tripmeter" of sorts, as you can now tell who has viewed a particular thread from the last time you reset that counter for that thread.

3. The date and time of the last reset for each thread is kept and displayed. Otherwise, it would be self-defeating, as you wouldn't remember when you last reset it.

4. This hack has been written so that all functions are for Admins only. Instructions are included for modifying this, if you wish. (Note: Even if you make ALL information viewable to ALL users, only Admins are allowed to Reset Counters. It is recommended that you do not change this)

5. I have the template additions being added at the bottom of the ShowThread page (right above the posting permissions). It seems to make more sense putting it there, as it doesn't get in the way, aesthetically speaking. Basically, if you want to check that section, it's there - if not, you'll never be bothered by it. If you prefer to have it somewhere else, feel free to insert the ShowThread Template portion of the code wherever you wish.



UPGRADE NOTES:

The instructions for this hack assume that you do NOT have any prior version installed.

At the moment, if you already have Gary's original 1.0 version installed, you will either need to completely clear out the existing data, before installing this hack - or you can download the "WhoViewedUpgradeFormat.php" script in order to convert the data format over to the new style.

Instructions are included for upgrading.

[David_R]

install file is confusing me.. i cannot understand properly what changes to be made to showthread.php file

[Jenta]

nice hack but extremely confusing instructions

i will sit here for an hour reading every single thing i can and try to make sense of it

i know i will eventually after very carefull reading but...

[Imperial Fritz]

Tested with 3.0.7?....

Cause in my showthread.php there's nothing like

PHP Code:

// *********************************************************************************
//set thread last view
$threadview = fetch_bbarray_cookie('thread_lastview', $thread['threadid']); 


instead there is

PHP Code:

// *********************************************************************************
//set thread last view
if ($thread['pollid'] AND $vboptions['updatelastpost'] AND ($displayed_dateline == $thread['lastpost'] OR $threadview == $thread['lastpost']) AND $pollinfo['lastvote'] > $thread['lastpost'])
{
    $displayed_dateline = $pollinfo['lastvote'];
} 


So should I add the code aboove this part?...




EDIT:

Well since I like to experiment I did it and seems to work fine. But probably you should change the instructions.

Originally Posted by Ocean

If it's not showing up as is, then I'll have to look into it. But I might not incorporate it until the next feature version.

Username formatting doesn't show at all as of now. When could we expect a new release?

[CrazyLady]

maybe I can sneak in here and ask if this can be modified, or a new hack created, to show if ANY member of a user group, (super moderators) has view the board. I would like to see if I can add a icon in the thread list view to tell my moderators if a thread has already been viewed/moderated by another moderator, saving them from having to view it as well... just a simple yes or no output?

anyhoo, just thought I would ask... nice looking hack!

[snake-boy]

Hi,

This is a fantastic hack, and I installed it with no problems in v3.0.7. Everything seems to be working except there is a critical bit of funcionality missing:

There does not seem to be any way to show the time/date the thread was viewed as there was in the original version of this hack.

The layout of this is SO much better than the original, but without time/date information, it isn't as helpful as it cold be... Is there any way to add time and datestamps to the list of users who viewed the thread?

-snake

[aranthorn]

Getting something weird. It was working very well, then I started getting a blank white page when resetting counters. Any ideas what I may have done?

[mtha]

Originally Posted by Ocean

Actually, you can accomplish that function right now. In fact, it's easy when it's a new and single announcement - because all you have to do is save the user list once the time is up, and you'll know who viewed it by that point and who didn't.

Where it gets tricky, is if you edit or add to that announcement - because then the question is who read it since it was updated. It's for that reason that I added that second counter. Now, once you edit or add to an Announcement/Bulletin/Post, just reset the second counter for that thread. Now you'll know exactly who read it before your changes and who read it afterwards.

Ocean, can you make it to Who View This Announcement too? wouldnt be too hard, right?

[Brandon Sheley]

nice hack, installed no probs.. was a little confused with step 6. but after looking thu this thread i got it working fine

thank you

*clicks instal*

[brvheart]

ok, I have 3.0.7


this is the code that I see:

/

PHP Code:

/set thread last view
if ($thread['pollid'] AND $vboptions['updatelastpost'] AND ($displayed_dateline == $thread['lastpost'] OR $threadview == $thread['lastpost']) AND $pollinfo['lastvote'] > $thread['lastpost'])
{
        $displayed_dateline = $pollinfo['lastvote'];
}

if ((!$posted OR $updatethreadcookie) AND $displayed_dateline AND $displayed_dateline > $threadview)
{
        set_bbarray_cookie('thread_lastview', $threadid, $displayed_dateline); 


I am supposed to be looking for this:

PHP Code:

// *********************************************************************************
//set thread last view
$threadview = fetch_bbarray_cookie('thread_lastview', $thread['threadid']); 


I did a search in winsyntax(my editor), and the code

PHP Code:

$threadview = fetch_bbarray_cookie('thread_lastview', $thread['threadid']); 


is not found until way down the screen no where close to

PHP Code:

//set thread last view 


so where should I add the this above?

PHP Code:



################################################################################
########################## Who Viewed This Thread ##############################
##########################      CONFIGURATION     ##############################
################################################################################




/ 


*


Any help would be greatly appreciated.

[brvheart]

ok, let me see if I got this right,

I inset nothing between the "configuration Sections" it is just guidlines, but after that I post everything until the next step?

I think that is where I went wrong, I will try again, please someone chime in here and give me a hand