vBulletin Bridge: Integrate site users with vBulletin member system

README/USAGE - vbulletin-bridge - 10/16/09
------------------------------------------
class vBulletin-Bridge - intended to be used with vBulletin 3.7.2
Based on snippet by Alex Matulich, June 2008, Unicorn Research
Corporation released under BSD. Major modifications made by
Sam Cleaver (Beaver6813.com), Sept 2009, sam@beaver6813.com.
------------------------------------------
 FULL LIST OF FUNCTIONS AVAILABLE FOR USE:
- register_newuser (Registers new user and sends out activation email unless
  $noactivate is set to true)
- activate_user (Activates user)
- deactivate_user (Deactivates & Deletes user)
- requestact_user (Requests new activation email)
- request_password (Requests lost password email)
- check_password_request (Verifies lost password info)
- change_password (Changes the users password)
- update_user (Updates specified user information)
- delete_user (Hard deletes user (not reccomended))
- login (Logs in user)
- logout (Logs out user)
------------------------------------------
 CONFIGURATION
 Minimal configuration is needed, see INSTALL
------------------------------------------
 USAGE
 
 At the top of your php modules where you need to perform vBulletin
 user operations (creation, deletion, updating, login, and logout),
 put these two lines (where MY_PATH is the path to this file):

     require_once(MY_PATH.'/class.vbulletin-bridge.php');
     $forum = new vBulletin_Bridge();

 Now get your user data array from $_POST or whatever.  Let's call
 this array $userdata.  Here's what you can do:

 CREATE AND REGISTER NEW USER:

    $errmsg = $forum->register_newuser($userdata);

 UPDATE EXISTING USER DATA:

    $errmsg = $forum->update_user($userdata);

 (In this case, $userdata need contain only the username and anything
 else you wish to update, such as password and/or email address.)

 $errmsg contains any error messages separated by <br> codes.
 If no errors occured then NULL is returned.

 DELETE USER:

    $forum->delete_user($username);  $username = user name

 LOGIN USER TO THE FORUM:

    $forum->login(   requires array to be passed
       array('username' => $username, 'password' => $pw);

 LOG OFF USER FROM THE FORUM:

    $forum->logout();


 WARNING: It is common for you to have TABLE_PREFIX defined for
 your own database.  You must call it something else (for example,
 remove the underscore) or it will conflict with the vBulletin
 definition of the same name.