Extension:AutoModerator
AutoModerator Release status: experimental |
|
---|---|
Description | Enables community-configured reversion of Machine Language-scored bad edits. |
Author(s) | |
MediaWiki | |
License | No license specified |
Download | |
Help | Help:Extension:AutoModerator |
Translate the AutoModerator extension if it is available at translatewiki.net | |
Issues | Open tasks · Report a bug |
The AutoModerator extension is under development by the Moderator Tools team at the Wikimedia Foundation. Read more about the project goals, and provide feedback, at Automoderator.
Please see Extension:AutoModerator/Deploying for guidance on how to request Automoderator on your Wikimedia project.
Installation
[edit]- Download and move the extracted
AutoModerator
folder to yourextensions/
directory.
Developers and code contributors should install the extension from Git instead, using:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/AutoModerator - Add the following code at the bottom of your LocalSettings.php file:
wfLoadExtension( 'AutoModerator' );
- Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.
Configuration
[edit]Internal configuration
[edit]These values are typically set in your LocalSettings.php for local development. The default values are shown here.
// Revert risk probability threshold; Edits scored above this value will be reverted.
$wgAutoModeratorRevertProbability = 0.99;
// Username for AutoModerator system account.
$wgAutoModeratorUsername = 'AutoModerator';
// Database id of project used to target liftwing lang parameter. (eg. 'enwiki'). If not set, it'll use database name.
$wgAutoModeratorWikiId = null;
// If set to false, on-wiki configuration will be ignored.
$wgAutoModeratorEnableWikiConfig = true;
On-wiki configuration
[edit]To configure AutoModerator on a wiki, including enabling it to run, local configuration must also be completed at MediaWiki:AutoModeratorConfig.json
. For now, this must be done by directly editing the page, but in the future will incorporate Community Configuration for ease of configuring.
You'll need the editsitejson
right to edit MediaWiki:AutoModeratorConfig.json
, which is held by interface-admin
and
sysop
groups on most wikis. You can check Special:ListGroupRights on your wiki to be sure. If you wish to further limit editing, you may use page protection to do so.
Config | Description | Allowed values | Default if omitted |
---|---|---|---|
AutoModeratorEnableRevisionCheck | Enables or disables AutoModerator. If set to true, AutoModerator will begin running immediately after the page is saved. AutoModerator can be immediately disabled by setting this value to false. | true or false | false |
AutoModeratorFalsePositivePageTitle | The title of the page where people will go to report false positive reverts. | A string or a null if no false positive page exists. | null |
AutoModeratorSkipUserRights | AutoModerator will never check or revert edits made by accounts with one or more of these rights. | An array of strings that contains the user right names. | [ "bot", "autopatrol" ]
|
AutoModeratorUseEditFlagMinor | Boolean that enables the minor edit flag for all AutoModerator edits. | true or false | false |
AutoModeratorEnableBotFlag | Boolean that enables whether AutoModerator uses the Bot flag when making its edits. | true or false | false |
AutoModeratorRevertTalkPageMessageEnabled | Boolean that enables sending talk page messages informing the user that an edit has been reverted. | true or false | false |
AutoModeratorCautionLevel | Controls the caution level that AutoModerator uses when scoring edits. | A string from one of the following options: very-cautious, cautious, somewhat-cautious, or less-cautious. | very-cautious |
Example MediaWiki:AutoModeratorConfig.json
[edit]This example enables revision checks (and potential reverts) and explicitly sets some fields to the default value.
{
"AutoModeratorEnableRevisionCheck": true,
"AutoModeratorFalsePositivePageTitle": "Wikipedia:Automoderator False Positive Reporting",
"AutoModeratorSkipUserRights": [ "bot", "autopatrol" ],
"AutoModeratorUseEditFlagMinor" : true,
"AutoModeratorEnableBotFlag" : false,
"AutoModeratorRevertTalkPageMessageEnabled" : false,
"AutoModeratorCautionLevel" : "very-cautious"
}
This extension is being used on one or more Wikimedia projects. This probably means that the extension is stable and works well enough to be used by such high-traffic websites. Look for this extension's name in Wikimedia's CommonSettings.php and InitialiseSettings.php configuration files to see where it's installed. A full list of the extensions installed on a particular wiki can be seen on the wiki's Special:Version page. |