User Tools

Site Tools


Sidebar

addons:bridge:vbulletin

This is an old revision of the document!


VBulletin Bridge

This bridge type is available on Enterprise editions, and also if you have purchased the addon for "all bridge types".

Steps inside vBulletin Admin

Since this bridge is one-way, changes made to user details1) in the Geo software are also made inside vBulletin by the vBulletin bridge. However, changes made in vBulletin are not transfered back to the Geo installation, so if a user changes the password or a new user registers, that information will be "out of sync".

The solution to this, is to disable user registrations, user info editing, and password changing, from inside vBulletin itself. Instead they make those changes in the Geo software and the changes get copied over. To accomplish this, follow the steps below.

<tip c n>Note: These instructions were created for vBulletin 3.8.4, how things are accomplished may be different in newer (or older) versions of vBulletin. When that is the case you may need to consult the vBulletin documentation to accomplish a task.</tip>

Disable Registrations

Follow the steps below to disable user registrations.

  1. Within the VBulletin admin, go to vBulletin Options > vBulletin Options, and select User Registration Options. <
  2. For the setting Allow New User Registrations select no. <
  3. In the admin, go to Languages & Phrases > Search in Phrases. <
  4. Use the tool to search for "noregister" (without the quotes), and select the option for "Phrase Variable Name Only" <
  5. Click edit for the phrase found, and change the text to reflect a more appropriate message regarding the location of the registration within the Geo installation. <
  6. Save the changes. <

Within the vBulletin text, you will need to change all the log-out links to "point" to your geo installation's logout page, the URL would end in2)

index.php?a=17

You would search for "logout", "log out", and "log_out" in all languages & phrases, and convert any link to point to the Geo logout page, then do the same within the templates in vBulletin, altering the logout links to point to the Geo installation as mentioned above. To help get you started, below are specific instructions for each link found as of the last time this document was last updated.

Logout link in language/phrase text:

  1. In admin panel at Languages & Phrases > Search in Phrases, for the text log out, then click find. <
  2. Click edit next to the entry that is found for logout_error. <
  3. Find the part of the text that is linking to the log out, it will be something like:
    <a href="login.php?{1}do=logout&amp;logouthash={2}">Click here to log out.</a>

Change the URL logout link to point to the logout page in the Geo software, so it looks something like this3):

<a href="http://example.com/listings/index.php?a=17">Click here to logout.</a>
  1. Save the changes.

<

  1. In admin panel at Languages & Phrases > Search in Phrases, for the text log out, then click find. <
  2. Click edit next to the entry that is found for nopermission_loggedin. <
  3. Find the part of the text that is linking to the log out, it will be something like:
    <a href="login.php?{3}do=logout&amp;logouthash={4}">Log Out</a>

Change the URL logout link to point to the logout page in the Geo software, so it looks something like this4):

<a href="http://example.com/listings/index.php?a=17">Log Out</a>

<

  1. Save the changes. <
  2. Repeat for any other phrases that are found, that contain links to log out. This does not include any entries that just contain the "log out" text but no <a …> tag that links to log out. <

Logout link in templates:

  1. In admin panel at Styles & Templates > Search in Templates, for the text log_out.
  2. Double-click on the first found template FORUMHOME. <
  3. In that template, find the logout link, it will be something like this:
    <a href="login.php?$session[sessionurl]do=logout&amp;logouthash=$bbuserinfo[logouthash]"  onclick="return log_out('$vbphrase[sure_you_want_to_log_out]')"><phrase 1="$bbuserinfo[username]">$vbphrase[log_out_x]</phrase></a>

Change the URL logout link, so it looks something like this5):

<a href="http://example.com/listings/index.php?a=17"  onclick="return log_out('$vbphrase[sure_you_want_to_log_out]')"><phrase 1="$bbuserinfo[username]">$vbphrase[log_out_x]</phrase></a>

