Watch

🚧Documentation Under Construction

We are actively working to improve this documentation. The content you see here may be incomplete, subject to change, or may not fully reflect the current state of the feature. We appreciate your understanding as we continue to enhance our docs.

As content is created or edited in Brightspot, you or other editors may want to "watch" that content to see if or when changes occur.

Adding watchers

This topic describes how to add watchers to an asset.

To add watchers to an item:

1. Search for and open the item on the content edit page.
2. In the upper-right corner of the content edit page, click to access the content edit actions list.
3. Click View Watchers.
4. In the In the View Watchers pop-up, click the Add Watcher field to search for an editor to add as a watcher.
5. Click Add.
6. Click to close the widget and return to the asset.

To add yourself as a watcher to an asset:

1. Search for and open the item on the content edit page.
2. In the upper-right corner of the content edit page, click to access the content edit actions list.
3. Click Watch.
4. Close the content edit actions list.

Removing watchers

This topic describes how to remove watchers from an asset.

To remove watchers from an asset:

1. Search for and open the asset on the content edit page.

2. In the upper-right corner of the content edit page, click to access the content edit actions list.

3. Click View Watchers.

4. In the View Watchers pop-up, click to remove an editor as a watcher.

   

5. Click to close the widget and return to the asset.

To remove yourself as a watcher from an asset:

1. Search for and open the asset on the content edit page.

2. Click Unwatch.

3. Close the content edit actions list.

Searching for watched content

Configuring the watch filter

Brightspot's watch settings help editors quickly search for assets they are watching.

To configure the watch filer:

1. Click > Admin > Sites & Settings > Sites > Global.

2. Click , located to the left of , and type Watching.

3. In the Widgets Watching Filter list**,** select Enabled to include the watching filter in the search panel's results.

   

4. In the Widgets Watching Filter list, select Disabled to include a watching toggle in the search panel's miscellaneous filters.

   

5. Click Save.

Using the watch filter

To search for watched content:

1. Click in the Search field to open the search panel.

2. Under Global Filters, in the Any Watcher filter, select one of the following:

   • Any Watcher–The search results are not filtered by watcher.
   • Watcher: Current User–Filters for content you are watching.
   • Wather: Select–Filters for content that the user you select is watching.

3. Add other search criteria as necessary.

Brightspot displays content that you are watching.

Adding watchers automatically

You can automatically add editors who save or publish an asset to the list of watchers in the Watchers widget.

To automatically add users as watchers:

1. Click > Admin > Sites & Settings > Sites > Global.
2. Under the CMS tab, expand the Watch cluster.
3. Toggle on Publish User Auto Watch On Save to automatically add an editor who publishes an asset to its list of watchers.
4. Toggle on Update User Auto Watch On Save to automatically add an editor who saves an asset to its list of watchers.
5. Click Save.

Note

An editor may opt out of the Watchers list for an individual asset and will not be re-added if they save or publish the asset in the future. For details, see Removing watchers.

Auto-Watch

Auto-watch is a feature that automatically adds a user as a watcher after performing an action on that asset. For example, if an editor posts a comment to an article's conversation, that editor can automatically become a watcher on that article.

1
private static boolean processForm(ToolPageContext page, Recordable content) throws Exception {
2

3
    post.save();
①
4

5
    Record record = (Record) content;
②
6
    record.sendMessage("watch.autoAdd", page.getUser());
③
7

8
/* Return true or false */
9
}

• ①Commits the post associated with the content to the database.
• ②Instantiates a record variable based on the passed content.
• ③Establishes a watch on the passed content for the user who posted the conversation.

The first parameter for the sendMessage method is one of the following:

• watch.autoAdd—Adds the user unless the user previously removed the watch.
• watch.manualAdd—Adds the user regardless if user previously removed the watch.
• watch.autoRemove—Removes the user unless the user manually created a watch.
• watch.manualRemove—Adds a user regardless if user previously created a watch.