History: Watch

            ! User Watches
If a user wants to receive an e-mail when something is edited or when a new article, forum topic or (almost) any other content is added or edited at the site, the user can create a "watch". Watches can also be set for group notifications.

For instance, for the page ((Using Wiki Pages)) in this documentation site, a registered user has the option to monitor it (that is, will be able to add a "User Watch" to it): 

{img src="display1394" link="display1394" class="thumbnail img-responsive" alt="Watch feature screenshot" title="Wiki page watch icons"}

__Contents of this page__

!!# 'My Watches' User Interface
A user can add watches for many Tiki objects (like watching new articles) in the user's MyAccount's "My Watches" page:
__Main Application menu > My Tiki > My Watches__ (''tiki-user_watches.php''). 

The User Watches and preferences page has several tabs (the number depends on the number of activated features at the site): 
# Report preferences
+ {img src="display783" link="display783" width="500" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}
# My Watches
+ {img src="display784" link="display784" width="500" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}
** As indicated in the image above, you can __Select an event type__ from a list, that varies depending on the number of features enabled in the Tiki site, as well as on the permissions of your user to watch changes on those features or objects. 
++
++ {img src="display786" link="display786" width="400" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}
# Notification Preferences
+ These enable indicating if you want to receive an email with a notification of a change that you have made yourself at the site. If you keep these options below unchecked, you will not receive a notification of you own changes.
+ {img src="display785" link="display785" width="500" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}

!!# Types of watches
The user can click the click the little {icon name="eye"} eye that appears near the top of many pages (often in a dropdown menu or popup bubble).  When you click the eye to activate monitoring, it changes to {icon name="eye-slash"}, indicating that you have set a watch. 

*A watch on a __wiki page__ {icon name="eye"} sends you the new page when it is edited, and any comment that might have been added to the page, and replies to the comment.
* A watch on a wiki __structure__  {icon name="eye"}  (a structured set of wiki pages) sends you the name of the new page that has been added to the "((structure))".
* A watch on a wiki __sub-structure__ {img src=img/icons/eye_arrow_down.png} (a structured set of wiki pages below this level of the bigger hierarchical structure) sends you the name of the object that has been added or removed to that level of the "((structure))" and all its descendants.
* A watch on a content __category__ {icon name="eye"} (a category of content of the site) sends you the name of the object that has been added or removed to that  ((category)).
* A watch on a content __category and all its descendants__ {icon name="eye-slash"}  (a category of content of the web site and all the other ones below its hierarchical level) sends you the name of the object that has been added or removed to that  "((Category))" and all its descendants.
*A watch on a __forum__ {icon name="eye"} (at the forum level, tiki-view_forum.php, to watch all topics of this forum) tells you about new topics. It does not notify you of replies.
*A watch on a __forum topic__ {icon name="eye"} (at thread level, tiki-view_forum_thread.php) sends you any future replies posted to that topic. It does not notify you of new topics or replies to the new topics, unless you have subscribed also to that Forum.
*A watch on __forum topics and threads__ {img src=img/icons/eye_magnifier.png} (at forum level, tiki-view_forum.php, to watch for all topics and all their replies of this forum) sends you any future new topics and all their corresponding replies posted to them. It does notify you of new topics AND replies to the new topics, unless you manually subscribe also to each one of those topics of the same forum.
* A watch on a __calendar__ {icon name="eye"} sends you information on the new events added or edited in that specific calendar. As of ((Tiki10)) (2012) there is no way yet to watch all calendars at once. 
** __Note about Calendar Watches:__
++ Please note that if you have more than one calendar created at your site, you have to deselect all calendars except one (from the list of viewable calendars to be displayed) so that you can see the icon to watch that single calendar.
* And similarly for __all the other Tiki objects__ that accept "User Watches" {icon name="eye"}. See below the table listing all Tiki objects accepting them.

Note that site admins (belonging to a group which holds the permission to admin that corresponding Tiki object) can also add ((Group Watches)):
* a "__group watch__" on a __structure__ {icon name="group"} (to force one or several groups of users to watch for changes on the ((Structure)) of wiki pages  where that wiki page belongs to).
* a "__group watch__" on a __category__ {icon name="group"} (to force one or several groups of users to watch for changes on the ((category)) of objects).
* a "__group watch__" on a __forum__ {icon name="group"} (to force one or several groups of users to watch for all topics of this forum), or
* a "__group watch__" on a __forum topic and threads__ {icon name="group"} (to force one or several groups of users to watch for all topics and all their replies of that forum).
* a "__group watch__" on a __calendar__ {icon name="group"} sends you information of the new events added or edited in that specific calendar. As of ((Tiki10)) (2012) there is no way yet to watch all calendars at once. 
** __Note about Calendar Watches:__
++ Please note that if you have more than one calendar created in your site, you have to deselect all calendars except one (from the list of viewable calendars to be displayed) so that you can see the icon to group watch that single Calendar.
* And similarly for __all the other Tiki objects__ that accept "((Group Watches))" {icon name="group"}. See, below, the table listing all Tiki objects accepting them.

!!# How to turn off watches
To turn off a user watch, a user can either:

# Click on the "stop-monitoring" icon ({icon name="eye-slash"}), which then will change to show that the page isn't being watched~tc~:
+ %%% {img src="display780" link="display780" width="600" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}~/tc~
+ or %%% %%%
# Go to your MyAccount's "My watches" page and delete any or all of your watches.
+ %%% ^{img src="display781" link="display781" width="600" rel="box[g]" imalign="center" desc=" " align="center" } {img src="display782" link="display782" width="600" rel="box[g]" imalign="center" desc=" " align="center" }^

To have yourself removed from receiving ((Group Watches)):
* request a site admin to remove you from the group that receives those emails, or 
* ask the site admin to reconsider that group watch
** Maybe forcing the whole group of users is not a good idea any more once all users know how to enable or disable specific users watches of the objects they are interested in?

Some versions of the Tiki documentation suggest that a watch does not report a change to a wiki page that has been designated as a "minor" change. Please note that this might not be true anymore.

!!# Which sections can be watched
{TRACKERLIST(trackerId=>7,fields=>104:70:68,sort_mode=>f_104_asc,showtitle=>n,showlinks=>y,showdesc=>n,showinitials=>n,showstatus=>n,status=>opc,filterfield=>68,filtervalue=>yes)}{TRACKERLIST}

A category can be watched, and thus you'll receive an email when items are added to or removed from the category __but also__ when items in the category are modified. This can be useful for Tiki as a ((Document Workflow)) or in ((Project Management)).

Watches can be assigned to ((Group Watches|groups)), so that all members of a group receive watch notifications.

!!# How to enable/disable this feature
You must go to Admin -> Features -> User (tab), and check/uncheck User Watches.

!! Related pages
* ((Mail notifications)) for admins
* ((Forum User))
* ((Categories))
* ((Structures))
* ((Group Watches))
* ((Group Alert))
* ((Daily reports))

-=Alias names for this page=-
(alias(Watches)) | (alias(User Watches)) | (alias(User watch)) | (alias(Pull)) | (alias(Watching)) | (alias(user watches)) | (alias(userwatches))