History: Watch
Source of version: 39
Copy to clipboard
! User Watches
If a user wants to receive an e-mail when something is edited or when new articles, forum topics or (almost) any other content is added or edited, they can create a watch. For instace, for the page ((Using Wiki Pages)) in this documentation site, a registered user will have the option to monitor it (e.g. 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__ {maketoc title="" levels="2,3"}
!!# 'My Watches' User Interface
A user can add watches for many tiki objects (like watching new articles) in the user's MyTiki's "My Watches" page {img src=img/mytiki/mywatches.gif }:
__Main Application menu > My Tiki > My Watches__ (''tiki-user_watches.php'').
The user Watches and preferences has several tabs (the number depends on the number of activated features in the tiki 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 allows to indicate if you want to receive an email with the notification of the changes that you have done yourself to that tiki site. If you keep these options below unchcked, you will not receive a copy 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 toward the top of many pages. The eye changes to {icon name="eye-slash"}, indicating that you have set a Watch.
*A Watch for a __Web page__ {icon name="eye"} (__Wiki__-based web page) sends you the new page when it is edited, and any new comment when they are added to the page, and replies to those comments.
* A Watch for a Wiki __Structure__ {icon name="eye"} (a structured set of __Wiki__-based web pages) sends you the name of the new page that has been added to the "((Structure))".
* A Watch for a Wiki __Sub-structure__ {img src=img/icons/eye_arrow_down.png} (a structured set of __Wiki__-based web 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 for a Content __Category__ {icon name="eye"} (a category of content of the web site) sends you the name of the object that has been added or removed to that "((Category))".
* A Watch for 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 for a __Forum__ {icon name="eye"} (at forum level, tiki-view_forum.php, to watch for 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 & 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, without the need to manually subscribe also to each one of those topics of the same forum.
* A Watch on a __Calendar__ {icon name="eye"} 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 tiki 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__" for 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 belogs to).
* a "__Group Watch__" for 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__" for 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__" for a __Forum Topic & 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 tiki 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 open eye with the red cross ({img src=img/icons/no_eye.png}), which then will change state into not monitoring that page anymore:
+ %%% {img src="display780" link="display780" width="600" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}
+ or %%% %%%
# go to MyTiki'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 Tikiwiki documentation suggest that a watch does not report a change to a web 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}
Starting in ((Tiki2|2.0)), a category can be watched, and thus you'll receive an email when things are added or removed from the category __but also__ when items in the category are modified. This can be useful for TikiWiki as a ((Document Workflow)) or in ((Project Management)).
Starting in ((Tiki3|3.0)), watches can be assigned to ((Group Watches|groups)).
!!# 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))