[MOD] Bridge: 4images 1.7.7 - vBulletin 3.8.3+ and 4.0.2

[denisnovikov]

Last update: 04 Mar 2010: known to work without any additional tuning with latest vBulletin 4.0.2

Index

• Introduction
• Demo
• List of changed files
• Installation
• Notes
• Known issues
• Version history
• Extras
• Merging with other Mods

Introduction

This mod allows to use both 4images and vBulletin application transparently for users as they are one application. Registration and login are handling by the vBulletin app, users are creating into 4images database “on-the-fly”, on logged in user first request any of the 4images pages.


Demo

Thanks to Nicky for hosting live demo at:
httpx://www.nicky.net/demo/4images/
httpx://www.nicky.net/demo/vBulletin/
Updated: 4images 1.7.7 + vBulletin 4.0.2

List of changed files

New files:
   includes/vb.php
   global_usefulstuff.php

Modified:
   config.php
   global.php
   includes/sessions.php
   includes/page_header.php
   admin/admin_global.php
   admin/index.php
   templates/default/user_loginform.html


Installation

Step 1. New files

Download new files (newfiles.zip) and place them:
   a) vb.php into includes directory;
   b) global_usefulstuff.php into root directory of the 4images installation

Step 2. config.php

Add at the end of the file, before “?>” symbols:

Code: [Select]

define('VBULLETIN3_BRIDGE_ON', true);
define('VBULLETIN3_PATH', realpath(realpath(dirname(__FILE__)).'<vb_root>').'/');
define('VBULLETIN3_URL', '<vb_url>');

Where:
<vb_root> is relative path from the 4images’ root to vBulletin root. For example, if you have installed both apps at the same directory on your server and your vBulletin is located into ‘vBulletin’ directory (as it done at the Nicky’s server), type there: “/../vBulletin/” (without quotes). Note, on some servers small and caps letters are differ, so put it exactly as it named.
<vb_url> is your vBulletin installation relative to the root of server url, as users type it’s address in their web-browsers. Back to the Nicky’s installation, it should be “/vBulletin/” (again without quotes).


Step 3. global.php

Locate:

Code: [Select]

//-----------------------------------------------------
//--- Useful Stuff ------------------------------------
//-----------------------------------------------------
...
...
tons of code here
...
...
//-----------------------------------------------------
//--- Start DB ----------------------------------------
//-----------------------------------------------------
Remove everything between these two sections (“Useful Stuff” and “Start DB”) and a following code instead of deleted lines:

Code: [Select]

include(ROOT_PATH.'global_usefulstuff.php');

Step 4. includes/sessions.php

Locate somewhere around line 178:

Code: [Select]

