4images Forum & Community

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:

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:

//-----------------------------------------------------
//--- 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:

include(ROOT_PATH.'global_usefulstuff.php');

Step 4. includes/sessions.php

Locate somewhere around line 178:

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

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

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

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

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

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


Step 5. includes/page_header.php

Locate:

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

"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:

// Include default languages
Add following code before:

// 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:

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

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

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

<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):

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

// 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:

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

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

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

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

Locate:

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

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

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

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

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

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