Installing the Select Range Plugin
==================================

1) Start with untaring the file into the plugins directory.
   Here is a example for the 3.7 version of the Select
   Range plugin.

  $ cd plugins
  $ tar -zxvf select_range-3.7-1.4.4.tar.gz

2) If you want to change the default behavior of the plugin,
   change into the select_range directory, copy
   config.sample.php to config.php and edit config.php,
   making adjustments as you deem necessary.

  ----- optional -----
  $ cd select_range
  $ cp config.sample.php config.php
  $ vi config.php
  ----- optional -----

3) If using SquirrelMail 1.5.2 or above or shift-click
   and better link placement is not needed, skip to step 5.
   Otherwise, continue to step 4.

4) Patch your SquirrelMail source code.  Two simple hooks
   are added to the source for enhanced plugin functionality.
   Make sure you use the patch file that pertains to your
   version (or the closest one available) of SquirrelMail.
   Make sure you execute the patch from the select_range
   plugin directory.

  $ cd select_range
  $ patch -p0 < patch/select_range-squirrelmail_1.4.14.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.  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 Select Range
======================

1) Start with untaring the file into the plugins directory.
   Here is a example for the 3.7 version of the Select
   Range plugin.

  $ cd plugins
  $ tar -zxvf select_range-3.7-1.4.4.tar.gz

2) Change into the select_range 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.  (This step only applies if you have
   created a config.php file under step 2 above when you
   first installed the plugin.)

  $ 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).


