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, 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>

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.

Disable Editing User Data

This section has not yet been finished, see the Legacy Documentation for now.

Disable Changing Password

This section has not yet been finished, see the Legacy Documentation for now.

Disable login/logout

This section has not yet been finished, see the Legacy Documentation for now.

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

Legacy Documentation

Below are the old integration instructions specific for vBulletin. They are provided "as is" for now, but we will be going through the instructions and updating as needed.

BASIC SETUP

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

- Within the VBulletin options within the admin select User Registration Options.

- Select No for allowing new registration.

- Within Languages & Phrases, search for 

        registration has been disabled by the administrator
        
- Change this to reflect a more appropriate message regarding the location of the
        registration within the Geo installation.
        
- This is all that is required to force registrations to take place within the 
Geo installation.

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%


ADVANCED SETUP

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

- There is no way to consistently keep modifications that will work within the 
Vbulletin code.  If you wish to only use the Geodesic Solutions installations to 
login, update user info, register and logout users.  If you wish to do this you 
will have to make a few text(phrase) and template changes to point login, logout 
and register links back to the Geodesic Solutions installation.

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

Search for "log out" within "Search in Phrases" of the "Languages & Phrases" 
section of the vbulletin admin.  Change the link in the following:
- logout_missing_userid
- nopermission_loggedin

        ###############################################
        For logout_missing_userid the text will be something similar to:

        An error occurred while attempting to log you out. <a href="login.php?$session[sessionurl]
        do=logout&amp;u=$bbuserinfo[userid]">Click here to log out.</a>

        A sample change would be:

        For Auctions and root file of auctions.php:
        An error occurred while attempting to log you out. <a href="http://www.yoursite.com/auctions.php?a=1017">
        Click here to logout.</a>

        For Classifieds and root file of classifieds.php:
        An error occurred while attempting to log you out. <a href="http://www.yoursite.com/classifieds.php?a=17">
        Click here to logout.</a>

        NOTE: If the root file is index.php or something else that you have set change the links above accordingly.
        ###############################################

        ###############################################
        For nopermission_loggedin the text will be something similar to:

        <p><strong>$bbuserinfo[username]</strong>, you do not have permission to access this page. This could be due to one of several reasons:</p> 
        <ol> <li>Your user account may not have sufficient privileges to access this page. Are you trying to edit someone else's post, access administrative 
        features or some other privileged system?</li> <li>If you are trying to post, the administrator may have disabled your account, or it may be awaiting 
        activation.</li> </ol> <div align="$stylevar[right]"> <a href="login.php?$session[sessionurl]do=logout&amp;u=$bbuserinfo[userid]">Log Out</a> 
        <a href="$vboptions[forumhome].php?$session[sessionurl]">Home</a> </div>

        For Auctions and root file of auctions.php:
        <p><strong>$bbuserinfo[username]</strong>, you do not have permission to access this page. This could be due to one of several reasons:</p> 
        <ol> <li>Your user account may not have sufficient privileges to access this page. Are you trying to edit someone else's post, access administrative 
        features or some other privileged system?</li> <li>If you are trying to post, the administrator may have disabled your account, or it may be awaiting 
        activation.</li> </ol> <div align="$stylevar[right]"> <a href="http://www.yoursite.com/auctions.php?a=1017">Log Out</a> 
        <a href="$vboptions[forumhome].php?$session[sessionurl]">Home</a> </div>

        For Classifieds and root file of classifieds.php:
        <p><strong>$bbuserinfo[username]</strong>, you do not have permission to access this page. This could be due to one of several reasons:</p> 
        <ol> <li>Your user account may not have sufficient privileges to access this page. Are you trying to edit someone else's post, access administrative 
        features or some other privileged system?</li> <li>If you are trying to post, the administrator may have disabled your account, or it may be awaiting 
        activation.</li> </ol> <div align="$stylevar[right]"> <a href="http://www.yoursite.com/classifieds.php?a=17">Log Out</a> 
        <a href="$vboptions[forumhome].php?$session[sessionurl]">Home</a> </div>

        NOTE: If the root file is index.php or something else that you have set change the links above accordingly.
        ###############################################

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

Search in Templates for:log_out

There will be three parts to Customize: FORUMHOME, navbar, and username_loggedin

        ###############################################
        - For FORUMHOME click [Customize]

        - Within the text area look for the following code:
                        <!-- member logout -->
                        <td align="$stylevar[right]"><a href="login.php?$session[sessionurl]do=logout&amp;u=$bbuserinfo[userid]"  onclick="return log_out()">
                        <phrase 1="$bbuserinfo[username]">$vbphrase[log_out_x]</phrase></a></td>
                        <!-- end member logout -->
        - Change it accordingly (Below is only a sample for auctions so apply necessary root file names per your product):
                        <!-- member logout -->
                        <td align="$stylevar[right]"><a href="http://www.yoursite.com/auctions.php?a=1017">
                        <phrase 1="$bbuserinfo[username]">$vbphrase[log_out_x]</phrase></a></td>
                        <!-- end member logout -->
        ###############################################
        ############################################### 
        - For navbar click [Customize]

        - Within the text area look for the following code:
                        <!--<span style="float:$stylevar[right]">[<a href="login.php?$session[sessionurl]do=logout&amp;u=$bbuserinfo[userid]" 
                        onclick="return log_out()">$vbphrase[log_out]</a>]</span>-->
        - Change it accordingly (Below is only a sample for auctions so apply necessary root file names per your product):
                        <!--<span style="float:$stylevar[right]">[<a href="http://www.yoursite.com/auctions.php?a=1017">$vbphrase[log_out]</a>]</span>-->
        - Within the same text area look for the following code:
                        <if condition="$bbuserinfo['userid']">
                                <td class="vbmenu_control"><a href="login.php?$session[sessionurl]do=logout&amp;u=$bbuserinfo[userid]" onclick="return log_out()">$vbphrase[log_out]</a></td>
                        </if>
        - Change it accordingly (Below is only a sample for auctions so apply necessary root file names per your product):
                        <if condition="$bbuserinfo['userid']">
                                <td class="vbmenu_control"><a href="http://www.yoursite.com/auctions.php?a=1017">$vbphrase[log_out]</a></td>
                        </if>
        ###############################################
        ###############################################         
        - For username_loggedin click [Customize]

        - Within the text area look for the following code:
                        <span class="smallfont"><a href="login.php?$session[sessionurl]do=logout&amp;u=$bbuserinfo[userid]">$vbphrase[log_out]</a></span>
        - Change it accordingly (Below is only a sample for auctions so apply necessary root file names per your product):
                        <span class="smallfont"><a href="http://www.yoursite.com/auctions.php?a=1017">$vbphrase[log_out]</a></span>
        ###############################################



%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

***Apply the same exact steps as above for log in and register.***

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%


- The advanced scenario would be to only use one Geodesic Solutions software 
installation as the lead or dominant installation.  You would use the login,
register, user info update and logout from this one installation.  Removing links 
to these facilities within the other installations or redirecting them to the
lead or dominant installation would insure the most reliable relationship 
between all installations connected by the bridge. However, most seem to want registration
to be centralized and logging in and out to be independent. This is also,
a much simpler set up.

- There is currently no way to modify Vbulletin profile information settings 
through the bridge or current Geodesic Solutions installations.

- No password history support.

- 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 of Geodesic Solutions Software you have will that versions email 
banning facility be used.

- Only the Geodesic Solutions installation email verification system 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.
1)
Such as when a new user registers, an existing user edits the user information, or a user changes the password.
addons/bridge/vbulletin.1254173714.txt.gz · Last modified: 2014/09/25 16:55 (external edit)