    __        __         _   _
    \ \      / /__  __ _| |_| |__   ___ _ __
     \ \ /\ / / _ \/ _` | __| '_ \ / _ \ '__|
      \ V  V /  __/ (_| | |_| | | |  __/ |
       \_/\_/ \___|\__,_|\__|_| |_|\___|_|


----[ Program

    Weather v1.2.1


----[ Lead Developer

    Daniel Hemmerich <dan@spot.org>


----[ Contributors

    Gary Dewrell <dewrell@vvm.com>
    Mike Bush <mike@closedbox.com>
    Avi Schwartz <avi@CFFtechnologies.com>
    Matt Kaminer <matt@kaminer.com>


----[ Home Site

    http://www.spot.org/ and http://www.BSDpro.com/

    Weather avaliable at: http://www.spot.org/code/


----[ Purpose

    Grab a weather graphic from www.accuweather, based on the zip code provided
    by the user, and place it either before or after the folder list on the left
    (or right).


----[ Features

    o The ability to be placed above the folder list, or below the folder list.
    o Automatically detect whether it should be activated or not based on
      whether or not a zip code was entered.
    o Plugin also automatically detects whether the folder width is great enough
      to display the weather graphic. If the folder width is less than 220 pixels,
      the plugin automatically sets it to 220. This feature is only activated if
      a zip code has been entered.
    o Link from the weather graphic to a 5 day forecast.
    o Ability to display a cropped small image, or the standard large image. The
      small image requires a folder width of 140 and the large image requires a
      folder width of 240.
    o Ability to resize the cropped image based on the folder width.


----[ Future Changes

    It has been requested that the modified images created by weather.php be
    cached from one page load to the next given that X amount of time has not
    passed. This is in development in an attempt to save some bandwidth if the
    server has a large userbase.

    Got any ideas or complaints, please e-mail me!


----[ Installation

    To install weather, do what you would do with any other plugin. Decompress
    it in the plugins/ directory, and then run conf.pl in config/ in the base
    squirrelmail directory.

    This plugin requires the GD library (Version 1.6 or higher), as well as PNG
    support for PHP.

    Do not worry, if you have several users and fear that the default is for
    this plugin to be active, it is not. This plugin will only be activated for
    a user if that user enables it in the display options.

    If you have trouble with plugin installation in general, please send an
    e-mail to squirrelmail-plugins@lists.sourceforge.net, after of course reading
    the online documentation.

    If you have an inquery specific to this plugin, feel free to contact me at
    dan@spot.org.


----[ Changelog

    Since this is a small 'program', I have included the Changelog inside the
    README file.

    - November 20, 2001 - version 1.2.1
        o That patch forgot to include the image header for HTTP. This fixes it

    - November 20, 2001 - version 1.2.0
        o Applied a patch supplied by Mike Bush. This used a raw socket to get
          weather information which will be a big help for a lot of users.

    - October 31, 2001 - version 1.1.1
        o Fixed a missing </a> for the weather anchor. This bug was identified
          by Matt Kaminer <matt@kaminer.com>.

    - October 12, 2001 - version 1.1
        o Bug fix about the path for the modified weather image
        o Added the ability to automatically resize the modified image, but
          it looks rough still.

    - October 8, 2001 - version 1.0
        o I feel the program is pretty much complete (although change never
          hurts!), so I decided to make this version 1.0
        o The main change was adding image cropping capability so the weather
          graphic was not so big.

    - October 3, 2001 - version 0.2
        o Applied fixes supplied by Gary Dewrell <dewrell@vvm.com>. It added a
          link to the weather image so the user can get the 5 day forecast, as
          the graphic states.

    - September 29, 2001 - version 0.1
        o Initial Release

