Extension:Report

MediaWiki extensions manual

File:OOjs UI icon advanced.svg Report Release status: beta
File:Extension-Report.PNG
Implementation	Special page , Database
Description	Allows users to privately report revisions
Author(s)	Ken Hilton (Kenny2wikitalk)
Compatibility policy	Master maintains backward compatibility.
MediaWiki	1.35+
PHP	>= 5.6
Database changes	Yes
Tables	report_reports
License	GNU General Public License 3.0
Download	<translate> Download extension</translate> <translate> Git</translate> [?]: <translate> Download Git master</translate> <translate> browse repository</translate> (GitHub) <translate> commit history</translate> <translate> repository contributors (GitHub)</translate> <translate> code review</translate>
Help	Help:Extension:Report
Added rights report handle-reports
Hooks used BeforePageDisplay DiffTools HistoryTools LoadExtensionSchemaUpdates
Quarterly downloads
Public wikis using
Translate the Report extension if it is available at translatewiki.net

The Report extension adds a special page for users to privately report revisions of pages for admin attention, as well as another special page for admins to handle such reports.

Installation

• <translate> [[<tvar name=2>Special:ExtensionDistributor/Report</tvar>|Download]] and move the extracted <tvar name=name>Report</tvar> folder to your <tvar name=ext>extensions/</tvar> directory.</translate>
  <translate> Developers and code contributors should install the extension [[<tvar name=git>Special:MyLanguage/Download from Git</tvar>|from Git]] instead, using:</translate>cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Report
• <translate> Add the following code at the bottom of your <tvar name=1>LocalSettings.php </tvar> file:</translate>

  wfLoadExtension( 'Report' );
  

• <translate> Run the [[<tvar name=update>Special:MyLanguage/Manual:Update.php</tvar>|update script]] which will automatically create the necessary database tables that this extension needs.</translate>
• File:OOjs UI icon check-constructive.svg <translate> Done</translate> – <translate> Navigate to <tvar name=special>Special:Version</tvar> on your wiki to verify that the extension is successfully installed.</translate>

Optional configuration

By default, only registered users can report revisions, and only sysops can handle reports:

// These are the default settings for the extension, no need to manually set it
$wgGroupPermissions['user']['report'] = true;
$wgGroupPermissions['sysop']['handle-reports'] = true;

If different permissions are required, simply adjust $wgGroupPermissions. For example, to allow unregistered users to report revisions, and only allow bureaucrats to handle reports, add the following to LocalSettings.php, after loading the extension:

$wgGroupPermissions['*']['report'] = true;
$wgGroupPermissions['sysop']['handle-reports'] = false;
$wgGroupPermissions['bureaucrat']['handle-reports'] = true;

Usage

<translate> Main page:</translate> Help:Extension:Report

Reporting

1. Go to the history of a page, or look at a diff between revisions.
2. Click the "report" link (next to undo).
3. Enter a reason for reporting the revision.
4. Submit the report.

Handling reports

1. As an admin (or other user with the handle-reports permission), browse to Special:HandleReports.
2. You will be presented with a list of recent reports. Choose a report that catches your attention by clicking "View report".
3. On the "view report" page, you will be presented with a single button to mark the report as handled. After making sure that any required action for the report has been taken care of, click "Mark as handled".

Known issues

• After a report has been marked as handled, other admins can still re-mark it as handled. This only changes the who and when of the report being handled, however.

See also

• Help:Extension:Report
• Extension:AbuseFilter