MediaWiki extensions manual
OOjs UI icon advanced.svg
Release status: stable
SpamDiffTool Screenshot.png
Implementation User activity , Page action
Description Allows privileged users to add entries to the spam blacklist right off of a diff page
Author(s) Travis Derouin
Alexandre Emsenhuber
Jack Phoenix
Latest version 1.1 (2016-12-14)
MediaWiki 1.34+
License GNU General Public License 2.0 or later
Translate the SpamDiffTool extension if it is available at translatewiki.net
Check usage and version matrix.

The SpamDiffTool extension allows users to add URLs to the Spam Blacklist easily without learning how to format entries for the blacklist and copy and paste, etc. By inserting a link on each diff page, if an editor sees that a given page has been the victim of spam, they can click on "add to spam", which extracts all of the URLs the spammer has placed on the page, going back over their most recent edits on the article (similar to Rollback). Then, for each URL detected, the tool prompts the user the degree to which they want to blacklist the URL. The options are block:

  1. all links from the domain
  2. all links from the specific subdomain
  3. all links from the subdirectory and subdomain
  4. nothing - don't add this to the blacklist

The idea is to try to streamline the process of cleaning up spam, rolling back spam edits and blocking users. When the spam addition process is finished, the user is taken back to the diff page they were on to begin with. From there, they can rollback the edits as required.

As of November 9, 2006 this tool has been running for a few weeks on wikiHow, and made the lives of some admins much easier. Future versions might include the ability to block the user while adding the links to the spam blacklist, and rolling back the edits all at once.


Copyright 2006 Travis Derouin

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA


This extension was tested with MediaWiki 1.34. You must have the SpamBlacklist extension already installed for this extension to do anything, because this is merely a more graphical, easier-to-use front-end for the functionality provided by SpamBlacklist.


  • Download and place the file(s) in a directory called SpamDiffTool in your extensions/ folder.
  • Add the following code at the bottom of your LocalSettings.php:
    wfLoadExtension( 'SpamDiffTool' );
  •   Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.


To specify which article you use as a Spam Blacklist, change the $wgSpamBlacklistArticle variable in your wiki's LocalSettings.php. The default is to use the page called Project:Spam Blacklist.

Bugs and enhancementsEdit

Bugs or feature requests can be sent via Phabricator. There is a good chance the regular expressions are not 100% perfect.

See alsoEdit