Index: README.txt
===================================================================
RCS file: /cvs/drupal-contrib/contributions/modules/drupalvb/README.txt,v
retrieving revision 1.16
diff -u -p -r1.16 README.txt
--- README.txt	17 May 2009 15:25:56 -0000	1.16
+++ README.txt	29 Jul 2009 18:18:16 -0000
@@ -64,29 +64,46 @@ Note: The following steps assume that yo
       you do not, all paths need to be prefixed with 'index.php?q='.  Of course,
       all paths also need to be prefixed with the proper base path of your site.
 
-* To properly logout users from vBulletin and Drupal, you should replace the
-  logout link in your vBulletin template with a link pointing to '/logout'
-  (i.e. Drupal's logout URL), so the user is logged off from both systems.
-
-  However, if you are using the singlesignon module, or your users are reporting
-  login issues (f.e. being logged in in the forums, but not in Drupal), then you
-  should replace all logout links throughout Drupal and vBulletin to point to
-  'drupalvb/logout', which performs additional actions to ensure that a user is
-  properly logged out.
-
-* To login users concurrently in Drupal and vBulletin, you should remove the
-  user login form in your vBulletin template and point users to Drupal's
-  login page.
-
-  Alternatively, you can also alter the "action" attribute of the user login
-  forms in your vBulletin forum templates to submit those forms to
-  'drupalvb/login'.  However, in this case you also have to ensure that
-  vBulletin's JavaScript to md5-hash the typed password are not applied to the
-  password form field.
+To properly login, logout, and synchronize users between vBulletin and Drupal,
+
+* open vBulletin's includes/config.php file and
+
+  - ensure that, when connecting via MySQLi, the 'charset' option is configured
+    as following:
+
+      $config['Mysqli']['charset'] = 'utf8';
+
+  - append the following to disable password MD5-hashing via JavaScript:
+
+      /**
+       * DrupalvB: Disable MD5-hashing of passwords via JavaScript.
+       */
+      define('DISABLE_PASSWORD_CLEARING', TRUE);
+
+* log in to vBulletin's AdminCP, go to
+
+    Styles & Templates >> Replacement Variable Manager
+
+  and add the following replacement variables for your template:
+
+  - login.php?do=login           => /drupalvb/login
+
+  - login.php?do=logout          => /drupalvb/logout?
+
+    (The trailing question mark is required.)
+
+  - login.php?do=lostpw          => /user/password
+
+  - register.php                 => /user/register
+
+  Optionally, if http://drupal.org/project/me is installed or a custom redirect
+  has been implemented, you can also add (or similar):
+
+  - profile.php?do=editpassword  => /user/me/edit
 
 
 * If you want to run your forums on a subdomain, f.e. forums.example.com rather
-  than example.com/forums, you need to use a common cookie domain for both
+  than example.com/forums, then you need to use a common cookie domain for both
   domains.
 
   WARNING: A wrongly defined cookie domain can lead to a completely broken user
@@ -101,7 +118,7 @@ Note: The following steps assume that yo
 
   select your domain without the subdomain (i.e. example.com), and save.
 
-  In Drupal settings.php, find the section about cookie domain determination
+  In Drupal's settings.php, find the section about cookie domain determination
   (around line 150), and un-comment the following line (replacing 'example.com'
   with your domain):