It's better when it's simple

User Tools

Site Tools


WordPress Authentication Plugin

Compatible with DokuWiki

  • 2024-02-06 "Kaos" probably
  • 2023-04-04 "Jack Jackrum" yes
  • 2022-07-31 "Igor" yes
  • 2020-07-29 "Hogfather" yes

plugin Provides authentication against a WordPress MySQL database backend

Last updated on



This plugin requires access to a WordPress site's MySQL database. See Configuration and settings section below for further information.

PHP's PDO extension is required.

Wordpress compatibility

The plugin supports WordPress releases 4.x 5.x and 6.x. It has been tested and confirmed to work on versions 4.3 to 4.9, 5.1 to 5.3 and 6.0 to 6.2.


Search and install the plugin using the Extension Manager. Refer to Plugins on how to install 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 list1).
      :!: 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)
      • 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

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.


I locked myself out, what do I do now?

  1. Edit your local configuration file ./conf/local.php
  2. Reset authentication to authplain
    $conf['authtype'] = 'authplain';
  3. Save the file
This will turn Wordpress administrators into DokuWiki super users
2) , 3) , 4) , 5)
plugin/authwordpress.txt · Last modified: 2023-10-14 16:17 by dregad

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki