4images Modifications / Modifikationen > Mods & Plugins (Releases & Support)

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

(1/28) > >>

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: ---define('VBULLETIN3_BRIDGE_ON', true);
define('VBULLETIN3_PATH', realpath(realpath(dirname(__FILE__)).'<vb_root>').'/');
define('VBULLETIN3_URL', '<vb_url>');

--- End code ---

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: ---//-----------------------------------------------------
//--- Useful Stuff ------------------------------------
//-----------------------------------------------------
...
...
tons of code here
...
...
//-----------------------------------------------------
//--- Start DB ----------------------------------------
//-----------------------------------------------------
--- End code ---

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


--- Code: ---include(ROOT_PATH.'global_usefulstuff.php');
--- End code ---


Step 4. includes/sessions.php

Locate somewhere around line 178:


--- Code: ---function login($user_name = "", $user_password = "", $auto_login = 0, $set_auto_login = 1) {
--- End code ---

Replace with:


--- Code: ---function login($user_name = "", $user_password = "", $auto_login = 0, $set_auto_login = 1, $do_md5 = true) {
--- End code ---

Locate somewhere around line 191:


--- Code: ---$user_password = md5($user_password);
--- End code ---

Replace with:


--- Code: ---if($do_md5 == true) $user_password = md5($user_password);
--- End code ---

Locate somewhere around line 418:


--- Code: ---// Get Userinfo
$session_info = $site_sess->return_session_info();
$user_info = $site_sess->return_user_info();
--- End code ---

Add following code after:


--- Code: ---include_once(realpath(dirname(__FILE__)).'/vb.php');
--- End code ---



Step 5. includes/page_header.php

Locate:


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

Add following code right after:


--- Code: ---"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 : '',
--- End code ---


Step 6. admin/admin_global.php

Locate:


--- Code: ---// Include default languages
--- End code ---

Add following code before:


--- Code: ---// 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" />';
}
--- End code ---



Locate:


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

Replace with:


--- Code: ---<form action="<?php echo $login_admin_form_action; ?>" method="post">
<?php echo $login_admin_additional_form_fields; ?>
--- End code ---

Locate:


--- Code: ---<td><input type="text" name="loginusername" size="<?php echo $textinput_size2; ?>"></td>
<td><input type="password" name="loginpassword" size="<?php echo $textinput_size2; ?>"></td>
--- End code ---

Replace with:


--- Code: ---<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>
--- End code ---


Step 7. admin/index.php

Locate (at around lines 60-70):


--- Code: ---if ($action == "head") {
?>
<html dir="<?php echo $lang['direction']; ?>">
--- End code ---

Add following code right before "?>" symbols:


--- Code: ---// 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");
}
--- End code ---

Locate:


--- Code: ---<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>
--- End code ---

Replace with:


--- Code: ---<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>
--- End code ---


Step 8. templates/default/user_loginform.html

Locate:


--- Code: ---<input type="text" size="10" name="user_name" class="logininput" />
--- End code ---

Replace with:


--- Code: ---<input type="text" size="10" name="{login_user_name_form_field}" class="logininput" />
--- End code ---


Locate:


--- Code: ---<input type="password" size="10" name="user_password" class="logininput" />
--- End code ---

Replace with:


--- Code: ---<input type="password" size="10" name="{login_user_password_form_field}" class="logininput" />
{login_additional_form_fields}
--- End code ---

Locate:


--- Code: ---<td><input type="checkbox" name="auto_login" value="1" /></td>
--- End code ---

Replace with:


--- Code: ---<td><input type="checkbox" name="{login_auto_form_field}" value="1" /></td>
--- End code ---


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: ---include_once(realpath(dirname(__FILE__)).'/vb.php');
--- End code ---

Replace with:


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

--- End code ---

mawenzi:
hi denis ...

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

denisnovikov:

--- Quote from: mawenzi on January 17, 2009, 03:00:10 PM ---hi denis ...

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

--- End quote ---

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

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

Navigation

[0] Message Index

[#] Next page

Go to full version