====== User Manager Plugin ======

---- plugin ----
description: Manage registered users (bundled with DokuWiki)
author     : Christopher Smith
email      : chris@jalakai.co.uk
type       : admin, cli
lastupdate : 2023-04-04
compatible : (bundled)
depends    : 
conflicts  : 
similar    : 
tags       : management, users, listing, !bundled
screenshot_img: plugin:usermanager.png
----

This plugin allows wiki admins to manage their registered users. It provides facilities for:

  * adding new users
  * editing existing users, including changing group memberships
  * deleting users

{{ :plugin:usermanager.png?350|}}

The user manager works with a variety of different authorization backends, they tell it whether certain functions (e.g. user editing) are available and it adjusts its user interface accordingly. At present the user manager does not provide any validation of data used to create new users or modify existing users.

The management of access control lists for individual pages and namespaces are handled by the [[acl|ACL plugin]].  

===== Usage =====

The User Manager is accessible from the admin screen (Login as superuser, click "Admin" and choose "{{https://raw.githubusercontent.com/dokuwiki/dokuwiki/master/lib/plugins/usermanager/admin.svg?14}} User Manager").

Add an user by filling the ''Add User'' form. Be sure you provided a password or check ''Notify user'' checkbox, otherwise addition fails.

Editing an user can be done in the ''Edit User'' form that appears when you click on the username in the User List.

===== Reporting Issues =====

As the User Manager is a bundled plugin, please report your issues and feature request on the Bug tracker of DokuWiki: https://github.com/dokuwiki/dokuwiki/issues. 


=====FAQ=====

=== Why can I not edit users? ===

Check the permissions of the file conf/users.auth.php. It needs to be writable for your webserver. This can be checked by adding ''?do=check'' to url.

Also make sure your auth backend actually supports editing users.

=== Can I give non-superusers access to usermanager? ===

Not by configuration. Since this plugin allows changing groups, this would allow a manager to gain additional permissions, eg. by adding themselves into the admin group.

The plugin [[plugin:usermanagerextended]] does give [[config:manager|managers]] restricted access, while preventing them from modifying superusers or escalating privileges.

=== How do I change the content of registration mail?===

Copy ''inc/lang/en/registermail.txt'' to ''conf/lang/en/registeredmail.txt'' and modify it. See for more info [[:localization#changing_some_localized_texts_and_strings_in_your_installation|Changing localized texts in your installation]].