Extension:ArticleFeedbackv5

MediaWiki extensions manual - list

Article Feedback v5 Release status: beta
Implementation	API
Description	Encourage users to contribute to Wikipedia by allowing them to verbally assess an article.
MediaWiki	1.19 or higher
Database changes	yes
License	GPLv2
Download	Download snapshot (Git master) Git [?]: repo summary tree code changes
Hooks used LoadExtensionSchemaUpdates BeforePageDisplay ResourceLoaderRegisterModules ResourceLoaderGetConfigVars MakeGlobalVariablesScript GetPreferences EditPage::showEditForm:fields EditPage::attemptSave ArticleSaveComplete ContribsPager::reallyDoQuery ContributionsLineEnding ProtectionForm::buildForm ProtectionForm::save
Check usage and version matrix
Bugs: list open list all report

See Article feedback/Version 5 for more information.

The Article Feedback Tool, Version 5 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. Later versions will have a page to show feedback posted to an article, with moderation tools.

Installation

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

require_once( "$IP/extensions/ArticleFeedbackv5/ArticleFeedbackv5.php" );

and run maintenance/update.php

• If your wiki has a lot of traffic, Extension:AbuseFilter is recommended, to manage abusive feedback.

Configuration

$wgArticleFeedbackv5Categories

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

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

$wgArticleFeedbackv5BlacklistCategories

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

$wgArticleFeedbackv5BlacklistCategories = array( 'Baz' );

$wgArticleFeedbackv5Namespaces

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

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

$wgArticleFeedbackv5LotteryOdds

Percentage of article AFT should be enabled on. Note that even when a lottery is set for a certain namespace, AFT will not show up unless that namespace is also added to $wgArticleFeedbackv5Namespaces. This can be set either as integer as a site-wide percentage, or as a key-value array for a per-namespace percentage. e.g.:

// enable site-wide on 100% on all namespaces defined in $wgArticleFeedbackv5Namespaces
$wgArticleFeedbackv5LotteryOdds = 100;

// enable 100% on main namespace & 50% on help namespace (assuming both are also defined in $wgArticleFeedbackv5Namespaces)
$wgArticleFeedbackv5LotteryOdds = array( NS_MAIN => 100, NS_HELP => 50 );

Technical: all articles with an ID ending on (1000 - (odds * 10)) and above, will get AFT enabled. E.g. when setting odds at 15%, all articles whose ID ends in 850-999 will have AFT enabled.

$wgArticleFeedbackv5TalkPageLink

Defines whether or not there should be a link to the corresponding feedback on the page's talk page. e.g.:

$wgArticleFeedbackv5TalkPageLink = true;

$wgArticleFeedbackv5WatchlistLink

Defines whether or not there should be a link to the watchlisted feedback on the watchlist page. e.g.:

$wgArticleFeedbackv5WatchlistLink = true;

$wgArticleFeedbackv5DisplayBuckets

This defines which form should be displayed and at what percentage. Note that support for some forms (2, 3, 5) has been discontinued completely, as they no longer fit the technical architecture the rest was built upon.

$wgArticleFeedbackv5DisplayBuckets = array(
        'buckets' => array(
                '0'  => 0, // display nothing
                '1'   => 0, // display 1-step feedback form
//              '2'   => 0, // abandoned
//              '3' => 0, // abandoned
                '4'  => 0, // display encouragement to edit page
//              '5'  => 0, // abandoned
                '6'   => 100, // display 2-step feedback form
        ),
        'version' => 6,
        'expires' => 30,
);

$wgArticleFeedbackv5LinkBuckets

This defines which links should be displayed and at what percentage.

$wgArticleFeedbackv5LinkBuckets = array(
        'buckets' => array(
                'X' => 100,
                'A' => 0,
                'B' => 0,
                'C' => 0,
                'D' => 0,
                'E' => 0,
                'F' => 0,
                'G' => 0,
                'H' => 0,
        ),
        'version' => 5,
        'expires' => 30,
);

$wgArticleFeedbackv5CTABuckets

This defines which CTAs should be displayed and at what percentage.

$wgArticleFeedbackv5CTABuckets = array(
        'buckets' => array(
                '0' => 0, // display nothing
                '1' => 40, // display "Enticement to edit"
                '2' => 10, // display "Learn more"
                '3' => 0, // display "Take a survey"
                '4' => 20, // display "Sign up or login"
                '5' => 20, // display "View feedback"
                '6' => 10, // display "Visit Teahouse"
        ),
        'version' => 4,
        'expires' => 0,
);

$wgArticleFeedbackv5MaxCommentLength

Restrict comment length to an arbitrary number of characters. Defaults to zero for no check. e.g.:

$wgArticleFeedbackv5MaxCommentLength = 400;

Permissions

AFTv5 introduces a new set of permissions to define users' access roles. These are mapped to the following already existing groups by default, so make sure these are configured on your setup (or bind the AFT-permissions to the appropriate groups in your setup):

• aft-reader: *, user, confirmed, autoconfirmed, rollbacker, reviewer, sysop, oversight
• aft-member: user, confirmed, autoconfirmed, rollbacker, reviewer, sysop, oversight
• aft-editor: confirmed, autoconfirmed, rollbacker, reviewer, sysop, oversight
• aft-monitor: rollbacker, reviewer, sysop, oversight
• aft-administrator: sysop, oversight
• aft-oversighter: oversight

Feedback

Open tickets in Wikimedia's Bugzilla under the "ArticleFeedbackv5" component in the "MediaWiki extensions" product.

• Open ArticleFeedbackv5 tickets

See also

• Extension:ArticleFeedback, an earlier version 4 of the Article Feedback Tool that is still in use on some Wikimedia wikis.