Extension:TitleBlacklist
|
Title Blacklist Release status: stable |
|||
|---|---|---|---|
| Implementation | User rights, API | ||
| Description | Block the creation of pages matching a regular expression blacklist | ||
| Author(s) | VasilievVV | ||
| Last version | v1.4.2 (2008-08-05) | ||
| MediaWiki | 1.12.0+ | ||
| License | No license specified | ||
| Download | Download snapshot Subversion [Help] |
||
|
|||
|
|||
|
Check usage (experimental) |
|||
The Title Blacklist extension allows wiki administrators to block the creation, movement and upload of pages which title matches one or more regular expressions, as well as blocking creation of accounts with matching usernames.
Contents |
[edit] Requirements
Extension requires MediaWiki 1.12.0 or above (it needs AbortMove hook).
[edit] Installation
- Check out all extension files from Subversion and place them in a TitleBlacklist subdirectory within your MediaWiki extensions directory
- Add the line
to your LocalSettings.php file
require_once( "{$IP}/extensions/TitleBlacklist/TitleBlacklist.php" );
- Configure blacklist sources (see below)
Installation can be verified through the Special:Version page on the wiki.
Note: By default it only affects non-sysop users. To make it default for all use $wgGroupPermissions['sysop']['tboverride'] = false;.
[edit] Multiple blacklist sources
Title blacklist can be gathered from multiple sources except local message. For configuring blacklist sources use code like this:
$wgTitleBlacklistSources = array( array( 'type' => TBLSRC_LOCALPAGE, 'src' => 'MediaWiki:Titleblacklist', ), array( 'type' => TBLSRC_URL, 'src' => 'http://meta.wikimedia.org/w/index.php?title=Title_blacklist&action=raw', ), array( 'type' => TBLSRC_FILE, 'src' => '/home/wikipedia/blacklists/titles', ), );
- Use TBLSRC_LOCALPAGE for using local page as title blacklist
- Use TBLSRC_URL for using external URL as title blacklist
- Use TBLSRC_FILE for using file as title blacklist
[edit] Editing the blacklist
The title blacklist is maintained as a system message MediaWiki:Titleblacklist.
This page consists of regular expressions, each on a separate line, for example:
Foo <autoconfirmed|noedit|errmsg=blacklisted-testpage> [Bb]ar #No one should create article about it
Each entry may also contain optional attributes, enclosed in <> and separated with |
- autoconfirmed - only autoconfirmed users are able to create/upload/move such pages
- casesensitive - don't ignore case when checking title for being blacklisted
- noedit - users are also unable to edit this article
- moveonly - forbid moves but allow ordinary creation (rev:35163)
- newaccountonly - forbid creation of matching usernames, but allow page creation (rev:38977)
- reupload - allow reuploads of existing blacklisted files (rev:33656)
- errmsg - the name of the message that should be displayed instead of standard
Note that what is referred to here as regular expressions are not proper regular expressions, but rather subpatterns that are inserted into a hard-coded regular expression. i.e. the subpattern Foo from above would create a regular expression like /^Foo$/usi.
Underscores ("_") in regular expressions will be converted to spaces by the extension, because titles are matched against its text form ("Page title" instead of "Page_title").
[edit] Whitelist
There is also a whitelist at MediaWiki:Titlewhitelist. The blacklist is applied first, then the whitelist. So user input that matches an entry on the blacklist is blocked, except if it matches an entry on the whitelist. You don't have to configure anything in LocalSettings.php in order to use the whitelist. Some of the optional attributes listed above, for the blacklist, also work for the whitelist, e.g. casesensitive.
[edit] Customising warning messages
When an attempt to create a page is blocked due to a blacklisted title, a warning message is shown to the user. This can be customised via system messages
- MediaWiki:Titleblacklist-forbidden-edit: for page creation and editing,
- MediaWiki:Titleblacklist-forbidden-move: for page moves,
- MediaWiki:Titleblacklist-forbidden-upload: for image uploads.
- MediaWiki:Titleblacklist-forbidden-new-account: for new accounts
Custom messages can be defined by using the errmsg attribute.
[edit] Using TitleBlacklist to control user account creation
[edit] Conceptual overview
The username for new accounts will be regarded by Titleblacklist differently to the way it regards new articles. Titleblacklist will prepend "User:" (or it's local equivalent) to the string that a user enters at Username on the create account page. So when Titleblacklist is performing matches with your Regex's, as found on MediaWiki:Titleblacklist or MediaWiki:Titlewhitelist, it will match against "User:" + <userinput>.
For example, imagine you want to block "jill" as a new user. Imagine you had a blacklist regex "jill.* <newaccountonly>" and a user enters "jill" as the username on the create account page. This will pass as the comparison Titleblacklist will make will be between "jill.*" (the regex) and "User:jill" (the constructed input string). These don't match and so "jill" is allowed (and you probably didn't intend this). To effect the intended block use a regex like ".*jill.* <newaccountonly>" or "User:jill.* <newaccountonly>" on MediaWiki:Titleblacklist.
If you want to block all users except for all those that do match a regex then block all users in MediaWiki:Titleblacklist and write the permissible regex in the MediaWiki:Titlewhitelist.
[edit] A working example
If you would like to force all usernames, during account creation, to consist of exactly two names, space seperated, with each name capitalized then do the following:
1. Install TitleBlacklist.
2. Add the following to your LocalSettings.php
require_once( "{$IP}/extensions/TitleBlacklist/TitleBlacklist.php" ); // Apply to all, not just anonymous users. $wgGroupPermissions['sysop']['tboverride'] = false; $wgTitleBlacklistSources = array( array( 'type' => TBLSRC_LOCALPAGE, 'src' => 'MediaWiki:Titleblacklist' ) );
3. In https://www.example.com/mywiki/MediaWiki:Titleblacklist add
# Block all user accounts, and only permit those that match the MediaWiki:Titlewhitelistregex .* <newaccountonly>
4. In https://www.example.com/mywiki/MediaWiki:Titlewhitelist add
# Only allow two names, seperated by a space, with each name capitalized. E.g "Fred Mew" OK, "Fred mew" fails, "Fredmew" fails. # Depends on .* <newaccounonly> in blacklist User:[A-Z][a-z]+\s[A-Z][a-z]+ <casesensitive>
5. In https://www.example.com/mywiki/MediaWiki:Titleblacklist-forbidden-new-account edit
The user name "$2" has been blocked from creation.It matches the following blacklist entry: <code>$1</code>. Please use a real name for the user name. User names need to be comprised of two names separated by a space. Each name must be capitalised.<br /> E.g.: * "Mary Smith". OK. * "MarySmith". Invalid. * "Mary smith". Invalid. * "marysmith". Invalid. User name creation (and article creation) blocking rules are controlled by [[MediaWiki:Titleblacklist]] and [[MediaWiki:Titlewhitelist]]. This message can be customised at [[MediaWiki:Titleblacklist-forbidden-new-account]]
[edit] Change log
A complete log of changes to the extension code (including internationalisation updates from third parties) is available from the Subversion log, however, summarised information on changes between point releases is given below:
| Version | Revision | Release Date | Comments |
|---|---|---|---|
| 1.4.2 | 38636 | 2008-08-05 | |
| 1.4.1 | 31074 | 2008-02-18 | |
| 1.4 | 28866 | 2007-12-26 | |
| 1.3 | 28657 | 2007-12-19 | Check for blacklist validity before saving |
| 1.2 | 28504 | 2007-12-15 | Cleaned up version with caching support |
| 1.1 | 28362 | 2007-12-10 | New version with support of entry attributes and multiple sources |
| 1.0 | 27208 | 2007-11-05 | Initial version |
[edit] Resources on regular expressions
- Brief Introduction to Regular Expressions
- The 30 Minute Regex. Tutorial
- PHP: PCRE regex syntax, the syntax of regular expressions used by PHP — and therefore this extension
|
|
This extension is being used on one or more of Wikimedia's wikis. This means that the extension is stable and works well enough to be used by such high traffic websites. A full list of the extensions installed on a particular wiki can be seen on the wiki's Special:Version page. |
[edit] See also
| Language: | English • 日本語 |
|---|
- Stable extensions
- User rights extensions
- API extensions
- Extensions with no license specified
- Extensions in Wikimedia version control
- Extensions which add rights
- GetUserPermissionsErrorsExpensive extensions
- AbortMove extensions
- AbortNewAccount extensions
- AbortAutoAccount extensions
- EditFilter extensions
- ArticleSaveComplete extensions
- UserCreateForm extensions
- All extensions
- 2012 Q1 Extension Page Review Drive
- Extensions used on Wikimedia