Extension:ArticleFeedback

MediaWiki extensions manual - list

Article Feedback Release status: unknown
Implementation	API
Description	Encourage user participation by giving readers the ability to assess an article. Give readers and editors a glanceable average of (user generated) ratings.
MediaWiki	1.18
License	GPLv2
Download	Download snapshot (Git master) Git [?]: repo summary • tree • code changes SVN [?]: checkout-url • tree • code changes
Hooks used LoadExtensionSchemaUpdates ParserTestTables BeforePageDisplay ResourceLoaderRegisterModules ResourceLoaderGetConfigVars GetPreferences
Check usage (experimental) Bugs: list open list all report

See Article feedback/Public Policy Pilot for more information.

The Article Feedback Tool is a Wikimedia Foundation project designed to engage Wikimedia readers in the assessment of article quality, one of the five priorities defined in the strategic plan. It is currently deployed on a subset of pages on the English Wikipedia.

This extension does not work with MediaWiki 1.17 or earlier!

Installation

You also need to install:

• Extension:ClickTracking
• Extension:EmailCapture
• Extension:SimpleSurvey (which requires Extension:PrefSwitch)

To install this extension, add the following to LocalSettings.php:

require_once( "$IP/extensions/ClickTracking/ClickTracking.php" );
require_once( "$IP/extensions/EmailCapture/EmailCapture.php" );
require_once( "$IP/extensions/PrefSwitch/PrefSwitch.php" );
require_once( "$IP/extensions/SimpleSurvey/SimpleSurvey.php" );
require_once( "$IP/extensions/ArticleFeedback/ArticleFeedback.php" );
 
$wgArticleFeedbackLotteryOdds = 100; // Will turn on the voting on all pages

and run maintenance/update.php (...twice, because it has a bug.)

Configuration

$wgArticleFeedbackCategories

An array of category titles (using '_'s instead of spaces). Pages in any of these categories will have the rating widget shown. If empty (the default), the extension is effectively disabled, depending on the value of $wgArticleFeedbackLotteryOdds. e.g.:

$wgArticleFeedbackCategories = array( 'Foo_bar', 'Baz' );

$wgArticleFeedbackBlacklistCategories

Which categories the pages must not belong to have the rating widget added (with _ in text). e.g.:

$wgArticleFeedbackBlacklistCategories = array( 'Baz' );

$wgArticleFeedbackNamespaces

Only enable the rating widget in these namespaces (regardless of the category of the page). Defaults to $wgContentNamespaces (defaults to array( NS_MAIN ) ). e.g.:

$wgArticleFeedbackNamespaces = array( NS_MAIN, NS_HELP, NS_PROJECT );

$wgArticleFeedbackLotteryOdds

Articles not categorized as one of the values in $wgArticleFeedbackCategories can still have the rating widget psudo-randomly activated by applying the following odds to a lottery based on $wgArticleId. The value can be a floating point number (percentage) in range of 0 - 100, 0 being always off, 100 being always on. Tenths of a percent are the smallest increments used. e.g.:

$wgArticleFeedbackLotteryOdds = 30.4;

$wgArticleFeedbackDashboard

Whether to enable the dashboard page (disabled by default). e.g.:

$wgArticleFeedbackDashboard = true;

$wgArticleFeedbackRatings

A good way to configure the categories is configurable 'just fine' using $wgArticleFeedbackRatings and corresponding entries in the article_feedback_ratings table.

$wgArticleFeedbackRatings = 'just fine'; # Don't forget to do something with the corresponding entries in the article_feedback_ratings table

Feedback

Open tickets in Wikimedia's BugZilla under the "ArticleFeedback" component in the "MediaWiki extensions" product.

• Open ArticleFeedback tickets
• Open UsabilityInitiative tickets about PrefSwitch / SimpleSurvey / ClickTracking