AuthUserVBulletin

Summary: Allows PmWiki to use vBulletin for a user login/password base, and to borrow PmWiki groups from vBulletin.
Version: 0.1.2
Prerequisites: AuthUserDbase v. 1.0.6, ADOdb database library
Status: beta
Maintainer: XES
License: GPL2
Categories: Security

Questions answered by this recipe

How can I have PmWiki read my vBulletin users/passwords and groups for PmWiki authentication? This section is optional; use it to indicate the types of questions (if any) this recipe is intended to answer.

Description

PmWiki authentication and user groups from vBulletin's database.

This recipe allows PmWiki to read data from the vBulletin database and authenticate users against their vBulletin login data. In addition, it allows you to transfer vBulletin user groups into PmWiki groups.

It does not allow you to manage usernames, passwords or groups for vBulletin from within PmWiki. It only allows PmWiki to borrow information from the vBulletin database. vBulletin would still be needed to change the user information.

Notes

and AuthUserDbase v. 1.0.6

  • you need to know your mysql login information
  • you need to know your vBulletin table prefix. You may need to look at your database to figure it out. The prefix is a set of letters or characters in front of every table that is in use by vBulletin. This is set at the time you install vBulletin.
  • There are 3 optional arrays set in config.php. Each array contains the group id number(#) and the PmWiki group to add the group members to. $VB_UserGID takes #'s from the usergroupid field in vBulletin, $VB_MemberGID takes #'s from the membergroupids field in vBulletin, and $VB_DisplayGID takes information from the displaygroupid field. At least one of these arrays needs to be set for user groups in vBulletin to be transferred to PmWiki. You may leave all three of these fields out or comment them out to disable the group-borrowing features.

Usage

Add to config.php:

// Start AuthUserDBase + VBulletin

include_once("$FarmD/cookbook/adodb/adodb.inc.php");

// database login information - not optional
$VB_DBase = array (
	'dbtype' => 'mysql',
	'host' => 'localhost',
	'db' => 'database',
	'user' => 'username',
	'password' => 'dbpassword');
// if your vBulletin installation uses a table prefix enter it here
$VB_TablePrefix = "prefix_";
// each of the following is optional
$VB_UserGID = array (
	'#' => '@group'
	);
$VB_MemberGID = array (
	'#' => '@group');

$VB_DisplayGID = array (
	'#' => '@group');

// not optional - includes the script
include_once("$FarmD/cookbook/vbulletin.php");

$AUDBaseDBase = $VB_DBase;
$AUDBaseEncryption = 'vbulletin';
$AUDBaseTable = array(
	'table' => 'user',
	'userfield' => 'username',
	'pwfield' => 'password');

require_once("$FarmD/cookbook/AuthUserDbase-1.0.6.php");
require_once("$FarmD/scripts/authuser.php");

// End AuthUserDBase + VBulletin

Release Notes

If the recipe has multiple releases, then release notes can be placed here. Note that it's often easier for people to work with "release dates" instead of "version numbers".

See Also

Contributors

XES

Comments

See discussion at AuthUserVBulletin-Talk

User notes? : If you use, used or reviewed this recipe, you can add your name. These statistics appear in the Cookbook listings and will help newcomers browsing through the wiki.