Installing Empty Folders
========================

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

  $ cd plugins
  $ tar -zxvf empty_folders-1.0.tar.gz

2) Determine your SquirrelMail version and follow the steps
   according to your version:

   SquirrelMail 1.4.1 up to but not including 1.5.0
   SquirrelMail 1.5.1 and up
   ================================================
   Skip to step number 3


   SquirrelMail 1.5.0
   ==================
   Copy the included file on top of your original (making a backup first):

  $ cp ../src/left_main.php ../src/left_main.php.bak
  $ cp empty_folders/source_files/left_main.php-1.5.0 ../src/left_main.php


   SquirrelMail 1.2.x
   SquirrelMail 1.4.0
   ==================
   Remaining in the plugins directory, you may do one of the following
   two things:

     A) This is the recommended method, which guarantees you will not
        lose any other changes you may have made to your SquirrelMail
        installation.  Run the following command to patch your
        SquirrelMail source code for this plugin:

       $ patch -p0 < empty_folders/patches/empty_folders_patch_squirrelmail-1.4.0.diff

        Note that if you have version 1.2.x, change that last command to use the
        correct .diff file (currently, 1.2.11 diff file should work with most
        SquirrelMail 1.2.x versions).

        If the output of this command indicates any FAILUREs, you either
        need to update the patch utility on your system or you have some
        non-standard/modified SquirrelMail source code; we can work together
        to get your version patched - just send an email.

     B) If you are certain you have an unmodified SquirrelMail installation
        or are having problems with the patch command above, you may use the
        provided pre-patched source file by running this command:

       $ cp empty_folders/source_files/left_main.php-1.4.0 ../src/left_main.php
       cp: overwrite `../src/left_main.php'? y

        Note that if you have version 1.2.x, change that last command to use the
        correct file (currently, 1.2.11 file should work with most SquirrelMail
        1.2.x versions).

3) Change into the empty_folders directory, copy config.php.sample
   to config.php and edit config.php, making adjustments as
   you deem necessary.

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

4) 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

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



Upgrading Empty Folders
=======================

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

  $ cd plugins
  $ tar -zxvf empty_folders-1.0.tar.gz

2) Change into the empty_folders 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 -Nau config.php config.php.sample

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

