====== userimportextended Plugin ======

---- plugin ----
description: Import users from CSV, including passwords. Set defaults to fill missing user data.
author     : Anna Dabrowska 
email      : dokuwiki@cosmocode.de
type       : admin
lastupdate : 2019-05-16
compatible : Greebo 
depends    : 
conflicts  : 
similar    : usermanager
tags       : users, import

downloadurl: https://github.com/cosmocode/dokuwiki-plugin-userimportextended/zipball/master
bugtracker : https://github.com/cosmocode/dokuwiki-plugin-userimportextended/issues
sourcerepo : https://github.com/cosmocode/dokuwiki-plugin-userimportextended/
donationurl: 

screenshot_img : 
----

===== Installation =====
[[https://www.cosmocode.de/en/open-source/dokuwiki-plugins/|{{ http://cosmocode.de/static/img/dokuwiki/dwplugins.png?recache|A CosmoCode Plugin}}]]

Install the plugin using the [[plugin:plugin|Plugin Manager]] and the download URL above, which points to latest version of the plugin. Refer to [[:Plugins]] on how to install plugins manually.

===== Examples/Usage =====

This plugin borrows heavily from the bundled User Manager, which already lets you import users from CSV.
However, sometimes you may have incomplete data that you would like to fill with defaults during import, not by editing the CSV file. Or you may want to import user passwords instead of auto-generating them.

Prepare a CSV file with at least five columns in the following order: user id, password, full name, email address and groups. The fields must be separated by commas (,) and strings should be delimited by quotation marks (%%""%%). Backslash (\) can be used for escaping.

Only the user id is required, all the other columns may be empty, so a minimal row looks like this:

<code>
username,,,,
</code>

Enter default values into the form: email, full name, and password are required. Groups are optional, and the default group "user" will be added automatically.

The defaults **will not** overwrite any values in the CSV file; they will only be inserted in place of missing pieces of user data.

Successfully imported users will receive the usual notification with their username and password.

===== Development =====

==== Commit-Ticker ====

{{rss>https://github.com/cosmocode/dokuwiki-plugin-userimportextended/commits/master.atom date}}

**Releases:**
{{rss>https://github.com/cosmocode/dokuwiki-plugin-userimportextended/releases.atom description author}}