User Tools

Site Tools


addons:bridge:vbulletin

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
addons:bridge:vbulletin [2009/09/28 23:36]
jonyo Added known issue section, removed legacy section.
addons:bridge:vbulletin [2015/01/13 23:27] (current)
geomatt
Line 1: Line 1:
 ====== VBulletin Bridge ====== ====== VBulletin Bridge ======
  
-This //bridge type// is available on Enterprise editions, and also if you have purchased the addon for "all bridge types".+This //bridge type// allows you to bridge users with vBulletin software.
  
 ====== Steps inside vBulletin Admin ====== ====== Steps inside vBulletin Admin ======
-Since this bridge is //one-way//, changes made to user details((Such as when a new user registers, an existing user edits the user information, or a user changes the password.)) 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".+Since this bridge is //one-way//, changes made to user details((Such as when a new user registers, an existing user edits the user information, or a user changes the password.)) 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.  This means that if a user changes the password in vBulletin, or if a new user registers within vBulletin, 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.+The solution to this, is to disable user registrations, user info editing, and password changing, from inside vBulletin itself.  Instead your users will make those changes in the Geo softwareand 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**, things 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 each task.</tip>+<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 task
 + 
 +Also note that the current bridge has been tested on newer vBulletin versions, and is known to work on **4.0** versions, including the newer vBulletin CMS.  If you do experience any problems with a newer released version of vBulletin, please contact support.  From time to time minor adjustments may be needed for the bridge to make it compatible with newer released versions of vBulletin.</tip>
  
 ===== Disable Registrations ===== ===== Disable Registrations =====
Line 80: Line 82:
 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**. 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**.
  
 +  - If you see an error to the effect of "config.php file could not be found" keep looking for that file.  Yes you may have found one but in a version update vBulletin has started using another one somewhere else in their software.  Yes that means there could be two of these files in their installation.  Look for that other config.php and insert the path to that file and test the bridge again.
   - There is currently no way to modify Vbulletin profile information settings    - There is currently no way to modify Vbulletin profile information settings 
 through the bridge or current Geodesic Solutions installations. < through the bridge or current Geodesic Solutions installations. <
Line 88: Line 91:
   - Only the Geodesic Solutions installation lost password facility can be used.  <   - Only the Geodesic Solutions installation lost password facility can be used.  <
   - 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. <   - 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. <
-  - User removal in Geodesic software will not remove the user in vBulletin, this is usability 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. < +  - 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. < 
-  - If the registration, 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. <+  - If the "registration", "change email"or "change user passwordfacilities 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. <
   - 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. <   - 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. <
   - 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. <   - 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. <
  
 +====== Important Configuration for vBulletin 4.2.x ======
 +
 +If using vBulletin version 4.2 (confirmed on 4.2.1 and 4.2.2 (all patch levels) as of this writing), you must make a small change to the vBulletin PHP code in order for the bridge to work correctly. If you need assistance making this change, open a Support Ticket with us.
 +
 +Open the file **includes/functions.php** in the vBulletin install. Near the top, you should see:
 +
 +<code php>
 +/* Navbar stuff
 +Dont use DIR here, the Dev scripts dont like it */
 +require_once('./includes/functions_navigation.php');
 +</code>
 +
 +Replace the above code with this:
 +
 +<code php>
 +/* Navbar stuff
 +Dont use DIR here, the Dev scripts dont like it */
 +//GEO EDIT: add DIR here, so that it works with the bridge
 +require_once(DIR.'/includes/functions_navigation.php');
 +</code>
 +
 +and then save the file. This corrects a file include path that cannot otherwise be accounted for from the GeoCore side of things, and will allow the bridge to function normally.
addons/bridge/vbulletin.1254180965.txt.gz · Last modified: 2014/09/25 16:55 (external edit)