User Manager Plugin

experimental | acl

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

At present the user manager does not provide any validation of data used to create new users or modify existing users.

A big thanks to neolaoo for his user manager - this is a heavily modified version of that plugin.

The plugin has no configuration settings.

The plugin is part of the Dokuwiki distribution.

Refer Dokuwiki source repository

this revision history will no longer be updated, for further details refer to Dokuwiki's darcs repository

• 2006-03-05 — Included in Dokuwiki release
• 2006-Feb — Plugin added to Dokuwiki dev version, various bug fixes & enhancements, various contributors
• 2005-12-01 — Bug fix, correct handling when user name changed to an already existing name
• 2005-11-10 — Various fixes, thanks again Matthias
• 2005-11-05 — Fix bug with in _retrieveUser(), thanks Matthias
• 2005-10-23 — Add auth capability checks for user create/modify/delete, sources updated
• 2005-10-21 — Released.

• (possibly) add data validation
• add support for auth_group functions (rather than through user modification)

Bugs should be reported through the DokuWiki bugtracker.

It is not immediately apparent how to use this plug-in. that is, do I visit a certain page, or what?

Admin plugins are available via the admin menu. If you are logged in a superuser you should have an admin button (bottom bar, right hand side in default template). Click that to see the admin menu. — Christopher Smith 2006-03-30 19:12

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. — Christopher Smith 2006-01-10 10:27

I tried to install this plugin, but it seams that it doesn't working. I put the source (admin.php and lang dir.) in lib/plugins/usermanager. What else I have to do to be able to use it? I get the following message: user authentication not available

Setup user authentication, see the pages on acl. — Christopher Smith 2006-02-09 22:06

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? — 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 authorisation mechanism has been heavily updated since 20050922, without those changes this user manager won't work. The original user manager by Neolao does work with the 20050922 version and the plain backend. — 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:\<Snip>\<Snip>\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:\<Snip>\<Snip>\inc\common.php on line 1094

Warning: array_search(): Wrong datatype for second argument in C:\<Snip>\<Snip>\inc\common.php on line 1095

Warning: file(C:\<Snip>\<Snip>\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:\<Snip>\<Snip>\inc\io.php on line 45

Warning: join(): Bad arguments. in C:\<Snip>\<Snip>\inc\io.php on line 45

Warning: file(C:\<Snip>\<Snip>\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:\<Snip>\<Snip>\inc\io.php on line 45

Warning: join(): Bad arguments. in C:\<Snip>\<Snip>\inc\io.php on line 45

Warning: Cannot modify header information - headers already sent by (output started at C:\<Snip>\<Snip>\inc\common.php:1094) in C:\<Snip>\<Snip>\lib\plugins\usermanager\admin.php on line 77

Warning: Cannot modify header information - headers already sent by (output started at C:\<Snip>\<Snip>\inc\common.php:1094) in C:\<Snip>\<Snip>\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 possiblity 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. — 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 resemblence to NeoLao's, the underlying auth system has been rewritten too. It really would be worth updating your Dokuwiki installation. — 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 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 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. — Christopher Smith 2006-04-27 22:11

Yeah, getting authentication set up is a bear. Make sure you have a writeable 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. — 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 occuring somewhere. This results in the top half of the template being shown but no content beyond the''<div class=“page”>, 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 bug report. — 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 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 authorisation backends, they tell it whether certain functions (e.g. user editing) are available and it adjusts its user interface accordingly. Thanks.

— 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
# <?php exit()?>
# 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 loggin 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 2006/05/05 22:28

I don't know if it's jsut me or something with the plugin but I just upgraded to 2006-03-09. I have no problem seein 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 braindead? (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 ot 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 … — 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 mystery meat navigation and should be changed. — Christopher Smith 2006-05-23 01:28

I think you should change the userasdministration. I would be nice if on “Add a user” and “Edit this user” there is a listbox or even better a dropdownlist, 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 administrat your userwiki for a while you maybe forgot which groups are available and so on .. But there is a more importen fact: if you write a group wrong you creat a new one instead of add the user to a available group. Example; How to ←Well I know, you know how to do.. — 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

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 forums or in irc — 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 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.

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. — Joel West 2008-06-05 11:07