Home » Documentation » $Person->watched()

$Person->watched()

Returns a stack of content who $person has added the "watch" flag to.

The watch flag is very similar to the favorites flag, except that it includes a pointer to the last-viewed comment. This is used to keep track of which comments have been viewed, and thus which comments are new to the user.

This stack is sorted by the content's commentDate, so the content with the most recent comment activity will be first in the list.

By default, this will contain the 20 most recently watched documents. If you need to see more, pass a number on your first use of the function:

$all_my_watched = $person->watched(10000000);

Examples:

You might want to output a list of someone's favorites:

$person->favorites()->output('short');

Our display how many favorites someone has....

echo $person->favorites()->totalCount();

See also: $Person->addWatch(), $Person->removeWatch(), $Person->toggleWatch(), $Person->isWatched(), $Content->markCommentsAsRead(), and $Content->goToFirstUnreadComment().

Don't forget: because this function returns a stack, it has all the capabilities of stacks.

  • Discuss This Document

No comments have been posted yet.

Download Download the latest version of PeoplePods!

0.7 Latest Version:
Release Notes

A free membership is required to download PeoplePods.

  Already Registered? Login

Recent Posts from Our Blog

Version 0.7 Now Available

Last night, I uploaded a new release of PeoplePods: version 0.7. The most exciting new features in this version are: new dynamic image resizing options, a faster comment polling system, new ways...

Developer Preview Launch!

I am very excited to announce the launch of PeoplePods version 0.666, THE DEVELOPER PREVIEW! After tons of hacking, I have tweaked the last line of code, and I am finally ready for a wider audience...