MediaWiki extensions manual

ArticleRatings Release status: stableCategory:Stable extensions
Implementation	Tag Category:Tag extensions, Special page Category:Special page extensions
Description	Adds a complex interface for giving pages ratings.
Author(s)	Adam Carter
Latest version	2.7
MediaWiki	>= 1.43.0
Database changes	Yes
Tables	ratings
License	GNU General Public License 2.0 or later
Download	Download extension Git [?]: Browse repository (GitHub) Gerrit code review Git commit log Download source tarball Category:Extensions in Wikimedia version control README
Example	Brickimedia
Parameters $wgAREUseInitialRatings $wgARENamespaces
Tags ‎<rating />
Added rights change-rating Category:Extensions which add rights
Hooks used ArticleDeleteComplete Category:ArticleDeleteComplete extensions LoadExtensionSchemaUpdates Category:LoadExtensionSchemaUpdates extensions ParserFirstCallInit Category:ParserFirstCallInit extensions SidebarBeforeOutput Category:SidebarBeforeOutput extensions TitleMove Category:TitleMove extensions
Quarterly downloads	0
Translate the ArticleRatings extension if it is available at translatewiki.net
Issues	Open tasks · Report a bug

The ArticleRatings extension adds an interface for rating pages. Privileged users (those with the change-rating user right, by default members of the reviewers group) will see a link on the toolbox on supported skins and they will be able to use the interface at Special:ChangeRating to change pages' ratings.

This extension was developed for Brickimedia, and is not as portable as it could be.

Installation

• Download and move the extracted ArticleRatings folder to your extensions/ directory.
  Developers and code contributors should install the extension from Git instead, using:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/ArticleRatings
• Add the following code at the bottom of your LocalSettings.php file:

  wfLoadExtension( 'ArticleRatings' );
  

  Configure MediaWiki:Are-ratings interface message on-wiki; see #Messages below for more info. This is not optional!
• Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

User rights

• change-rating – new user right allows user to change the ratings of pages.

Tags

‎<rating /> adds the rating of a page to a page. ‎<rating /> on its own will add the rating of the page it is on, and <rating page="title" /> will give the rating of title.

Special pages

• Special:ChangeRating – interface for changing pages' ratings.
• Special:MassRatings – interface for getting the ratings of many pages at once.

Messages

• MediaWiki:Are-ratings – JSON file giving the name, codename (has to be 2 characters long), image, and link, for each rating. Should be an array of objects, in PHP-valid JSON. See Brickipedia for an example. The codename is just a 2 character string used by the software to identify the ratings, it doesn't matter what it is, as long as each rating's is different. Whichever rating comes first will be the default rating (the one used before the rating has been changed)

Variables

• $wgARENamespaces = $wgContentNamespaces; - Array of namespace numbers/constants that are allowed to have ratings on them.
• $wgAREUseInitialRatings = false; - If true, the ratings tag has an init-rating parameter that wil set the initial rating to the codename supplied, not the default. Not recommended for production use, but can be used as a workaround to allow bots to use the extension.

This extension is included in the following wiki farms/hosts and/or packages: Miraheze Category:Extensions included in Miraheze WikiForgeCategory:Extensions included in WikiForge This is not an authoritative list. Some wiki farms/hosts and/or packages may contain this extension even if they are not listed here. Always check with your wiki farms/hosts or bundle to confirm.