EXT: vBulletin connect¶

What does it do?¶

It sync the user table of vBulletin and the fe_users of TYPO3 and allows single sign on.

The master system is TYPO3 , which handles the frontend users. You can easy edit, delete and create frontend user from the backend of TYPO3. This extension handles the equivalent vBulletin users. Only overlapping fields are syncronized: usernamen , password , email, www . and usergroups .

Frontendusers can also created and edited by frontenduser, with the extensions: “feuser_admin” and “ sr_feuser_register ”.

This extension comes with a vBulletin Plugin , which handles the update of the TYPO3 fe_users, when a user is updated or deleted from vBulletin. But not if a user is created from vBulletin.

If you have already vBulletin user, you should import this in TYPO3, but these users have to ask for a new password with the “password forgotten” link from the newloginbox, because the password from vBulletin is a md5 hash which cannot converted into the typo3 password.

This extension is experimental but it should work! If you have troubles, please send me an email: herbert.roider@utanet.at

I have developed and tested the extension with TYPO3 version 3.8.1, 4.0.1, 4.4.4, 4.6.0 and vBulletin version 3.6.1, 3.6.4 and 4.1.7

Backend Module (info->vBulletin_user)¶

“not connected TYPO3 users”: Show the TYPO3 users where no equivalent vBulletin users exists. It allows to create equivalent vBulletin users to allow single sign on.

Backend (list Module)¶

You can input in the password field plain text, it will be converted into md5 hash. But there is no way to restore the password. The equivalent vBulletin user will be also updated, and if no vBulletin user exists, it will be created.

Programmers API (advanced)¶

The extension provides a API e.g. for programmers to extend the edit forms for frontendusers. Refer the script: class.user_vbulletin_feAdmin.php, The API encapsulate the vBulletin data managers. Refer the vBulletin manual for details.

Include this files:

require_once(t3lib_extMgm::extPath('hr_vbulletin_connect')."user_vBulletin_global.php");
require_once(t3lib_extMgm::extPath('hr_vbulletin_connect').'class.user_feuser_vbulletinuser_sync.php');

The object of the class user_feuser_vbulletinuser_synccan be a class member:

$this->vBulletin_sync = t3lib_div::makeInstance('user_feuser_vbulletinuser_sync');

Test if email is valid. $email is called by reference, so maybe vBulletin change this value! If a vBulletin user already exists , then you must call set_existing . Because vBulletin test if a email address is unique for a new user.

$vb_user = fetch_userinfo($TYPO3_fe_user['tx_hrvbulletinconnect_vbulletin_user_id']);
if(is_array($vb_user)){
    $this->vBulletin_sync->vBulletin_userdata->set_existing($vb_user);
}

$email="herbert.roider@utanet.at";
if(!$this->vBulletin_sync->vBulletin_userdata->verify_useremail($email)){
    echo 'You must enter a valid email address';
}

Use this for all equivalent userdata like email, www and username. You can use this also for the password, but vBulletin converts the password in a hash! This is maybe not usable.

create a new user:

For the function user_create the $TYPO3_fe_user should contains username , password (md5 or plaintext ->vBulletin has no problems with both) and email . For the post_user_create it is necessary, that the array contains the field “uid”, but all of the other fields are not used.

$vBulletin_userdata = $this->vBulletin_sync->user_create($TYPO3_fe_user);
if (!empty($vBulletin_userdata->errors))
{
    foreach ($vBulletin_userdata->errors AS $index => $error)
    {
            echo $error;
    }
    return;
}

//Save the fe_user:
user_feAdmin::save();
if(!$this->saved){
    /* Save of the fe_user fails, but a vBulletinuser is created,
     but no equivalent TYPO3 user, so
     delete the vBulletin user.
    */
    $vBulletin_userdata->delete();
}else{
    $this->vBulletin_sync->post_user_create($TYPO3_fe_user);
}

There are 2 functions to create a vBulletin user:

user_create($fe_user) and post_user_create($fe_user). Both functions must be called!. The second function must called after the fe_user is saved, because this function change the record in the fe_user table!

The same way to update a fe_user. There are also 2 functions:

user_update($fe_user) and post_user_update($fe_user). The second function must also called after the fe_user database operation.

/* Save the TYPO3 fe_user */
user_feAdmin::save();
$vBulletin_userdata = $this->vBulletin_sync->user_update($TYPO3_fe_user);
if($vBulletin_userdata == false){
    return;
}
if (!empty($vBulletin_userdata->errors))
{
    foreach ($vBulletin_userdata->errors AS $index => $error)
    {
            echo $error;
    }
    return;
}

//debug("postupdate");
$this->vBulletin_sync->post_user_update($TYPO3_fe_user);

In the array: $vBulletin_userdata->errors are the errormessages. If no error, this array is empty.

each function: user_create, post_user_create, user_update, post_user_update returns the userdata. Refer the vBulletin API for details. But in the error array there are also custom error messages from the class user_feuser_vbulletinuser_sync.The custom messages are in English, but the vBulletin error messages in the default language.of VBulletin

Delete a user:

$this->vBulletin_sync->user_delete($TYPO3_user_uid);

There are 3 fields username, email and www, which should have the same value. 3 new fields are added in fe_users:

FAQ¶

- no questions at the moment

Installation¶

Frontend User Administration with feuser_admin¶

A skript where frontend user can register or edit their data is added. This script: class.user_vbulletin_feAdmin.php is based on the user_feAdmin (feuser_admin) and ux_feadminLib.php from the extension “kb_md5fepw”. The configuration is mostly the same, but with additional features for disblay errormessages and sync the vBulletin users. Ensure that the static Template “fe_admin(hr_vbulletin_connect” is included.

• install the plugin: Frontend User administration (feuser_admin) and place it on a page (Page Module). The fields “Startingpoint” and “CODE” are ignored by this plugin.
• Insert the static template “Include static (from extensions)” fe_admin (hr_vbulletin_connect).
• Edit the Constants for PLUGIN.FEADMIN.FE_USERS in the Constant Editor:insert the page id of the page which contains the fe_users in the the Record PID – fieldandset the Usergroup override to the usergroup for registered users.
• Ensure that the pid of the page is the same as in the file update_typo3_user_hook.phpin the vBulletin includes directory.

The file fe_admin_fe_users.tmpl is mostly the same as the original from feuser_admin. Only the the code to show errormessages if the “www” is added.

Frontend User Administration with sr_feuser_register¶

• Install the extension: “ sr_feuser_register ” as described in the manual of the extension.
• Insert on the three pages which contains “sr_feuser_register” the static Typoscript template: “sr_feuser_register (hr_vbulletin_connect)”

FAQ¶

- no questions at the moment