Import File Format

The CSV file in UTF-8 without BOM encoding consists of four or five columns, delimited with commas:

1. username
2. password
3. email
4. real name
5. user groups (optional; if the user is a member of more than one group, put each group in its own column in the CSV file - do not embed them with commas in one column)

Be sure the CSV file has the correct line feeds. Files with Macintosh line feeds will process only the first line.

Example

user1,pass1,user1@example.org,John Doe
user2,pass2,user2@example.org,Jane Doe,editor
user3,pass3,user3@example.org,Jonnie Doe,editor,staff

Duplicate/Collision handling

This extension will never create duplicate user accounts. The "Replace existing users" check box determines collision handling behavior.

What is account collision?

If the login names (user names) of two accounts are equal, they are in collision (or are duplicates of each other).

What can be done?

• When the "Replace existing users" check box is clear (unchecked), the ImportUsers extension will ignore records in the input file that are duplicates of existing accounts.
• When the "Replace existing users" check box is checked, the ImportUsers extension will update the corresponding accounts with data from the input file.

 Note: MediaWiki tolerates duplicate email addresses. In other words, multiple accounts may be connected to the same email address. This extension will not validate for duplicate email addresses.