Release status: stable
|Implementation||User access, User identity, User rights|
|Description||IPBLoginAuth is a MediaWiki extension which authenticates users through an IPB forums database.|
|Author(s)||Frédéric Hannes (FHannestalk)|
|Latest version||1.0.1 (2016-09-10)|
|License||GNU General Public License 3.0|
|Translate the IPBAuthLogin extension if it is available at translatewiki.net|
|Check usage and version matrix.|
The IPBAuthLogin extension makes it possible to authenticates users through an Invision Power Board forums database. Currently the extension only supports IPB versions 3 and 4.
- Download and place the file(s) in a directory called
- Add the following code at the bottom of your LocalSettings.php:
wfLoadExtension( 'IPBAuthLogin' ); $wgIPBDBHost = 'forum_db_host'; $wgIPBDBUsername = 'forum_db_username'; // this account only needs SELECT access to forum DB $wgIPBDBPassword = 'forum_db_password'; $wgIPBDBDatabase = 'forum_db_name'; $wgIPBDBPrefix = ''; // Leave as empty string unless you have a db prefix for your forum DB tables //$wgGroupPermissions['*']['createaccount'] = false; // If uncommented, the only way to create a new wiki account will be logging in via the forum $wgIPBVersion = 4; // comment this out if you are using IPB v3
- Configure as required.
- Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.
By default the extension will set local MediaWiki accounts as (email) confirmed when they are not part of the "Validating" usergroup in IPB. This should be usergroup ID 1 by default, but this can be changed by assing a different value to
$wgIPBGroupValidating. The default:
$wgIPBGroupValidating = 1;
The extension will assign local MediaWiki users to the
sysop usergroup when they are part of the IPB Administrators usergroup, which has ID 4 by default. The extension provides an array mapping allowing different and/or custom assignments to be made. (Or none at all given an empty array.) This functionality provides support for custom IPB usergroups, as well as custom MediaWiki usergroups. The default:
$wgIPBGroupMap = array( 'sysop' => 4 );
As the extension does not currently support account recovery, the account recovery link shown on the MediaWiki login page may be disabled/removed by adding the following line to LocalSettings:
$wgPasswordResetRoutes = array( 'username' => false, 'email' => false );
When a user logs in, the extension will authenticate them through the IPB database and assign them the appropriate usergroups. Beware that these usergroups assignments are stored locally for the MediaWiki instance and will not reflect updates on the IPB installation until the user logs out and in again in MediaWiki. If changes have to be immediate, an administrator should manually update the permissions for the local MediaWiki account.
- Extension:IPBAuth - Authenticates users through IPB forums for older versions of MediaWiki.