Semantic Watchlist (a.k.a. SWL) is an extension to Semantic MediaWiki that enables users to watch semantic properties by adding a new watchlist page (Special:SemanticWatchlist) that lists changes to these properties.
Users can choose to follow one or more watchlist groups, which are administrator defined, and cover a set of properties and a set of pages (category, namespace, or SMW concept). Notification of changes to watched properties is also possible via email.
- A watchlist page (Special:SemanticWatchlist) listing changes to properties watched by the user.
- Per-user optional email notification per edit that changes properties.
- Integration with user preferences to allow users to specify which watchlist groups they want to follow, and if they want to receive emails on changes.
- Special:WatchListConditions as administration interface for watchlist groups.
- API module to query property changes grouped by edit for a single user.
- API modules to add, modify and delete the watchlist groups.
- PHP 5.3 or later
- MediaWiki 1.19 or later
- Semantic MediaWiki 1.9 or later
- MySQL 5 or later
The recommended way to install this extension is by using Composer. Just add the following to the MediaWiki composer.json file and run the php composer.phar install/update command.
{
"require": {
"mediawiki/semantic-watchlist": "~1.0*"
}
}If you have remarks, questions, or suggestions, please send them to [email protected]. You can subscribe to this list here.
If you want to contribute work to the project please subscribe to the developers mailing list and have a look at the contribution guildline. A list of people who have made contributions in the past can be found here.
- File an issue
- Submit a pull request
- Ask a question on the mailing list
- Ask a question on the #semantic-mediawiki IRC channel on Freenode.
Semantic Watchlist is in part a workflow extension, which makes it important for other SMW/MW extensions and tools to interact with it. This is possible via the hooks and API modules Semantic Watchlist provides:
- addswlgroup: API module to add semantic watchlist groups.
- deleteswlgroup: API module to delete semantic watchlist groups.
- editswlgroup: API module to modify semantic watchlist groups.
- semanticwatchlist: Returns a list of modified properties per page for a persons semantic watchlist.
- SWLBeforeEmailNotify: $group, $user, $changeSet, $describeChanges, &$title, &$emailText
- SWLBeforeEditInsert: &$this
- SWLAfterEditInsert: &$this
- SWLBeforeChangeSetInsert: &$this, &$groupsToAssociate, &$editId
- SWLAfterChangeSetInsert: &$this, $groupsToAssociate, $editId
This extension provides unit tests that can be run by a continuous integration platform or manually by executing the mw-phpunit-runner.php script or [phpunit][mw-testing] together with the PHPUnit configuration file found in the root directory.
php mw-phpunit-runner.php [options]