Then save the changes. <

  1. In admin panel at Styles & Templates > Search in Templates, for the text log_out.
  2. Double-click on the found template navbar. <
  3. In that template, find the logout link, it will be something like this:
    <a href="login.php?$session[sessionurl]do=logout&amp;logouthash=$bbuserinfo[logouthash]" onclick="return log_out('$vbphrase[sure_you_want_to_log_out]')">$vbphrase[log_out]</a>

Change the URL logout link, so it looks something like this6):

<a href="http://example.com/listings/index.php?a=17" onclick="return log_out('$vbphrase[sure_you_want_to_log_out]')">$vbphrase[log_out]</a>

Then save the changes. <

  1. Repeat for any other places that found a link to log out, to replace the href value with a link to the logout page within the Geo software. <

We will be working to update the rest of the documentation, until then you can reference the legacy documentation found below.

You can leave all the registration links as-is in vBulletin, and the changes made described in the Disable Registrations section will point them to the Geo installation.

If you would prefer a 1-click solution where all registration links point to Geo installation however, you can change all the registration links to "point" to your geo installation's registration page at register.php, assuming that file has not been re-named.

You would search for "register" in all languages & phrases, and convert any link to point to the Geo register page, then do the same within the templates in vBulletin, altering the register links to point to the Geo installation as mentioned above. You would use the same methods as we described in Convert Logout Links to find the registration links (you would just be searching for register instead of log out).

Within the vBulletin text, you will need to change all the log-in links to "point" to your geo installation's login page, the URL would end in7)

index.php?a=10

You would search for "login", "log in", and "log_in" in all languages & phrases, and convert any link to point to the Geo login page, then do the same within the templates in vBulletin, altering the login links to point to the Geo installation as mentioned above. You would use the same methods as we described in Convert Logout Links to find the registration links (you would just be searching for log in instead of log out).

Troubleshooting, Caveats, and "Known Issues"

The following are things to note with the vBulletin bridge functionality. These are not necessarily due to any "bugs" or "problem" with the bridge, but are just the nature of how the vBulletin bridge works since it is a one-way bridge.

  1. There is currently no way to modify Vbulletin profile information settings

through the bridge or current Geodesic Solutions installations. <

  1. No password history support. <
  2. No ban email support through Vbulletin. At Registration and user info update Emails are checked against the Geodesic Solutions installation for duplication. Depends on

the version and edition of Geodesic Solutions Software you have for any email banning facility that can be used. <

  1. Only the Geodesic Solutions installation email verification system can be used. <
  2. Only the Geodesic Solutions installation lost password facility can be used. <
  3. The username for a user cannot be changed within Geodesic Solutions installations and recommend that you not allow this in any other installations. The admin can do this within the Geodesic Solutions installation admin panel and will have to be done for each individual installation connected by the bridge. <
  4. User removal in Geodesic software will not remove the user in vBulletin as a precaution, as any time a user is removed from a Geo installation, NONE of the bridges will be affected, the user must be removed from each installation separately. <
  5. If the "registration", "change email", or "change user password" facilities are left intact inside vBulletin, that can lead to user information being out of sync. When this happens, it will need to manually be updated by the admin user. <
  6. When a user is registered (or user info changes), if there is already a matching username OR e-mail in vBulletin, that user cannot be created or synced in vBulletin. <
  7. If the password in Geo software and vBulletin get out of sync, changes will not be synced for that user as a security precaution, if the user pass doesn't match up that might mean the users are not actually the same person. To fix you will need to manually update the password in both installations to ensure it is the same in both. <
1)
Such as when a new user registers, an existing user edits the user information, or a user changes the password.
2) , 7)
Note that index.php might be different if you use a different setting for your main file name for the site. This is not typical however, most sites do use index.php.
3) , 4) , 5) , 6)
change example.php/listings/ to match your Geo installation location
addons/bridge/vbulletin.1254181296.txt.gz · Last modified: 2014/09/25 16:55 (external edit)