Extension:RegexBlock
Appearance
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) |
|
Latest version | 1.7 (2019-05-08) |
MediaWiki | 1.43 |
Database changes | Yes |
License | GNU General Public License 2.0 or later |
Download | |
|
|
|
|
Quarterly downloads | 3 (Ranked 127th) |
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
[edit]This extension works best when used along with setting shared database and memcached .
- Download and move the extracted
RegexBlock
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/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 thestaff
user group (which does not exist in a default MediaWiki installation). For example, this could be given to thesysop
group:
$wgGroupPermissions['sysop']['regexblock'] = true;
- Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.
User rights
[edit]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
[edit]- Go to
Special:RegexBlock
- Enter the IP address or the username to be blocked to the "IP address or username" field
- Enter an optional reason. If no reason is provided by the blocker, a generic reason will be shown to the blocked user.
- Select expiry time
- Select if you want to block the creation of new accounts and if the match needs to be exact or regex one
- Press "Block this user"
Parameters
[edit]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
[edit]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
[edit]- 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.
Categories:
- Stable extensions
- User rights extensions
- Special page extensions
- GPL licensed extensions
- Extensions in Wikimedia version control
- Extensions which add rights
- ContributionsToolLinks extensions
- GetUserBlock extensions
- LoadExtensionSchemaUpdates extensions
- All extensions
- Extensions by Fandom
- Extensions by ShoutWiki