VBulletin Bridge [Geodesic Solutions Community Wiki]

Steps inside vBulletin Admin

Since this bridge is one-way, changes made to user details¹⁾ 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.

Within the VBulletin admin, go to vBulletin Options > vBulletin Options, and select User Registration Options. <
For the setting Allow New User Registrations select no. <
In the admin, go to Languages & Phrases > Search in Phrases. <
Use the tool to search for "noregister" (without the quotes), and select the option for "Phrase Variable Name Only" <
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. <
Save the changes. <

Convert Logout Links

Within the vBulletin text, you will need to change all the log-out links to "point" to your geo installation location, the URL would end in²⁾

index.php?a=17

The general idea, is to search for "logout", "log out", and "log_out" in all languages & phrases, and within the templates in vBulletin, and alter the links to point to the Geo installation as described above. Below are specific instructions for each link found as of the last time this document was last updated.

Logout link in logout_error text:

In admin panel at Languages & Phrases > Search in Phrases, for the text logout_error, and selecting the option for Phrase Variable Name Only, then click find. <
Click edit next to the entry that is found. <

The text will be something similar to:

An error occurred while attempting to log you out. <a href="login.php?{1}do=logout&amp;logouthash={2}">Click here to log out.</a>

Change the URL logout link, so it looks something like this³⁾:

An error occurred while attempting to log you out. <a href="http://example.com/listings/index.php?a=17">Click here to logout.</a>

Logout link in nopermission_loggedin text:

In admin panel at Languages & Phrases > Search in Phrases, for the text nopermission_loggedin, and selecting the option for Phrase Variable Name Only, then click find. <
Click edit next to the entry that is found. <

The text will be something similar to:

<p><strong>{1}</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="{2}">
<a href="login.php?{3}do=logout&amp;logouthash={4}">Log Out</a>
<a href="{5}.php?{3}">Home</a>
</div>

Change the URL logout link, so it looks something like this⁴⁾:

<p><strong>{1}</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="{2}">
<a href="http://example.com/listings/index.php?a=17">Log Out</a>
<a href="{5}.php?{3}">Home</a>
</div>

Logout link in templates:

In admin panel at Styles & Templates > Search in Templates, for the text log_out.
Double-click on the first found template FORUMHOME. <

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 this⁵⁾:

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

In admin panel at Styles & Templates > Search in Templates, for the text log_out.
Double-click on the found template navbar. <

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 this⁶⁾:

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

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.

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_error (or logout_missing_userid on older versions)
- 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.

¹⁾

Such as when a new user registers, an existing user edits the user information, or a user changes the password.

²⁾

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.

³⁾ , ⁴⁾ , ⁵⁾ , ⁶⁾

change example.php/listings/ to match your Geo installation location

Geodesic Solutions Community Wiki

Sidebar

Table of Contents

VBulletin Bridge

Steps inside vBulletin Admin

Disable Registrations

Convert Logout Links

Legacy Documentation

Geodesic Solutions Community Wiki

User Tools

Site Tools

Sidebar

Table of Contents

VBulletin Bridge

Steps inside vBulletin Admin

Disable Registrations

Convert Logout Links

Legacy Documentation

Page Tools