Automated mechanisms that enable you to watch wiki content and send you an email when changes are made are an essential part of a wiki. The key feature needed to make these notifications useful is the ability to configure the watched content effectively in order to target them properly. Confluence provides excellent support to watch pages and entire spaces but there is a need for an intermediate level of granularity on which to place watches and the ability to set up circulation lists in some key use cases.
It is to these functional gaps to which the Notifications for Confluence plugin is addressed.
With vanilla Confluence you have the choice of watching page or a space. Where you only need to watch few pages the page watch utility is ideal but when when you have responsibility for a significant number of pages this becomes unmanageable. What do you do with new pages? What do you do when a child page is created? How do you keep track of the pages you watch? The only real way to deal with this in vanilla Confluence is to watch the whole space, but then you are swamped by too many emails.
The Notifications for Confluence plugin solves many of these problems by allowing you to scope your watch to any page hierarchy within that space so that you can focus your watch effectively. It also allows you extend the watch facility to watch the children of a page as well.
This plugin also allows notifications to be sent to a circulation list in two particular situations.
This ensures that when news items are posted, the target audience knows about them before they are out of date.
Normally space wide watches send out too many emails so the idea of sending these emails to a circulation list may be counter-intuitive, but there are some use cases, particularly for spaces with stable content, when this is critical. e.g. A space with documentation for a sold product. In such a case it is necessary to inform the support group and indeed possibly the customers themselves when the content changes.
It is often critical to know when a part of a Confluence space has changed. In such cases:
Descendant watches allow you to monitor all changes within a page hierarchy by applying a descendant watch to a single page at the top of that hierarchy. When new pages are added to that hierarchy they are included in that watch. As a result, when there are any new pages or page deletions within that hierarchy, when there are any modifications or comments to pages within that hierarchy you will receive an email.
N.B. If your space administrator uses the group watch feature to email you when any pages in the space change, you will not be able to set descendant watches in that space. This is because any use of descendant watches would be redundant.
Creates a link, that when clicked will set a watch on another page. This can be particularly useful in setting up centralised pages with links pointing to other pages/spaces that staff may consider watching.
|space||Yes||The key of the space that contains the page to be watched.|
|page||Yes||The title of the page to be watched.|
Whether to watch just the specified page (false), or to watch all of it’s descendants too (true).
Defaults to true.
|class||No||Allows you to specify a class attribute on the generated link markup, to allow custom styling in CSS.|
The standard watch facility only allows you to watch an individual page. By default this plugin extends the watch feature so that when a watch is placed on a page, emails are also sent when child pages are:
Open the descendant watches profile tab and switch this feature off/on from there (see Managing Descendant Notifications below).
Descendant watches are managed through the descendant watches tab on your profile page. You can get to this tab by
With this this tab you have the following options
With standard Confluence you can request notification when any pages are changed within a space. With the Notifications for Confluence plugin a space administrator can set up:
Space administrator navigates to the group watchers tab on the space tools page.
Enter the groups you wish to be notified in the text field or use the group picker to ease selection. A group can be removed from the notification by clicking ‘Remove’ to the right of the group name.