Open main menu


MediaWiki extensions manual
OOjs UI icon advanced.svg
Release status: stable
Implementation Page action
Description Uses to prevent spam
Author(s) Legoktm, Skizzerz
Latest version 0.3.0 (2019-02-07)
MediaWiki 1.23+
Database changes No
License GNU General Public License 2.0 or later
  • $wgSFSAPIKey
  • $wgSFSIPListLocation
  • sfsblock-bypass
Translate the StopForumSpam extension if it is available at
Check usage and version matrix.
Issues Open tasks · Report a bug

The StopForumSpam extension allows wikis to utilize and contribute data to It features automatic IP blocking and an easy interface for administrators to submit data. Use of the IP blacklist requires that you use some kind of object caching; it won't work if you have $wgMainCacheType set to CACHE_NONE. If neither APC or Memcached is an option, the simplest approach is to fallback to storing the object cache in your MySQL database. The following preset (in LocalSettings.php) will do that: $wgMainCacheType = CACHE_DB;


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

Configuration parametersEdit

  • $wgSFSIPListLocation - location of an unzipped IP address blacklist

User rightsEdit

  • sfsblock-bypass - allows users to bypass blacklisted IP blocks

AbuseFilter integrationEdit

When using the AbuseFilter, a variable named "sfs_blocked" is added. The value is false if the user is not a spammer, and true if they are a spammer.

IP blockingEdit

You can download IP blacklists, and import them using the maintenance/updateBlacklist.php script. StopForumSpam has several lists; we recommend using the "listed_ip_30_all" list. Once you choose the list you want, download and extract it to somewhere on your server, then point $wgSFSIPListLocation in the LocalSettings.php file at it. We recommend setting up a nightly cron job to download and extract new versions of the list and subsequently running the updateBlacklist maintenance script.

If that IP tries to edit, or a user tries to edit through that IP address, they will be prevented from editing. To exempt a user from being blocked, give them the sfsblock-bypass user right.