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.

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.7.

Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.

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¹⁾.
     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
     • hostname²⁾
     • port number
     • database name³⁾
     • username⁴⁾
     • password⁵⁾
     • 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.

• 2025-01-05 (v1.3.0)
• 2024-03-06 (v1.2.1)
• 2023-06-06 (v1.2.0)
• 2020-03-14 (v1.1.3)
• 2016-03-03 (v1.1.2)

The complete list of releases and change log is available on Github.

• Bump version to 2025-01-05 by dregad (2025-01-05 19:24)
• Update README.md by dregad (2025-01-05 19:24)
• Fix checking of passwords containing `\`, `'` or `"` by dregad (2025-01-05 19:22)
• Apply WordPress latest changes to phpass class by dregad (2025-01-05 19:20)
• Bump version to 2024-03-06 by dregad (2024-03-06 19:47)

Full Git log.

Please refer to the plugin's Issue tracker on Github.

• 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.

1. Edit your local configuration file ./conf/local.php
2. Reset authentication to authplain

   $conf['authtype'] = 'authplain';

3. Save the file