Installing The Server Settings Plugin
=====================================

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

  $ cd plugins
  $ tar -zxvf server_settings-1.0-1.4.0.tar.gz

2) Decide if you want to store the plugin configuration file
   in the plugin directory or in the main SquirrelMail config
   directory.

   A) To store the configuration file in the plugin directory,
      change into the server_settings directory and choose the
      desired example configuration file - this depends on what
      backend you'll be using, but also note that you can use
      as many backends as needed - you may freely mix and match
      the different example configuration files.  Copy the
      configuration file (the example below assumes the SQL-
      based examples are desired) to config.php and edit config.php,
      making adjustments as you deem necessary.

     $ cd server_settings
     $ cp config_example_sql.php config.php
     $ vi config.php

   B) To store the configuration file in the main SquirrelMail
      config directory, change into the server_settings directory
      and choose the desired example configuration file - this
      depends on what backend you'll be using, but also note that
      you can use as many backends as needed - you may freely mix
      and match the different example configuration files.  Copy
      the configuration file (the example below assumes the SQL-
      based examples are desired) to
      ../../config/config_server_settings.php and edit
      ../../config/config_server_settings.php, making adjustments
      as you deem necessary.

     $ cd server_settings
     $ cp config_example_sql.php ../../config/config_server_settings.php
     $ vi ../../config/config_server_settings.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, if not being used with SquirrelMail 1.4.10+ or 1.5.2+,
   please verify that you have the "Compatibility" plugin
   installed (but not necessarily activated).

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

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



Upgrading Server Settings
=========================

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

  $ cd plugins
  $ tar -zxvf server_settings-1.0-1.4.0.tar.gz

2) Change into the server_settings directory and 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.  Note that this may be difficult with
   the Server Settings plugin given the large number of
   possible configuration settings, and may be best done
   by hand.

  $ diff -u config.php config_example_sql.php

   If you store your configuration file in the main SquirrelMail
   config directory, adjust this command as follows:

  $ diff -u ../../config/config_server_settings.php config_example_sql.php

   Or simply replace your configuration file with the provided
   example and reconfigure the plugin from scratch (see step two
   under the installation procedure above).


