Extension:ImportUsers
|
ImportUsers Extension Release status: beta |
|
|---|---|
| Implementation | Special page, User identity, Database |
| Description | Import users in bulk from a CSV file. |
| Author(s) | Rouslan Zenetl, Yuriy Ilkiv |
| Last version | 1.2 (2011-03-22) |
| MediaWiki | 1.12 (see download link for versions below, back to 1.6.8) |
| License | No license specified |
| Download | Download snapshot Subversion [Help] |
|
Check usage (experimental) |
|
The ImportUser extension adds special page, Special:ImportUsers, which can be used by bureaucrat (or others who have 'import_users' right) to import users from a CSV file to MediaWiki's user database.
Contents |
[edit] Import File Format
The CSV file consists of four columns:
- username
- password
- real name
Delimited with commas. For example:
user1,pass1,user1@gmail.com,User One user2,pass2,user2@gmail.com,User Two user3,pass3,user3@gmail.com,User Three user4,pass4,user4@gmail.com,User Four user5,pass5,user5@gmail.com,User Five user6,pass6,user6@gmail.com,User Six . . . userN,passN,userN@gmail.com,User Nnn
[edit] Duplicate/Collision handling
ImportUsers extension will never create duplicate user accounts.
- What is account collision?
Two accounts are in collision (or are duplicates of each other) if their login names (user names) are equal.
Collision handling behavior is determined by the "Replace existing users" check box.
When "Replace existing users" check box is clear (unchecked), ImportUsers extension will ignore records in the input file which are duplicates of existing accounts.
When "Replace existing users" check box is checked, ImportUsers extension will update corresponding accounts with data from input file.
Note, that MediaWiki tolerates duplicate email addresses. In other words, there may be multiple accounts connected to the same email address. ImportUsers extension will not validate for duplicate email addresses.
[edit] Installation
- Download the source code, either via Special:ExtensionDistributor or directly from SVN
- Place the files in $IP/extensions/ImportUsers/
- Add
to your wiki's LocalSettings.php
require_once("$IP/extensions/ImportUsers/ImportUsers.php");
- Installation can now be verified through Special:Version on your wiki
[edit] License
You are free to use this extension for any reason and mutilate it to your heart's liking. If you feel your work might benefit others, post your changes here.
