= Watchlist for Wikis and Tickets = == Description == This plug-in adds a watchlist for wikis and tickets. Every logged-in user can watch any wikis and ticket and later unwatch it. The watchlist is provided under `[/projectname]/watchlist` which is added to the main navigation bar as soon the user watches something. To insert a watchlist style table into wikis use the ListOfWikiPagesMacro. A special [source:watchlistplugin/0.11/tracwatchlist/watchlist_report.sql ticket report] which only shows watched tickets is also provided. == Installation == Install the python package [t:TracPlugins as normal] and update your Trac database using: {{{ trac-admin /path/to/trac/environment upgrade }}} == Bugs/Feature Requests == Existing bugs and feature requests for WatchlistPlugin are [report:9?COMPONENT=WatchlistPlugin here]. If you have any issues, create a [http://trac-hacks.org/newticket?component=WatchlistPlugin&owner=martin_s new ticket]. == Download == Download the zipped source from [download:watchlistplugin here]. == Source == You can check out WatchlistPlugin from [http://trac-hacks.org/svn/watchlistplugin here] using Subversion, or [source:watchlistplugin browse the source] with Trac. == Usage == Browse any wiki or ticket and click ''Watch'' in the context navigation bar. To unwatch a wiki or ticket browse to it and click ''Unwatch'' in the context navigation bar or click the corresponding ''Unwatch'' link in the watchlist. In order to see the watchlist click on the ''Watchlist'' button on the main navigation bar. This button will only be displayed for logged in users. The watchlist will be displayed under the location `/watchlist`. Therefore it can be linked to from a wiki page using `[/watchlist]`. == Watchlist Report == A ticket report can be added to list all watched tickets of the current user. This is not done automatically at the moment. However, the needed SQL code for a manual installation can be taken from the [source:watchlistplugin/0.11/tracwatchlist/watchlist_report.sql this file]. == Using it together with the AnnouncerPlugin ==#AnnouncerPlugin If the AnnouncerPlugin is used to receive change notifications the watchlist allows the user to easily change the notification setting of watched wikis and tickets. If this feature is enabled an extra column appears in the watchlist which informs the user about the current setting (On/Off) and allow him/her to change it. To enable this feature install the AnnouncerPlugin and write the following into your Trac configuration file (`conf/trac.ini`): {{{ [watchlist] notifications = true }}} This feature implements enhancement request #4744. To enable notifications by default for all entries in the watchlist (see #6052) also add: {{{ # still in [watchlist] notify_by_default = true }}} See #5682 for how to configure/modify the AnnouncerPlugin for use with this plugin. == Screenshots == [[Image(watchlist.png)]] == Recent Changes == [[ChangeLog(watchlistplugin, 3)]] == Author/Contributors == '''Author:''' [wiki:martin_s] [[BR]] '''Contributors:'''