Installing Vlogin
=================

1) Start with untaring the file into the plugins directory.
Here is a example for the 3.1 version of the vlogin plugin.

  $ cd plugins
  $ tar -zxvf vlogin-3.1.tar.gz

2) Change into the vlogin directory, copy config.php.sample
   to config.php and edit config.php, making adjustments as 
   you deem necessary.  For more detailed explanations about 
   each of these parameters, consult the README file.

  $ cd vlogin
  $ cp config.php.sample config.php
  $ vi config.php


3) Then go to your config directory and run conf.pl.  Choose
   option 8 and move the plugin from the "Available Plugins"
   category to the "Installed Plugins" category.  Save and exit.

  $ cd ../../config/
  $ ./conf.pl

4) Also, please verify that you have the "compatibility" plugin
   installed.


---------- optional ----------

If you need to change certain settings such as IMAP server, you
may need to apply the session_recall patch to your SquirrelMail 
installation (from the main SquirrelMail directory).  Patches for
SquirrelMail versions 1.2.9 through 1.4.0 are included with vlogin.

  $ patch -p0 -l < plugins/vlogin/session_recall/squirrelmail-1.2.11-session_recall.diff

Note that if you have version 1.2.9, 1.2.10 or 1.4.0, change that
last command to use the correct .diff file.

If the output of this command indicates any FAILUREs, you probably 
have some non-standard/modified source code; we can work together 
to get your version patched - just send an email.

---------- optional ----------

