rESWL/ac29170e8587master
/
README.md
Semantic Watchlist
![Build Status](http://travis-ci.org/SemanticMediaWiki/SemanticWatchlist) ![Code Coverage](https://scrutinizer-ci.com/g/SemanticMediaWiki/SemanticWatchlist/?branch=master) ![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/SemanticMediaWiki/SemanticWatchlist/?branch=master) ![Latest Stable Version](https://packagist.org/packages/mediawiki/semantic-watchlist) ![Packagist download count](https://packagist.org/packages/mediawiki/semantic-watchlist) ![Dependency Status](https://www.versioneye.com/php/mediawiki:semantic-watchlist)
Semantic Watchlist (a.k.a. SWL) is an extension to [Semantic MediaWiki][smw] that enables users to watch [semantic properties][smw-property] by adding a new watchlist page (Special:SemanticWatchlist) that lists changes to these properties.
Requirements
- PHP 5.3 - 5.6 and HHVM
- MySQL 5 (or later) and SQLite 3
- MediaWiki 1.19 - 1.25
- [Semantic MediaWiki][smw] 2.x (and 1.9.x)
Installation
The recommended way to install Semantic Watchlist is by using [Composer][composer] with an entry in MediaWiki's composer.json.
json { "require": { "mediawiki/semantic-watchlist": "~1.0" } }
- From your MediaWiki installation directory, execute composer require mediawiki/semantic-watchlist:~1.0
- Run php maintenance/update.php from your MediaWiki installation directory to create the required database tables.
- Navigate to _Special:Version_ on your wiki and verify that the package have been successfully installed.
For configuration, see the configuration documentation on MediaWiki.org.
Usage
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.
Features
- 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.
Find a more detailed usage documentation on MediaWiki.org.
Contribution and support
If you have remarks, questions, or suggestions, please send them to semediawiki-users@lists.sourceforge.net. 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][contributors].
- 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.
Extending Semantic Watchlist
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:
API modules
- addswlgroup an API module to add semantic watchlist groups.
- deleteswlgroup an API module to delete semantic watchlist groups.
- editswlgroup an API module to modify semantic watchlist groups.
- semanticwatchlist returns a list of modified properties per page for a persons semantic watchlist.
Hooks
- SWLBeforeEmailNotify
- SWLBeforeEditInsert
- SWLAfterEditInsert
- SWLBeforeChangeSetInsert
- SWLAfterChangeSetInsert
Tests
This extension provides unit and integration tests that are run by a [continues integration platform][travis] but can also be executed using composer phpunit from the extension base directory.
License
[GNU General Public License 3.0 or later][licence]
[mw]: https://www.mediawiki.org/ [smw]: https://github.com/SemanticMediaWiki/SemanticMediaWiki [mw-swl]: https://www.mediawiki.org/wiki/Extension:Semantic_Watchlist [composer]: https://getcomposer.org/ [contributors]: https://github.com/SemanticMediaWiki/SemanticWatchlist/graphs/contributors [licence]: https://www.gnu.org/copyleft/gpl.html [travis]: https://travis-ci.org/SemanticMediaWiki/SemanticWatchlist [smw-property]: https://semantic-mediawiki.org/wiki/Property