| 1 |
/* $Id: README.txt,v 1.17 2009/08/02 01:23:10 sun Exp $ */
|
| 2 |
|
| 3 |
-- SUMMARY --
|
| 4 |
|
| 5 |
DrupalvB integrates vBulletin forums with Drupal. It allows
|
| 6 |
|
| 7 |
- new and existing vBulletin users to log in to Drupal
|
| 8 |
- existing Drupal users to log in to vBulletin (*)
|
| 9 |
- new Drupal users to log in to vBulletin
|
| 10 |
- single/shared sign-on when logging in via Drupal
|
| 11 |
- updating user data in vBulletin upon update in Drupal
|
| 12 |
- deleting users in vBulletin upon deletion in Drupal
|
| 13 |
|
| 14 |
Unlike vbDrupal (a fork of Drupal), DrupalvB turns Drupal's user-base into the
|
| 15 |
primary user-base (while still allowing existing or new vBulletin forum users
|
| 16 |
to logon with their user data in Drupal) and does not require patches to Drupal
|
| 17 |
core.
|
| 18 |
|
| 19 |
*) requires initial export
|
| 20 |
|
| 21 |
|
| 22 |
For a full description visit the project page:
|
| 23 |
http://drupal.org/project/drupalvb
|
| 24 |
Bug reports, feature suggestions and latest developments:
|
| 25 |
http://drupal.org/project/issues/drupalvb
|
| 26 |
|
| 27 |
|
| 28 |
-- REQUIREMENTS --
|
| 29 |
|
| 30 |
* vBulletin 3.6 or newer (latest confirmed working version was 3.8.x)
|
| 31 |
|
| 32 |
|
| 33 |
-- INSTALLATION --
|
| 34 |
|
| 35 |
* Install as usual, see http://drupal.org/node/70151 for further information.
|
| 36 |
|
| 37 |
* After installing vBulletin, copy config.php from your vBulletin includes/
|
| 38 |
directory into DrupalvB's module folder.
|
| 39 |
|
| 40 |
Please note that you have to update this copy of config.php whenever the
|
| 41 |
original file is altered!
|
| 42 |
|
| 43 |
|
| 44 |
-- CONFIGURATION --
|
| 45 |
|
| 46 |
* Configure DrupalvB's settings in administer >> Site configuration >> DrupalvB.
|
| 47 |
Please note that you *must* supply a database connection, even if it is
|
| 48 |
identical to Drupal's.
|
| 49 |
|
| 50 |
* Enable DrupalvB's blocks in administer >> Site building >> Blocks.
|
| 51 |
|
| 52 |
|
| 53 |
-- IMPLEMENTATION --
|
| 54 |
|
| 55 |
Note: The following steps assume that you are using clean URLs in Drupal. If
|
| 56 |
you do not, all paths need to be prefixed with 'index.php?q='. Of course,
|
| 57 |
all paths also need to be prefixed with the proper base path of your site.
|
| 58 |
|
| 59 |
To properly login, logout, and synchronize users between vBulletin and Drupal,
|
| 60 |
|
| 61 |
* open vBulletin's includes/config.php file and
|
| 62 |
|
| 63 |
- ensure that, when connecting via MySQLi, the 'charset' option is configured
|
| 64 |
as following:
|
| 65 |
|
| 66 |
$config['Mysqli']['charset'] = 'utf8';
|
| 67 |
|
| 68 |
- append the following to disable password MD5-hashing via JavaScript:
|
| 69 |
|
| 70 |
/**
|
| 71 |
* DrupalvB: Disable MD5-hashing of passwords via JavaScript.
|
| 72 |
*/
|
| 73 |
define('DISABLE_PASSWORD_CLEARING', TRUE);
|
| 74 |
|
| 75 |
* log in to vBulletin's AdminCP, go to
|
| 76 |
|
| 77 |
Styles & Templates >> Replacement Variable Manager
|
| 78 |
|
| 79 |
and add the following replacement variables for your template:
|
| 80 |
|
| 81 |
- login.php?do=login => /drupalvb/login
|
| 82 |
|
| 83 |
- login.php?do=logout => /drupalvb/logout?
|
| 84 |
|
| 85 |
(The trailing question mark is required.)
|
| 86 |
|
| 87 |
- login.php?do=lostpw => /user/password
|
| 88 |
|
| 89 |
- register.php => /user/register
|
| 90 |
|
| 91 |
Optionally, if http://drupal.org/project/me is installed or a custom redirect
|
| 92 |
has been implemented, you can also add (or similar):
|
| 93 |
|
| 94 |
- profile.php?do=editpassword => /user/me/edit
|
| 95 |
|
| 96 |
|
| 97 |
* If you want to run your forums on a subdomain, f.e. forums.example.com rather
|
| 98 |
than example.com/forums, then you need to use a common cookie domain for both
|
| 99 |
domains.
|
| 100 |
|
| 101 |
WARNING: A wrongly defined cookie domain can lead to a completely broken user
|
| 102 |
authentication, both in Drupal and vBulletin. If the cookie domain
|
| 103 |
is set to a wrong value, all users are immediately logged out, and
|
| 104 |
can no longer login, including super administrators!
|
| 105 |
|
| 106 |
In vBulletin, go to
|
| 107 |
|
| 108 |
vBulletin Options >> Expand Setting Groups
|
| 109 |
>> Cookies and HTTP Header Options >> Cookie Domain >> Edit Settings
|
| 110 |
|
| 111 |
select your domain without the subdomain (i.e. example.com), and save.
|
| 112 |
|
| 113 |
In Drupal's settings.php, find the section about cookie domain determination
|
| 114 |
(around line 150), and un-comment the following line (replacing 'example.com'
|
| 115 |
with your domain):
|
| 116 |
|
| 117 |
$cookie_domain = 'example.com';
|
| 118 |
|
| 119 |
|
| 120 |
|
| 121 |
-- CONTACT --
|
| 122 |
|
| 123 |
Current maintainers:
|
| 124 |
* Daniel F. Kudwien (sun) - http://drupal.org/user/54136
|
| 125 |
* Stefan M. Kudwien (smk-ka) - http://drupal.org/user/48898
|
| 126 |
|
| 127 |
This project has been sponsored by:
|
| 128 |
* UNLEASHED MIND
|
| 129 |
Specialized in consulting and planning of Drupal powered sites, UNLEASHED
|
| 130 |
MIND offers installation, development, theming, customization, and hosting
|
| 131 |
to get you started. Visit http://www.unleashedmind.com for more information.
|
| 132 |
|
Parent Directory
| 
Revision Log
| 
Revision Graph