Extension:Reviews

Note: this extension is not ready for initial release yet (although it's close) and I'm no longer working on it. Feel free to get the code and finish it up. Or to try it out, but be warned, it is not really production ready.

About
The Reviews extension allows users to post Reviews on articles that have been marked as reviewable (using the __REVIEWABLE__ magic word) with one or more ratings. These articles also list previously posted reviews. Authors can edit their reviews and everyone can flag their reviews for review. Admins can approve and remove reviews.

Feature overview

 * People can post reviews on articles with one or more ratings attached.
 * Review authors can view and edit their reviews.
 * People with the can flag reviews.
 * Admins can approve and delete reviews.
 * Reviews can be sorted and filtered on various criteria.

Requirements
requires:


 * MediaWiki 1.18 or above
 * PHP 5.3 or above

Installation
Once you have downloaded the code, place the Reviews directory within your MediaWiki 'extensions' directory. Then add the following code to your LocalSettings.php file:

The final step is running the MediaWiki setup script update.php, which can be found in the maintenance directory of your MediaWiki install. Via the command line, this is typically done with:

Configuration
Configuration of is done by assigning to $egReviewsSettings in your LocalSettings.php file. The options are listed below and their default is set in the settings file. You should NOT modify the settings file, but can have a look at it to get an idea of how to use the settings, in case the below descriptions do not suffice.

Example of how to change a setting:

Available settings:

Furthermore, you can set the default values of some user preferences, done by assigning to $wgDefaultUserOptions.

Usage
Put  on the wiki pages for which users should be able to post reviews.

Internationalization
is fully internationalized. Translation of messages is done through translatewiki.net. The translation for this extension can be found here. To add language values or change existing ones, you should create an account on translatewiki.net, then request permission from the administrators to translate a certain language or languages on this page (this is a very simple process). Once you have permission for a given language, you can log in and add or edit whatever messages you want to in that language.

Authors
has been written by Jeroen De Dauw.