====== User Manager Plugin ====== ---- plugin ---- description: Manage registered users (bundled with DokuWiki) author : Christopher Smith email : chris@jalakai.co.uk type : admin lastupdate : compatible : (bundled) depends : conflicts : similar : tags : management, users, listing, !bundled ---- 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 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]] plugin. ===== Download and Installation ===== The plugin is bundled with DokuWiki and does not need to be installed separately. The User Manager is accessible from the admin screen (Login as superuser, click "Admin" and choose "User Management"). ===== Usage ===== FIXME ===== Development ===== A big thanks to [[neolao@neolao.com|neolaoo]] for his user manager - this is a heavily modified version of that plugin. The first release was 2005-10-21 and the plugin has been included in DokuWiki release since 2006-03-05. ==== Source Code ==== The source code is available from [[devel:Git]] at [[http://github.com/splitbrain/dokuwiki/tree/master/lib/plugins/usermanager/|Dokuwiki source repository]]. ==== To Do ==== * (possibly) add data validation * add support for auth_group functions (rather than through user modification) ==== Bugs ==== Submit bugs and feature wishes in the DokuWiki [[:bugs|Bugtracker]]. ===== Discussion ===== Is there a way to see all contributions by a user with this plugin (or another)? > Not with this plugin. And not to my knowledge in any other way. --- //[[chris@jalakai.co.uk|Christopher Smith]] 2006-01-10 10:27// Seems the jabber interface isn't working on the bug site so I'll add my bug here and hope you can move it if its a real bug. Clicking on the icon to edit a user only brings me to the main website and not edit the user. * This seems to be a problem with a plugin. Try do deinstall the database-plugin. Worked for me :-) > Can you supply any more information, e.g. version details for DokuWiki, Webserver, PHP & OS. Do other admin plugins work? Do you have access to your PHP error log, does it have any messages related to this? --- //[[chris@jalakai.co.uk|Christopher Smith]] 2006-03-14 11:58// What this mean? This version of the user manager has been modified to only work with objectified version of auth system. I have setup /etc/dokuwiki $conf['useacl'] = 1; $conf['openregister'] = 1; $conf['superuser'] = '@admin'; $conf['authtype'] = 'plain'; $conf['autopasswd'] = 1; $conf['passcrypt'] = 'smd5'; but still got plugin message: (user authentication not available) and invalid auth mechanism I use Debian(Knoppix) DokuWiki (snapshot 0.0.20050922-4). > This user manager only works with the recent release of DokuWiki, 20060305 and later. The authorization mechanism has been heavily updated since 20050922, without those changes this user manager won't work. The original [[http://resources.neolao.com/php/dokuwiki/plugin_usermanager|user manager by Neolao]] does work with the 20050922 version and the plain backend. --- //[[chris@jalakai.co.uk|Christopher Smith]] 2006-03-20 19:57// >>I'm using the actual plug-in, because we're still using the 2005-09 release. It "sort of" works for me, in that it does actually allow me to edit a user's groups, but it also gives me a mountain of errors. They are; Warning: file(C:\\\data\meta/people/dave.mcneill_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin.mlist): failed to open stream: No error in C:\\\inc\common.php on line 1094 Warning: array_search(): Wrong datatype for second argument in C:\\\inc\common.php on line 1095 Warning: file(C:\\\data\pages/people/dave.mcneill_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin.txt.lock): failed to open stream: No error in C:\\\inc\io.php on line 45 Warning: join(): Bad arguments. in C:\\\inc\io.php on line 45 Warning: file(C:\\\data\pages/people/dave.mcneill_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin_do_admin.txt.lock): failed to open stream: No error in C:\\\inc\io.php on line 45 Warning: join(): Bad arguments. in C:\\\inc\io.php on line 45 Warning: Cannot modify header information - headers already sent by (output started at C:\\\inc\common.php:1094) in C:\\\lib\plugins\usermanager\admin.php on line 77 Warning: Cannot modify header information - headers already sent by (output started at C:\\\inc\common.php:1094) in C:\\\inc\actions.php on line 103 >>There appears to be a problem with recursion. Could I be using it incorrectly? I selected a user from the dropdown and clicked the Edit button. I added another group, so that it said "group1, group2", and clicked the Edit button again, since there wasn't a Save button. That's when I got the errors, but it //did// add the new group to the user. It does essentially the same thing when I remove a group from a user. The problem occurs with any user, not just one, and I have to navigate away from the wiki and come back to it to get the errors to clear out. >>Another possibility I thought of is that it's conflicting with another plugin. I'm using several. Or, could the file permissions being wrong cause this? Any assistance would be appreciated. --- //[[david.mcneill@ge.com|DGM2]] 2006-04-19 01:58// >>>I can't really help. You are talking about the original user manager plugin by NeoLao and the link for that one seems to have gone. This plugin is heavily revised and no longer bares much resemblance to NeoLao's, the underlying auth system has been rewritten too. It really would be worth updating your DokuWiki installation. --- //[[chris@jalakai.co.uk|Christopher Smith]] 2006-04-19 03:37// ---- I can't get at this plugin either. I'm not really sure what's going on. I finally had the install working today, my start page was Set up, I was adding a new page, and then when I hit Save everything was gone. I see their text files in my directories, but the start page just says it's not there and docheck isn't doing its thing either. I have a login button that does nothing when I hit it. Doesn't seem to matter at this point if I have ACL off or on. I just go in circles. >I have the manual list running, and everything is working fine (including me being superuser), but I don't see the admin button. Can I get there in another way? --- //[[dschulte@informationexperts.com|dschulte]] 2006-04-27 12:49// >> No. To access DokuWiki's admin menu you need to be logged in as the superuser. If you have a current version of DokuWiki I don't know why it is not showing. I have an [[http://wiki.jalakai.co.uk/dokuwiki/doku.php/tutorials/installer|installer]] under development which will configure a new DokuWiki installation with a superuser and ACL. You are welcome to use it, however for security reasons it will only work on a brand new install. So if you have an existing wiki, you may need to make a new installation and then move across your wiki data directory tree. --- //[[chris@jalakai.co.uk|Christopher Smith]] 2006-04-27 22:11// >Yeah, getting authentication set up is a bear. Make sure you have a //**writable**// users.auth.php and that there's at least one entry in it that isn't commented out. That one got me. The "nothingness" you're seeing may be due to having everything locked down, with no one having Read permissions. --- //[[david.mcneill@ge.com|DGM2]] 2006-04-19 02:16// >> What version of PHP and DokuWiki are you running? Often problems with non-appearance of pages, particularly the admin pages are due to a fatal PHP error occurring somewhere. This results in the top half of the template being shown but no content beyond the''
, where the template calls back to DokuWiki for the page content to be determined and displayed. If you can identify the error (check your PHP error logs or turn them on and direct their output to a file if you can), please file a [[bugs|bug report]]. --- //[[chris@jalakai.co.uk|Christopher Smith]] 2006-04-19 03:37// > I am a new admin of the system. Looks good, but another wrinkle I have just noted. I copied files around after the effect (set up the system as anonymous before boss saying to put in authentication), caused me a headache. Web server running as user 'apache', but the two auth files copied as root. As an admin, I could view the users, but not add. No immediate idea of why this was, until I started reading through the page and saw DGM2's comments. Changing the permissions/owner made the add user facility appear. Although clever, it would seem daft that you can happily use the page yet the system does not have correct RW permissions to the files, or warn you of the fact. --- //[[christian.chapman@esendex.com|Christian Chapman]] 2006-04-19 14:45// >> Can you please file a {{bug>}} report. This isn't as straight forward as it sounds. 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. Thanks. --- //[[chris@jalakai.co.uk|Christopher Smith]] 2006-04-20 03:02// >>> For people who had trouble with the PHP5 and the plugin: >>>\\ I am using: >>>\\ * Debian Sarge: 2.6.8-3-k7 >>>\\ * PHP 5.1.4-1.dotdeb.1 (cli) (built: May 4 2006 10:51:31) >>>\\ * And the last DokuWiki available: 2006-03-09 >>>\\ * I made the installation through the normal step as the package available for Debian seems causing trouble. >>>\\ >>>\\ Otherwise, to have the "admin" button available, >>>\\ Just make sure: >>>\\ in ./conf/local.php: >>> $conf['authtype'] = 'plain'; $conf['passcrypt'] = 'smd5'; $conf['defaultgroup']= 'user'; $conf['superuser'] = '@admin'; >>>\\ >>>\\ in ./conf/users.auth.php >>> # users.auth.php # # Don't modify the lines above # # Userfile # # Format: # # user:MD5password:Real Name:email:groups,comma,seperated test:"passwordtestcrypted":test:test@localhost:admin >>>\\ Logout if you are logged and login again, and the button should have appeared. >>>\\ >>>\\ And just make sure that your 2 files in ./conf >>>\\ acl.auth.php and users.auth.php are set-up with the correct user and group: www-data.www-data >>>\\ >>>\\ --- //[[aurele.langevin@gmail.com|Aurele]] 2006/05/05 22:28// I don't know if it's just me or something with the plugin but I just upgraded to 2006-03-09. I have no problem seeing the Admin button... however, my problem lies in the " editing existing users, including changing group memberships"... I can't see how to edit a user and change group memberships. The only option I appear to have is to delete a user. Am I just brain dead? (also, it might be beneficial to extend this plugin to be user/group management... You could allow the easy addition of adding a group and assigning memberships via a simple interface of selecting a group and seeing who the members are) > There should be a little icon to the right of the check box - hover over that and it should give a title tooltip "Edit this user". Click it to get an edit form. Yes a group manager is on the cards - although I don't believe one has been started yet - so feel free ... ;-) --- //[[chris@jalakai.co.uk|Christopher Smith]] 2006-05-22 20:20// >> Ah, yes... this would be a classic example of the I-D-ten-T error. If I thought my rudimentary coding skill were up to snuff, I'd try it... =G= >>> Maybe, but more likely its a manifestation of [[Google>mystery meat navigation]] and should be changed. --- //[[chris@jalakai.co.uk|Christopher Smith]] 2006-05-23 01:28// > I had the same problem, no option to edit a user: fixed it changing permissions on file conf/users.auth.php. --- //[[mcarlevaro@mc-it.biz|Marcos Carlevaro]] 2011-08-18.// I think you should change the user administration. I would be nice if on "Add a user" and "Edit this user" there is a listbox or even better a drop-down list, showing all available groups. I mean in some cases you don't know which groups are available e.g. group without a user or group is currently not shown in usersearch and if you didn't administrate your userwiki for a while you maybe forgot which groups are available and so on. But there is a more important fact: if you write a group wrong you create a new one instead of add the user to a available group. [[http://personal-computer-tutor.com/dropdown.htm|Example]]; [[http://personal-computer-tutor.com/dropdownlist.htm|How to]] <-Well I know, **you** know how to do.. --- //[[Neosky[at]vodafone[dot]de|Neosky]] 2006-08-25 09:29// Hi all, I also have a problem with DokuWiki's Admin feature (System: Windows XP, Apache2, PHP5.2) I log in as a root (superuser) and see the button "Admin" but clicking on it shows the message: "Permission Denied Sorry, you don’t have enough rights to continue. Perhaps you forgot to login?" and the "Admin" button disappears. What is it? --- //[[david[dot]managadze[at]rub[dot]de|David]]// > I don't know, except that possibly its something to do with your cookies. It isn't anything to do with the user manager plugin. You will be better off presenting your problem in the [[http://forum.dokuwiki.org|forums]] or in [[irc]] --- //[[chris@jalakai.co.uk|Christopher Smith]] 2007-01-09 15:35// Hi all, is there at present a way to do inverse filtering, i.e., listing all those that do not belong to a certain group? --- //[[rolf.engel@med.uni-muenchen.de|Rolf Engel]] 2007-03-27 16:09// Hi all, I would like to point out what I think is a small bug - at least it doesn't work in the way that I would have it ;) I am authenticating using my university's LDAP server, but managing the ACL locally (it's a bit nasty, but I have to do it like this because the group membership info isn't held on the LDAP server). I use the LDAP for authentication and getting display name and email address, so I have $canDo set so that modPass, modMail and modName are false. The problem arises when I try to add a user via the usermanager: because these fields are disabled, they are returned as empty, and so function _addUser fails. What I propose is to change the condition if (empty($pass) || empty($name) || empty($mail)) to if ( (empty($pass) && $this->_auth->canDo('modPass')) || (empty($name) && $this->_auth->canDo('modName')) || (empty($mail) && $this->_auth->canDo('modMail')) ) Making this change allows me to add users successfully. It seems to me that you should be able to add users without specifying their password, real name, etc if your authentication method so desires. //[[public@ssbd.net|Andy Turner]] 2008-02-04 13:00// When I add a user and check the Notify User checkbox, the user is created without problems, but the notifying email is not sent. There is an error message that states, "Notification email could not be sent." Is my problem related to your plugin or should I look elsewhere? Thanks. --- //[[jwest24@cs.utk.edu|Joel West]] 2008-06-05 11:07// The "add user" and "edit user" form uses a common text field for passwords (which are visible in this case). So my question is why not use HTML tag for password field and second why not use the functions for formulars from DokuWiki located in inc/form.php? --- //Knut// 2008-11-22 >I'm no expert, but did a quick'n'dirty patch to fix this behavior – most of my users will use workstations in an open environment (typically a classroom), so visible passwords aren't an option. Download [[http://koti.kapsi.fi/~toweri/admin.patch|this file]] (sorry for only linking, couldn't get the patch file to show properly using code tags), save it as lib/plugins/usermanager/admin.patch in your dokuwiki directory and run in the usermanager directory (lib/plugins/usermanager) the following command: patch -i admin.patch >No guarantees of any sort, but it worked for me... I've reported this in the bug tracker, hope it gets fixed soon. --- //[[tvoipio@gmail.com|Timo Voipio]] 2009/02/24 18:34// ---- Searched for a solution for giving a group like "moderator" the ability to do usermanagement without give that group the full rights of superadmins. I didn' find any hint. So i want to ask: Is there an ability or a hack to solve my problem? (autosign is disabled; I am setting up a website like a CMS with workflow for several members but not editable for visitors) --- Hope, anybody has a tip!\\ Thanks!\\ [[mailto:webmaster@buchhandlung-spessart.de|utaf]] 2009/02/27\\ Edit: Nun bin ich scheinbar einen Schritt weiter: Habe einen Manager eingerichtet! Allerdings erscheint keine Benutzerverwaltung auf seiner Adminseite! Wo kann ich das ändern? Danke 2009/03/01\\ Edit: Got the solution: There is a snippet like /** * access for managers */ function forAdminOnly(){ return false; } that I had to copy into the admin.php of the wanted plugin to appear in the admin_interface of the manager.\\ thanks for listening!\\ utaf 2009/03/01 ---- The autogeneration of new passwords doesn't work. I leave the password field empty and enable user notification. Nothing happens. This is only for "Edit this user". When adding a new user everything is fine. //Christian 2010/01/27// ---- Is it possible to edit the text contained in the email sent to notify users of their login details? 20/12/2010