This is an old revision of the document!
Table of Contents
WordPress Authentication Plugin
Compatible with DokuWiki
Detritus, Elenor of Tsort, Release 2017-02-19b, Frusterick Manners
This extension has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues.
Installation
Prerequisites
This plugin requires access to a WordPress site's MySQL database. See Configuration and settings section below for further information.
Wordpress compatibility
The plugin has been tested with WordPress 4.3 through 4.9, but will most likely work with any 4.x version.
Setup
Install the plugin using the Plugin Manager or the download URL above, which points to the latest version of the plugin. Refer to Plugins for further details about installing plugins manually.
Configuration and Settings
- Login to DokuWiki as administrator
- Go to your site's Configuration Manager
- In the Authentication section
- Set Authentication backend to authwordpress
- Add @administrator to the Superuser list 1).
failure to do so may leave you without any users having admin rights, requiring you to manually edit the configuration file to fix the problem.
- Scroll down to the Authwordpress Plugin section
- Save settings
Usage
Navigate to your DokuWiki's Login page, and enter your WordPress credentials to login.
Logged in users' will have the following group memberships:
- DokuWiki default group (as defined in configuration),
- a group matching their Wordpress role, i.e. one of
- administrator
- editor
- author
- contributor
- subscriber
These groups can be used to setup ACL as appropriate.
The plugin does not allow new users to sign up, accounts must be created on the WordPress side.
Development
Revision history (Github releases)
The complete list of releases and change log is available on Github.
Recent commits
- Bump version to 2024-03-06 by dregad (2024-03-06 19:47)
- Update README.md by dregad (2024-03-06 19:47)
- translation update by PrimroseAzelhart (2023-12-07 09:30)
- Bump version by dregad (2023-06-06 21:58)
- Update README.md by dregad (2023-06-06 21:56)
Full Git log.
Known Bugs and Issues
Please refer to the plugin's Issue tracker on Github
ToDo/Wish List
- Provide transparent authentication / single sign-on
If user is already logged in WordPress, then they won't have to login again in DokuWiki, and vice-versa. Same thing for logout.
FAQ
I locked myself out, what do I do now ?
- Edit your local configuration file ''./conf/local.php
- Reset authentication to authplain
$conf['authtype'] = 'authplain';
- Save the file