1# authdrupal7 Plugin for DokuWiki
3Dokuwiki Authetication using Drupal7 accounts
5This plugin might be useful if you are running a drupal website and want to give your drupal users access to a dokuwiki using the same login credentials.
6In my case I am hosting a public website providing public information about a student's group. All members have an drupal account to do certain modifications on the website. For internal knowledge transfer we also host a dokuwiki running on the same server. I don't want to adminstrate double login credentials.
7There are solutions for this problem, I found several offers. But I was not able to get any of them to work. That's why I decided to start my own project.
9All documentation for this plugin can be found at
12If you install this plugin manually, make sure it is installed in
13lib/plugins/authdrupal7/ - if the folder is called different it
14will not work!
16Please refer to http://www.dokuwiki.org/plugins for additional info
17on how to install plugins in DokuWiki.
21This plugin is widely based on
23Dokuwiki MySQL authentication backend by
24* Andreas Gohr <email@example.com>
25* Chris Smith <firstname.lastname@example.org>
26* Matthias Grimm <email@example.com>
27* Jan Schumann <firstname.lastname@example.org>
30DokuDrupal Drupal 7.x/MySQL authentication backend by
31* Alex Shepherd <n00bATNOSPAMn00bsys0p.co.uk>
35The plugin will only work if you have a drupal installtion accessible, as it tries to include some drupal code snippets (e.g. the hashing algorithm).
37In configuration backend you have to edit at least the following entries:
38* MySQL server
39* MySQL user and password
40* MySQL database holding your drupal tables
41* The database prefix used for your drupal tables (including the underscore e.g. ```myprefix_```)
42* The path to you drupal root directory (including a slash at the end e.g. ```../drupal/```)
44**Before** setting your authentication mode to ```authdrupal7``` you should think about the following:
45Dokuwiki might only grant access to users that are member of a defined user group. This plugin is reading the user groups from your database.
46Make shure, that you use the exact same user group names in the ACL controls. Otherwise you might not be able to get access to your wiki or your adminstration panel although you are able to log in using correct credentials.
48In the configuration menu you should consider changing the following entries:
49* superuser: add a superuser group (with @) or username that matches one of your drupal roles or users
50* manager: add a manager group (with @) or username that matches one of your drupal roles or users
52Also think about necessary changes in the ACL config. For my case I configured my wiki as closed. So accounts that do not match a special group defined in the ACL controls are locked out. I added a new role "wiki" for all my users in drupal and made accessing the wiki exclusive for this user group (@wiki).
55Copyright (C) Matthias Jung <email@example.com>
57This program is free software; you can redistribute it and/or modify
58it under the terms of the GNU General Public License as published by
59the Free Software Foundation; version 2 of the License
61This program is distributed in the hope that it will be useful,
62but WITHOUT ANY WARRANTY; without even the implied warranty of
63MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
64GNU General Public License for more details.
66See the COPYING file in your DokuWiki folder for details