Extension:Username Blacklist

From MediaWiki.org
Jump to: navigation, search
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:

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:

[edit] See also

[edit] Resources on regular expressions

Personal tools
Namespaces
Variants
Actions
Site
Support
Download
Development
Communication
Toolbox