function login($user_name = "", $user_password = "", $auto_login = 0, $set_auto_login = 1) {
Replace with:

Code: [Select]

function login($user_name = "", $user_password = "", $auto_login = 0, $set_auto_login = 1, $do_md5 = true) {
Locate somewhere around line 191:

Code: [Select]

$user_password = md5($user_password);
Replace with:

Code: [Select]

if($do_md5 == true) $user_password = md5($user_password);
Locate somewhere around line 418:

Code: [Select]

// Get Userinfo
$session_info = $site_sess->return_session_info();
$user_info = $site_sess->return_user_info();
Add following code after:

Code: [Select]

include_once(realpath(dirname(__FILE__)).'/vb.php');


Step 5. includes/page_header.php

Locate:

Code: [Select]

Copyright &copy; 2002-'.date('Y').' <a href="http://www.4homepages.de" target="_blank">4homepages.de</a>
</p>
',
Add following code right after:

Code: [Select]

"login_user_name_form_field" => (!empty($login_user_name_form_field)) ? $login_user_name_form_field : 'user_name',
"login_user_password_form_field" => (!empty($login_user_password_form_field)) ? $login_user_password_form_field : 'user_password',
"login_auto_form_field" => (!empty($login_auto_form_field)) ? $login_auto_form_field : 'auto_login',
"login_additional_form_fields" => (!empty($login_additional_form_fields)) ? $login_additional_form_fields : '',

Step 6. admin/admin_global.php

Locate:

Code: [Select]

// Include default languages
Add following code before:

Code: [Select]

// Default form
$login_admin_form_action = $site_sess->url(ROOT_PATH."admin/index.php");;
$login_admin_name_form_field = 'loginusername';
$login_admin_password_form_field = 'loginpassword';
$login_admin_additional_form_fields = '';

// Overwrite form if necessary
if(defined('VBULLETIN3_BRIDGE_ON') && VBULLETIN3_BRIDGE_ON === true){
$login_admin_form_action = $site_sess->url(VBULLETIN3_URL."login.php?do=login");
$login_admin_name_form_field = 'vb_login_username';
$login_admin_password_form_field = 'vb_login_password';
$login_admin_additional_form_fields = '<input type="hidden" name="do" value="login" />';
}


Locate:

Code: [Select]

<form action="<?php echo $site_sess->url(ROOT_PATH."admin/index.php"); ?>" method="post">
Replace with:

Code: [Select]

<form action="<?php echo $login_admin_form_action; ?>" method="post">
<?php echo $login_admin_additional_form_fields; ?>
Locate:

Code: [Select]

<td><input type="text" name="loginusername" size="<?php echo $textinput_size2; ?>"></td>
<td><input type="password" name="loginpassword" size="<?php echo $textinput_size2; ?>"></td>
Replace with:

Code: [Select]

<td><input type="text" name="<?php echo $login_admin_name_form_field; ?>" size="<?php echo $textinput_size2; ?>"></td>
<td><input type="password" name="<?php echo $login_admin_password_form_field; ?>" size="<?php echo $textinput_size2; ?>"></td>

Step 7. admin/index.php

Locate (at around lines 60-70):

Code: [Select]

if ($action == "head") {
?>
<html dir="<?php echo $lang['direction']; ?>">
Add following code right before "?>" symbols:

Code: [Select]

// switch back admin logout url if no integration
if(!defined('VBULLETIN3_BRIDGE_ON') || VBULLETIN3_BRIDGE_ON !== true){
$url_logout = $site_sess->url(ROOT_PATH."admin/index.php?logout=1");
}
Locate:

Code: [Select]

<td align="right"><b><a href="<?php echo $site_sess->url(ROOT_PATH."index.php"); ?>" target="_blank"><?php echo $lang['goto_homepage']; ?></a>&nbsp;|&nbsp;<a href="<?php echo $site_sess->url(ROOT_PATH."admin/index.php?logout=1"); ?>" target="_top"><?php echo $lang['logout']; ?></a>&nbsp;&nbsp;</b></TD>
Replace with:

Code: [Select]

<td align="right"><b><a href="<?php echo $site_sess->url(ROOT_PATH."index.php"); ?>" target="_blank"><?php echo $lang['goto_homepage']; ?></a>&nbsp;|&nbsp;<a href="<?php echo $url_logout; ?>" target="_top"><?php echo $lang['logout']; ?></a>&nbsp;&nbsp;</b></TD>

Step 8. templates/default/user_loginform.html

Locate:

Code: [Select]

<input type="text" size="10" name="user_name" class="logininput" />
Replace with:

Code: [Select]

<input type="text" size="10" name="{login_user_name_form_field}" class="logininput" />

Locate:

Code: [Select]

<input type="password" size="10" name="user_password" class="logininput" />
Replace with:

Code: [Select]

<input type="password" size="10" name="{login_user_password_form_field}" class="logininput" />
{login_additional_form_fields}
Locate:

Code: [Select]

<td><input type="checkbox" name="auto_login" value="1" /></td>
Replace with:

Code: [Select]

<td><input type="checkbox" name="{login_auto_form_field}" value="1" /></td>

Notes

Please make sure when installing applications you have admin account on both 4images and vBulletin apps with the same user name and password.


Known issues

When switching bridge off users can’t login to 4images anymore from the native 4images form. However they still exists in 4images database and could request for new password.


Version history

0.1 - initial release
0.2 - security fix (thanks to nic_bck for reporting: http://www.4homepages.de/forum/index.php?topic=23892.msg132782#msg132782)
0.3 - upgraded to 4images 1.7.7; doesn't let user which is not confirmed his email login into 4images -- only his own CP panel on vBulletin.
0.4 - now all default templates from 4images 1.7.7 are bridge ready (modded.zip, newfiles.zip); when user changes his email in vBulletin on the next login it will be updated into 4images also (thanks to Sun); now after user registered at vBulletin his join date will be also transferred as soon as he will come to 4images (thanks again to Sun); tested with vBulletin 3.8.4
0.5 - fix for the changed user's email was not actually updated into 4images DB.
0.6 - additional condition before change email: user has to have proper vBulletin session so when user logging out of vBulletin and refreshing 4images page his email will not be changed to the empty string (thanks Sun for reporting).

Extras

Users, who already have installed 4images and have users in it, can download userexport.php (attached to post - ue.zip), place it into root directory of 4image after installing bridge and run it from the browser. Existing 4images users should appear now in vBulletin.

Download already modded 4images 1.7.7 archive (attached to post modded.zip).

Download this instruction in printer friendly pdf (attached to post - bridge-step-by-step.pdf).


Please feel free to post bugs/questions/etc. here or via pm. Languages accepted: Russian, English.

Have fun


Merging with other Mods

[MOD] Language select & [MOD] Multi-Language support for any text
http://www.4homepages.de/forum/index.php?topic=4743.0
http://www.4homepages.de/forum/index.php?topic=6749.0

Known problem: doesn't work simultaneously with Bridge.

Fix:

Find in includes/sessions.php:

Code: [Select]

include_once(realpath(dirname(__FILE__)).'/vb.php');
Replace with:

Code: [Select]

$temporaryLanguage = $l;
include_once(realpath(dirname(__FILE__)).'/vb.php');
$l = $temporaryLanguage;


[mawenzi]

hi denis ...

... thanks for sharing this modification for using 4images and vBulletin ...
... and what a great stuff ... installations instructions as pdf-files ... 

[denisnovikov]

hi denis ...

... thanks for sharing this modification for using 4images and vBulletin ...
... and what a great stuff ... installations instructions as pdf-files ... 

Hi, it was not a problem to export to pdf as I was writing this text in gui editor, not right in the form on board Or do you mean it's bad to post pdfs?

Edit: thanks for moving into releases!

[mawenzi]

... as I said ... a great stuff ... and a new standard for mod publication ... !
... thanks again ...

[Nicky]

hi denis,

thank you for posting this bridge. great thing!
notice to the users: it was tested with 4images 1.7.6 and vBulletin 3.7.4 up to 3.8.0

[V@no]

I'm sorry I didn't pay attention to the beta testing of this mod, but now I have two questions:
1. what is the point of step 3?
2. can we have a separate package with only needed (new) files, so people don't need download 1.4mb file just for these two files.

P.S.
Since this mod is pretty much vB version dependent, the vB version should be mentioned if not in the title, then at least in the original instructions

[denisnovikov]

1. what is the point of step 3?

Some magic I realized this part of "globals" should be reloaded after initializing vBulletin core

2. can we have a separate package with only needed (new) files, so people don't need download 1.4mb file just for these two files.

Yeah, sure! My fault! Thanks!

Since this mod is pretty much vB version dependent, the vB version should be mentioned if not in the title, then at least in the original instructions

Dunno how much it depended on vBulletin version, did you try install it with other than 3.7.4 .. 3.8.0 versions?

[Dblockn05]

Very nice mod, I will be installing it this afternoon.  Do you plan on releasing it on vbulletin.org?  A lot of members are probably eager for this.

Hella thanks for taking your time to do this.

[denisnovikov]

Very nice mod, I will be installing it this afternoon.  Do you plan on releasing it on vbulletin.org?  A lot of members are probably eager for this.

Hella thanks for taking your time to do this.

Thanks, please feel free to report bugs
As for releasing it on vBulletin forums, maybe later a bit

[kirby]

Thank you, been waiting for this one for a while, very easy to follow

But is there a way to show "Last X posts" on the 4images gallery main page?

[denisnovikov]

Thank you, been waiting for this one for a while, very easy to follow

But is there a way to show "Last X posts" on the 4images gallery main page?

Thanks to you for using it

Yes, guess it's possible to extend vb.php so it will have this info also somewhere in usersession. Will see later 

[kirby]

Thank you, been waiting for this one for a while, very easy to follow

But is there a way to show "Last X posts" on the 4images gallery main page?

Thanks to you for using it

Yes, guess it's possible to extend vb.php so it will have this info also somewhere in usersession. Will see later 

Well thanks in advance even just as it is, this is definitly my fav mod 

[riansyah]

Hello,

I have the problem.

when I register a new member and then i'm login then show this error

An unexpected error occured. Please try again later.

Warning: Cannot modify header information - headers already sent by (output started at C:\AppServ\www\4images\includes\db_mysql.php:192) in C:\AppServ\www\4images\includes\functions.php on line 114

then i check my database user 4images, it's not be added a new user on 4images users tables and only added on vbulletin user tables

anyone help me..


Regards
riansyah

[Nicky]

hi,

this is strange,

because, i tested it on xampp(windows) and like you can see it on our demo page which is on linux.

i have to mentioned it, that it was tested without any mods on both sides.

[denisnovikov]

Hello,

I have the problem.

when I register a new member and then i'm login then show this error

An unexpected error occured. Please try again later.

Warning: Cannot modify header information - headers already sent by (output started at C:\AppServ\www\4images\includes\db_mysql.php:192) in C:\AppServ\www\4images\includes\functions.php on line 114

then i check my database user 4images, it's not be added a new user on 4images users tables and only added on vbulletin user tables

anyone help me..


Regards
riansyah

Hi, can you switch bridge off and see if 4images installation works standalone? I guess problem is somewhere in your settings/configurations.