Installing the Multilogin Plugin
=================================

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

  $ cd plugins
  $ tar -zxvf multilogin-1.0-1.2.9.tar.gz

2) Change into the multilogin directory, copy config.sample.php
   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 multilogin
  $ cp config.sample.php config.php
  $ vi config.php

3) If using SquirrelMail 1.5.2 or above, skip to step 5.  Otherwise,
   continue to step 4.

4) Patch your SquirrelMail source code - a new plugin hook 
   is necessary for this plugin, and it can easily be added 
   to most SquirrelMail versions.  Make sure you use the 
   patch file that pertains to your version (or the closest 
   one available) of SquirrelMail.

  $ patch -p0 < patches/multilogin-squirrelmail-1.4.12.diff

   Note for Windows users: you can get native patch functionality
   by installing this very useful package:   
   http://unxutils.sourceforge.net/

5) 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 (unless you 
   are only installing Multilogin for use with Vlogin).  Save 
   and exit.

  $ cd config/
  $ ./conf.pl

6) Translations are not included in this package.  To get a
   translation, download the language pack needed from:

       http://www.squirrelmail.org/download.php



Upgrading Multilogin
====================

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

  $ cd plugins
  $ tar -zxvf multilogin-1.0-1.2.9.tar.gz

2) Change into the multilogin directory, check your config.php
   file against the new version, to see if there are any new
   settings that you must add to your config.php file.

  $ diff -u config.php config.sample.php

   Or simply replace your config.php file with the provided sample
   and reconfigure the plugin from scratch (see step 2 under the
   installation procedure above).

3) You never need to patch SquirrelMail again if you've done it 
   once before (or unless the release notes/changelog say otherwise).


