Available from version 1.12.0
Removed in version 1.14.0
Override watchlist display or add extra SQL clauses.
Define function:
public static function onBeforeWatchlist( $nondefaults, $user, &$hookSql ) { ... }
Attach hook: In extension.json:
	"Hooks": {
		"BeforeWatchlist": "MediaWiki\\Extension\\MyExtension\\Hooks::onBeforeWatchlist"
Called from: File(s): specials/SpecialWatchlist.php
Interface: BeforeWatchlistHook.php

For more information about attaching hooks, see Manual:Hooks .


  • $nondefaults: Assoc array with the following keys: days, hideOwn, hideBots, hideMinor, namespace
  • $user: User object.
  • &$hookSql: a string which will be inserted without sanitation into the SQL query used to get the watchlist, at the end of the WHERE part.