Installing Restrict Senders
===========================

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

  $ cd plugins
  $ tar -zxvf restrict_senders-1.0-1.4.1.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 restrict_senders/data directory, copy
      config_example.php to config.php and edit config.php,
      making adjustments as you deem necessary.  See the
      README file for more information.

     $ cd restrict_senders/data
     $ cp config_example.php config.php
     $ vi config.php

   B) To store the configuration file in the main SquirrelMail
      config directory, change into the restrict_senders/data
      directory, copy config_example.php to
      ../../../config/config_restrict_senders.php and edit
      ../../../config/config_restrict_senders.php, making
      adjustments as you deem necessary.  See the README
      file for more information.

     $ cd restrict_senders/data
     $ cp config_example.php ../../../config/config_restrict_senders.php
     $ vi ../../../config/config_restrict_senders.php

3) If you will be using sender restriction rules, decide if
   you want to store the sender restrictions rules file in
   the plugin directory or in the main SquirrelMail config
   directory.  This step is only necessary if you need this 
   functionality and have turned on $restrictDomains 
   in the main Restrict Senders configuration file.

   A) To store the sender restriction rules file in the plugin
      directory, copy send_restrictions_example.php to
      send_restrictions.php and edit send_restrictions.php to
      build your custom recipient rules, if needed.

     ---- optional ----
     $ cp send_restrictions_example.php send_restrictions.php
     $ vi send_restrictions.php
     ---- optional ----

   B) To store the sender restriction rules file in the main
      SquirrelMail config directory, copy
      send_restrictions_example.php to
      ../../../config/send_restrictions.php and edit
      ../../../config/send_restrictions.php to build your
      custom recipient rules, if needed.

     ---- optional ----
     $ cp send_restrictions_example.php ../../../config/send_restrictions.php
     $ vi ../../../config/send_restrictions.php
     ---- optional ----

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 (but not necessarily activated).

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 Restrict Senders
==========================

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

  $ cd plugins
  $ tar -zxvf restrict_senders-1.0-1.4.1.tar.gz

2) Change into the restrict_senders/data directory and check 
   your send_restrictions.php and config.php files against 
   the new versions to see if there are any new settings 
   that you must add.

  $ cd restrict_senders/data
  $ diff -u send_restrictions.php send_restrictions_example.php
  $ diff -u config.php config_example.php

   If you store your configuration files in the main SquirrelMail
   config directory, adjust these commands as follows:

  $ diff -u ../../../config/config_restrict_senders.php config_example.php
  $ diff -u ../../../config/send_restrictions.php send_restrictions_example.php

   Or simply replace your send_restrictions.php and config.php 
   files with the provided examples and reconfigure the plugin 
   from scratch (see steps 2 and 3 under the installation
   procedure above).

