Extension:CategoryWatch

From MediaWiki.org
Jump to: navigation, search
MediaWiki extensions manual - list
Crystal Clear action run.png
CategoryWatch

Release status: stable

Implementation Notify
Description Extends watchlist functionality to include notification about membership changes of watched categories.
Author(s) User:Nad
Last version 1.2.0 (2010-07-15)
MediaWiki 1.11+
License GPL
Download Download snapshot
Subversion [Help]

Browse source code
View code changes

Hooks used
ArticleSave

ArticleSaveComplete

Check usage (experimental)

A feature that's missing from the MediaWiki Watchlist functionality is that if you watch a category page, you will only be notified when the content of the category page text changes. You won't be notified when pages are added to or removed from that category though which is probably the main information you were wanting when deciding to watch a category page.

This extension was developed primarily to be used in conjunction with the RecordAdmin extension, but it can also be used by itself. When used with these extensions, it's used to allow roles to be notified when work items have changed state and been moved into a category they're responsible for.

[edit] Installation

Note that this extension currently requires the MediaWiki to be of at least version 1.11. Create a CategoryWatch folder in your extensions directory. Download the latest snapshot and extract it to your extensions directory. Then include it in your LocalSettings.php file as in the following example.

include("$IP/extensions/CategoryWatch/CategoryWatch.php");

[edit] Configuration

The global variable called $wgCategoryWatchNotifyEditor can be set to true which will allow the user who re-categorises an article to also receive the notification message if it is a category they are watching. This is useful so that the editor has an audit trail of all membership changes to categories they're watching.

A new global variable called $wgCategoryWatchUseAutoCat can be set to true which causes users to automatically be watching a category of the name Category:Automatically watched by <USERNAME> (set it the categorywatch-autocat message). For example, if you were logged in to the wiki as User:Foo, then you would automatically be notified of any changes to articles in Category:Automatically watched by Foo.

Another related global called $wgCategoryWatchUseAutoCatRealName was added on July 15th 2010 which modifies the automatically watched category function to work with real name's instead username's. If this was set to true for the example discussed in the previous paragraph, the category name might be something like Category:Automatically watched by Henry McFoo.

[edit] See also

Personal tools
Namespaces
Variants
Actions
Site
Support
Download
Development
Communication
Print/export
Toolbox