Extension:SmiteSpam

From mediawiki.org
MediaWiki extensions manual
SmiteSpam
Release status: stable
Implementation Special page , API
Description Provides a special page helping administrators identify and delete spam
Author(s) Vivek Ghaisas (Polybuildrtalk)
Latest version 0.5 (January 2024)
MediaWiki 1.36+
Database changes Yes
Composer mediawiki/smitespam
Tables smitespam_trusted_user
License GNU General Public License 2.0
Download
  • $wgSmiteSpamThreshold
  • $wgSmiteSpamCheckers
  • $wgSmiteSpamIgnoreSmallPages
  • $wgSmiteSpamQueryPageSize
  • $wgSmiteSpamIgnorePagesWithNoExternalLinks
  • $wgSmiteSpamDisplayPageSize
  • smitespam
Quarterly downloads 5 (Ranked 145th)
Translate the SmiteSpam extension
Issues Open tasks · Report a bug

The SmiteSpam extension provides a special page "Special:SmiteSpam" helping administrators identify and delete spam pages.

Usage[edit]

Navigate to "Special:SmiteSpam" in order to run the analyzer and get a list of pages that the extension identifies as spam. You can use the interface to block users, delete pages created by them or trust a user you know to be good contributors.

The list of trusted users can be viewed and edited at "Special:SmiteSpamTrustedUsers".

Download[edit]

You can download the SmiteSpam code, in .zip format, here:

https://github.com/wikimedia/mediawiki-extensions-SmiteSpam/archive/0.5.zip

You can also download the code directly via Git from the MediaWiki source code repository (see available tags). From a command line, you can call the following:

git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/SmiteSpam

To view the code online, including version history for each file, go here.

Installation[edit]

To install the extension, place the entire 'SmiteSpam' directory within your MediaWiki 'extensions' directory, then add the following line to your 'LocalSettings.php' file:

wfLoadExtension( 'SmiteSpam' );

Once you have the code set up, SmiteSpam has a database table, "smitespam_trusted_user", that must be created. You will need to create it by going to MediaWiki's /maintenance directory and calling the following:

php update.php

Configuration[edit]

User right[edit]

By default, this extension can only be used by sysops. You can change it: e.g. let also bureaucrats use it by adding the following line to your "LocalSettings.php" file.

$wgGroupPermissions['bureaucrat']['smitespam'] = true;

Parameters[edit]

Parameter Default Value Comment
$wgSmiteSpamThreshold 0.7 Pages analyzed as having a spam "probability" higher than this will be shown on special page.
$wgSmiteSpamIgnoreSmallPages true Should SmiteSpam ignore pages smaller than 500 characters?
$wgSmiteSpamIgnorePagesWithNoExternalLinks true Should SmiteSpam ignore all pages that don't have any external links outside of template calls?
$wgSmiteSpamQueryPageSize 500 Number of pages to analyze in one AJAX request. (Setting this too high can cause timeouts.)
$wgSmiteSpamDisplayPageSize 250 Number of pages to display in one paginated page.

$wgSmiteSpamCheckers is a parameter that lets you choose which "checkers" you want to run and how much weight (value) you want to give to each of their reports.

By default, this is set to:

$wgSmiteSpamCheckers = [
	'ExternalLinks' => 1,
	'RepeatedExternalLinks' => 1,
	'Wikitext' => 1,
];

Checkers[edit]

ExternalLinks

Checks how much of the text (ratio) is external links.

RepeatedExternalLinks

Checks whether there are repeated external links.

Wikitext

Checks how much wikitext is there in the contents of the page.

Version history[edit]

The version history for this extension is:

  • 0.1 - September 6, 2015 - Initial version
  • 0.2 - March 14, 2020 - extension.json added; support removed for MW < 1.29; submit button added to bottom of form in Special:SmiteSpam; fixed select all/none to also account for pages created by blocked users; added special page links to Extension:AdminLinks interface; files rearranged
  • 0.3 - April 20, 2020 - Renamed $wgQueryPageSize and $wgDisplayPageSize variables to $wgSmiteSpamQueryPageSize and $wgSmiteSpamDisplayPageSize, respectively; more file rearranging
  • 0.4 - August 3, 2022 - Removed SmiteSpam.php; support removed for MW < 1.35; support added for MW >= 1.37
  • 0.5 - January 31, 2024 - Support removed for MW < 1.36; deprecated functions replaced

Screenshots[edit]

Special:SmiteSpam[edit]

An example of a SmiteSpam page that a user may be first greeted with.

Special:SmiteSpamTrustedUsers[edit]

An example of a SmiteSpam Trusted Users page.