Watchlist API

Last modified by Admin on 2026/04/27 00:03

cogAPI to manipulate a user's WatchList.
TypeJAR
Category
Developed by

XWiki Development Team

Active Installs15
Rating
0 Votes
LicenseGNU Lesser General Public License 2.1

Success

Installable with the Extension Manager

Description

Warning

Since 11.1RC1, Watchlist Application is deprecated and not installed by default on XWiki. It has been replaced by the Notifications Application

For older versions but beyond 10.1RC1 and 9.11.4, the Watchlist Application was installed but disabled by default in XWiki. See how to enable it anyway.

Please see the Script Service API's public methods from the source.

The script service is accessible using the watchlist name. Below, is an example in velocity:

$services.watchlist

The Script Service API uses enums as parameters, so if you want to use it in velocity, you will benefit from XWiki's Velocity uberspectors and just pass the enum value as a string. Example:

$services.watchlist.isWatched("DOCUMENT")

Prerequisites & Installation Instructions

We recommend using the Extension Manager to install this extension (Make sure that the text "Installable with the Extension Manager" is displayed at the top right location on this page to know if this extension can be installed with the Extension Manager).

You can also use the manual method which involves dropping the JAR file and all its dependencies into the WEB-INF/lib folder and restarting XWiki.

Dependencies

Dependencies for this extension (org.xwiki.platform:xwiki-platform-watchlist-api 12.5.1):

  • org.xwiki.platform:xwiki-platform-oldcore 12.5.1
  • org.xwiki.platform:xwiki-platform-diffplugin 12.5.1
  • org.xwiki.platform:xwiki-platform-scheduler-api 12.5.1
  • org.xwiki.platform:xwiki-platform-image-api 12.5.1
  • org.xwiki.platform:xwiki-platform-mail-send-default 12.5.1
  • org.xwiki.platform:xwiki-platform-activitystream-api 12.5.1

Get Connected