It's better when it's simple

User Tools

Site Tools


WordPress Authentication Plugin

Compatible with DokuWiki

  • 2017-02-19 "Frusterick Manners" yes
  • 2016-06-26 "Elenor Of Tsort" yes
  • 2015-08-10 "Detritus" yes
  • 2014-09-29 "Hrun" unknown

plugin Provides authentication against a WordPress MySQL database backend

Last updated on

Tagged with authentication, wordpress



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.


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

  1. Login to Dokuwiki as administrator
  2. Go to your site's Configuration Manager
  3. 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.
  4. Scroll down to the Authwordpress Plugin section
    • Provide the required configuration information
      • Hostname2)
      • Port number
      • database name3)
      • username4) FIXME Note to the person who added the FIXME: could you please explain what needs to be fixed ?
      • password5)
      • table prefix
  5. Save settings


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.


Revision history (Github releases)

Recent commits

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.


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
This will turn Wordpress administrators into DokuWiki super users
2) , 3) , 4) , 5)
plugin/authwordpress.txt · Last modified: 2017-12-09 11:31 by dregad