vBulletin LTS

modXvBin - modX CMS and vBulletin integration script
Mod Version: 1.00, by resurepus

BanzaiTokyo modXvBin 1.0

BanzaiTokyo modXVBin 1.0 is an integration script that synchronizes the users databases of modX and vBulletin. We've chosen vBulletin forum script as the core of the package. It has more developed tools to work with the users and is just a more advanced piece of software.

BanzaiTokyo modXvBin requires that the PHP files of both systems (modX and vBulletin) are located on the same server. As for the databases - they can be anywhere since the script looks up the information for the connections in the configuration files.

What has already been done:
1. When a user logs in one system he is automatically logged in in the other.
2. When a user is registered in one system he is automatically registered in the other. In fact the registration is done through vBulletin. The data for modX's database is taken from there.
3. When a user edits their password or email in the User Control Panel in vBulletin, the script automatically updates the parameters in modX.
4. The same happens when you change user's parameters from vBulletin Admin Control Panel.
5. vBulletin password reset works for both systems.

What has not been done yet:
1. Registration though the means of modX script (through registration form or creation of webuser in admin panel) doesn't add the user in vBulletin's database.
2. The user modifications in modX admin panel are not automatically transferred to the vBulletin database.
3. modX password reset does not reset passwords in vBulletin.
4. User removal from either modX or vBulletin database does not remove him from the other system.
6. The script will not affect the users registered in either of the systems before the installation of the script. If it is needed the users can be created manually in the other system and password reset.

Installation

These are istrtuctions for istallation of BanzaiTokyo modXVBin script version 1.0.

I. in vBulletin
1. Plugins & Products -> Manage Products -> Add/Import Product -> choose product-modixvbin.xml from the installation archive and install.
2. In the beginning we recommend to turn off GZIP HTML output in vBulletin Options -> Cookies and HTTP Header Options -> GZIP HTML Output. After install, test user login and registration. If everything works ok, you can turn it back on.
3. Languages & Phrases -> Phrase Manager -> Phrase Type: GLOBAL find phrase "modxpath" and set it to modX (see below).

II. In modX
1. Manager -> Resources -> Manage resources -> Plugins -> New plugin.
Plugin name - any name. Take "vBulletin" for instance.
Plugin code - insert the contents of modx_vblogin.php
Menu tab System Events: check OnWebLogin, OnWebLogout. Save.
2. In index.php anywhere (you can do it right after "<?php" insert the contents of modx_index.php
in $VBDIR put the path to vBulletin script (see below)

III. Setting the Paths
Paths have to be relative and end with "/"
Let's take BanzaiTokyo.com for example:
modX is installed in the root folder and vBulletin is located in the folder "forum". In this case:
1. In vBulletin: modxpath has to link to modX, e.g. une level higher. What we have to write is simply "../" Of course when you edit the phrase in "English (US) Translation" window you don't use brackets.
2. In modX the forum can be found one level below in the folder "forum". So, we'll just write: $VBDIR = "forum/";

To give you an example of how it is done if both scripts are installed on the same level, just in different directories, for example modX is in yoursite/modx and vBulletin in yoursite/vBulletin
1. In modxpath you put "../modx/"
2. $VBDIR = "../vb/";

The script is officially released and has been tested on http://BanzaiTokyo.com/forum
However we do not guarantee that it will not have any bugs errors and will not ruin your whole database and even your server In fact we do not guarantee anything at all. You agree to use this script "as is".