Extension:RegexBlock

MediaWiki extensions manual

RegexBlock Release status: stable
Implementation	User rights , Special page
Description	Adds a new special page for blocking, viewing and unblocking user names and IP addresses by given name, using regular expressions
Author(s)	Bartek Łapiński Tomasz Klim Piotr Molski Adrian Wieczorek Alexandre Emsenhuber Jack Phoenix
Latest version	1.7 (2019-05-08)
MediaWiki	1.39+
Database changes	Yes
License	GNU General Public License 2.0 or later
Download	Download extension Git [?]: Download Git master browse repository (Phabricator · GitHub) commit history repository contributors (GitHub) code review
Parameters $wgRegexBlockDatabase $wgContactLink
Added rights regexblock regexblock-exempt
Hooks used ContributionsToolLinks GetUserBlock LoadExtensionSchemaUpdates
Quarterly downloads	5 (Ranked 128th)
Public wikis using	1,108 (Ranked 254th)
Translate the RegexBlock extension if it is available at translatewiki.net
Issues	Open tasks · Report a bug

RegexBlock is an extension that adds special page with the interface for blocking, viewing and unblocking user names and IP addresses using regular expressions. It was originally written by Bartek Łapiński for Fandom .

Installation

This extension works best when used along with setting shared database and memcached .

• Download and move the extracted RegexBlock folder to your extensions/ directory.
  Developers and code contributors should install the extension from Git instead, using:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/RegexBlock
• Add the following code at the bottom of your LocalSettings.php file:

  wfLoadExtension( 'RegexBlock' );
  

• Run the update script which will automatically create the necessary database tables that this extension needs.
• Ensure that the regexblock user right is given to a group that exists; by default this user right is given to the staff user group (which does not exist in a default MediaWiki installation). For example, this could be given to the sysop group:

$wgGroupPermissions['sysop']['regexblock'] = true;

•  Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

User rights

User right name	Group which is given this right by default	Description
regexblock	staff	User right required to view and thus use Special:RegexBlock for managing blocks.
regexblock-exempt	staff	Users who have this right are exempt from RegexBlock blocks.

Use

1. Go to Special:RegexBlock
2. Enter the IP address or the username to be blocked to the "IP address or username" field
3. Enter an optional reason. If no reason is provided by the blocker, a generic reason will be shown to the blocked user.
4. Select expiry time
5. Select if you want to block the creation of new accounts and if the match needs to be exact or regex one
6. Press "Block this user"

Parameters

Configuration variable name	Default value	Description
$wgContactLink	Special:Contact	Displayed to regexblocked users in the regexblock-reason-* interface messages. You might want to customize it if the ContactPage extension isn't installed on your wiki.
$wgRegexBlockDatabase	false	Set this to the database to use for blockedby and stats_blockedby tables. If you want to use the local database, set this to false. Otherwise you could set this to $wgSharedDB , for example.

Examples

To block all users except local ones (192.168.xx.xx): \b(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[01]?([0]|[2-9])[0-9]?)\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\b

See also

• Extension:SpamRegex — a similar extension for blocking expressions in page content (etc.) using regular expressions
• Extension:TitleBlacklist
• BulkBlock Extension — an extension that allows administrators to easily block multiple users at once on a MediaWiki website.