This is an old revision of the document!
Table of Contents
authphpbb3 Plugin
Compatible with DokuWiki
Binky, Ponder Stibbons, Hrun, Detritus
This extension has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues.
This plugin allows users to authenticate using phpBB credentials directly in DokuWiki. This plugin is a two-ways authentication meaning a user can authenticate in phpBB or DokuWiki (SSO-like system).
Features list:
- Authentication: you can login using DokuWiki form with phpBB credentials.
- SSO: a user authenticated using phpBB will be authenticated in DokuWiki and vice versa (mutual authentication).
- Groups: phpBB groups can be used to set ACL.
- Profile: DokuWiki user's link redirects to phpBB user's profile.
- Cache: a cache system is used to improve performance.
Limitations
DokuWiki and phpBB need to be on the same domain for the authentication to work.
For the SSO feature, the plugin piggybacks on phpBB's cookie by fetching the user's session ID from it.
Installation
Search and install it in the Extension manager or install it manually by extracting the contents of the archive to lib/plugins
and renaming the directory to authphpbb3
.
Please refer to http://www.dokuwiki.org/plugins for additional info on how to install plugins in DokuWiki.
Configuration
- In the “Extension Manager”:
- plugin
authphpbb3
must be enabled.
- In the “Configuration Manager”:
Authentication
→authtype
:
selectauthphpbb3
.Display
→showuseras
:
selectUser's full name as interwiki user link
.Plugin Settings
→Authphpbb3
→plugin»authphpbb3»phpbb_root_path
:
relative path from DokuWiki root directory to phpbb3 root directory.
Default:../forums
.Plugin Settings
→Authphpbb3
→plugin»authphpbb3»phpbb_cache
:
cache validity period in days (0 will disable cache).
Default :1
.
You must de-activate the following Dokuwiki features. Please refer to Configuration Setting: disableactions.
- Register
- Update profile
- Set new password
- Delete own account
Permissions
To make use of DokuWiki's ACL, add the corresponding phpBB group or username to it (@phpbb_group
or phpbb_username
).
By design, phpBB founders will be members of @admin group in DokuWiki.
Changes
- Update .travis.yml (2019-12-21 15:41)
- Minor changes, plugin date updated. (2019-04-17 23:31)
- Fix an issue related to User Manager (search function). (2019-04-17 23:02)
- Fix issue #11 (try again :p) (2019-04-16 20:58)
- Prevent SQL injection in a request. (2019-04-13 20:57)
- Add correct date in plugin.info.txt (2019-04-13 20:17)
- Update plugin.info.txt (2019-04-13 20:12)
- Fix issue #11 (2019-04-13 20:09)
Known Bugs and Issues
Please report bugs and request features at the issue tracker.
For debugging purposes please enable debug mode and check the log file:
Configuration Manager
→Basic Settings
→allowdebug
- The debug log will be located at
data/cache/debug.log
- Please see configuration setting allowdebug and more about available debug tools at debugging