Extension:Username Blacklist

From MediaWiki.org

Jump to: navigation, search
Crystal Clear app error.png

This extension is obsolete!
It has been replaced by TitleBlacklist.


             

Manual on MediaWiki Extensions
List of MediaWiki Extensions
Crystal Clear action run.png
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 Download snapshot

Subversion [Help]
Browse source code

README

check usage (experimental)

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

Contents

[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 2007-03-13 Ignore non-list lines when generating blacklist
1.6 2007-01-15 Support multiple-language translations
1.5 2006-12-16 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 2006-06-19 Fix fatal error
1.3 2006-07-06 Cache blacklist in memcached or similar, if available
1.2 2006-04-25 Performance rewrite
Allow users with the uboverride permission to pass the blacklist
1.1 2006-03-08 Make compatible with MediaWiki 1.5.8
Allow commenting out lines with #
1.0 2006-01-09 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

This extension is being used on one or more of Wikimedia's wikis. It 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 is produced by Special:Version on that wiki.