Extension:Username Blacklist

From MediaWiki.org

Manual on MediaWiki Extensions
List of MediaWiki Extensions

Username Blacklist Release status: stable
Implementation	User identity
Description	Block the creation of user accounts matching a regular expression blacklist
Author(s)	Rob Church
Last Version	1.7.1 (2008-02-08)
MediaWiki	1.5.8+
License	No license specified
Download	from Subversion README
Added rights	uboverride
Hooks used	EditFilter AbortNewAccount ArticleSaveComplete

The Username Blacklist extension allows wiki administrators to block the creation of user accounts where the username matches one or more regular expressions.

Contents 1 Requirements 2 Installation 3 Editing the blacklist 4 Customising warning messages 5 Change log 6 Acknowledgements 7 See also 7.1 Resources on regular expressions

[edit] Requirements

The Username Blacklist extension requires MediaWiki 1.5.8 or above.

[edit] Installation

1. Check out all extension files from Subversion and place them in a UsernameBlacklist subdirectory within your MediaWiki extensions directory
2. Add the line require_once( "{$IP}/extensions/UsernameBlacklist/UsernameBlacklist.php" ); to your LocalSettings.php file

Installation can be verified through the Special:Version page on the wiki.

[edit] Editing the blacklist

The username blacklist is maintained as a message page called "usernameblacklist", which can be found at MediaWiki:Usernameblacklist.

The page is formatted as a bulleted list using the asterisk (*) token, where each blocked username or regular expression exists as a single list item, for example:

• Foo
• [Bb]ar

Lines without the list token will be ignored when constructing the final regular expression, which allows for adding comments or other explanation to the page.

[edit] Customising warning messages

When an attempt to create an account is blocked due to a blacklisted username, a warning message is shown to the user. This can be customised via messages:

MediaWiki:Blacklistedusername 

Heading

MediaWiki:Blacklistedusernametext 

Explanation

[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	Release Date	Comments
1.7	13/03/2007	Ignore non-list lines when generating blacklist
1.6	15/01/2007	Support multiple-language translations
1.5	16/12/2006	Don't block all usernames when the blacklist contains blank lines Use Unicode-friendly regular expressions Don't show errors when the blacklist contains only comments (above fixes from Brion Vibber)
1.4	19/06/2006	Fix fatal error
1.3	06/07/2006	Cache blacklist in memcached or similar, if available
1.2	25/04/2006	Performance rewrite Allow users with the uboverride permission to pass the blacklist
1.1	08/03/2006	Make compatible with MediaWiki 1.5.8 Allow commenting out lines with #
1.0	09/01/2006	Initial version

[edit] Acknowledgements

The extension author would like to thank:

• The poster on mediawiki-l who inspired creation of the extension
• Ævar Arnfjörð Bjarmason (extension code reference)
• Brion Vibber (UTF-8 and other bug fixes)
• The volunteer MediaWiki internationalisation team, who provided dozens of translations

[edit] See also

[edit] Resources on regular expressions

• Brief Introduction to Regular Expressions

  http://etext.lib.virginia.edu/services/helpsheets/unix/regex.html

• The 30 Minute Regex. Tutorial

  http://codeproject.com/dotnet/RegexTutorial.asp