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


----[ Program

    Weather v4.1.0


----[ Lead Developer

    Daniel B. Hemmerich <dan@spot.org>


----[ Special Thanks

    I would like to thank Elya S. Kurktchi <elya@fddi.com> for his support
    of this opensource project. Once again, thanks a lot Elya!


----[ Contributors of Code

    Gary Dewrell <dewrell@vvm.com>
    Mike Bush <mike@closedbox.com>
    Avi Schwartz <avi@CFFtechnologies.com>
    Matt Kaminer <matt@kaminer.com>
    Rion Monk <rmv@cypress.com>
    Rick Castello <rick@squirrelmail.org>
    Tracy McKibben <tracy@mckibben.d2g.com>
    Paul Lesneiwski <pdontthink@angrynerds.com>
    Dan Henry Jr. <dh@stinkerbox.net>


----[ Home Site

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

    SquirrelMail Plugin - Weather avaliable at: http://www.spot.org/code/


----[ Purpose

    Grab weather info from NOAA, based on the zip code or city
    provided by the user.


----[ Features

    o Supports unlimited amount of cities to monitor.
    o Has its own options menu now.
    o Caches weather information for 30 minutes before retrieving the weather
      information again.
    o Allows the folder width to be whatever the user defines, and bases its
      size on that.
    o International weather is supported.  For information on which cities are
      supported, see "International Weather Conditions" from 
      http://weather.noaa.gov/index.html or email questions to Paul Lesneiwski 
      <pdontthink@angrynerds.com>

----[ Future Changes

    o Might add a way for administrators to set maximum amounts for things like
      cache or cities tracked. At the moment, users can't change the cache time,
      it is set to 30 minutes, but that will change and let them decide, and the
      admin can set a lowest possible cache time.

    Got any ideas or complaints, please e-mail me! (or send a message to the 
    SquirrelMail plugins or users mailing list)


----[ 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.

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

    - March 6, 2003 - version 4.1.0
        o Updated for compatibility with SquirrelMail v1.4
        o New setup.php format for better overall SquirrelMail performance
        o Changed all require statements to include statements

    - November 13, 2002 - version 4.0.2
        o Detection of cities for which no weather info is available
        o Added refresh link after changes are made
        o Forecast link is more accurate
        o Now compatible (hopefully) with PHP versions < 4.1
        o Some cities do not have the feels like/wind chill listing,
          which had been causing problems - FIXED.
	o Fixed most PHP warning messages.
        o Wind Chill/Heat Index displays instead of always "Feels Like"
        o More error traping for when network connection is bad

    - November 11, 2002 - version 4.0.1
        o Made compatible with register_globals = Off 
        o Made compatible with Update Plugins plugin
        o Internationalized some strings that had been overlooked

    - September 8, 2002 - version 4.0.0
        o Fixed bug where deleting a location deleted all below it
        o If user enters quotes in Location, they are stripped out automatically
        o Fixed problem where cities like Chicago and NY didn't work
          because there is weather information for more than one 
          location within those cities (always use ZIP codes if possible)
        o Implemented international weather

    - June 22, 2002 - version 3.1.0
        o Fixed bug with default value for "Position" dropdown when editing a
	  location
	o Altered to retrieve data from NOAA, rather than weather.com
	o Disabled UV and Visibility options, NOAA site doesn't provide
	  this data
				
    - April 26, 2002 - version 3.0.0
        o Added ability to use an http proxy server.
	o Fixed various problems with the beta release.
	o Added the ability to save information, but select cities as either
	  visible or hidden.

    - April 21, 2002 - version 3.0.0-beta
        o Almost a complete re-write of the entire plugin again.
        o Moved the options from the folder options menu to its own options
          block.
        o Permit a city, state to be entered now too.
        o Unlimited cities may be entered.
        o Cacheing entered, so weather information is only gotten every 30
          minutes rather than each folder refresh.
        o Much more information is avaliable to be viewed. These are
          selectable in the options block.

    - April 19, 2002 - version 2.2.0
        o www.AccuWeather.com completely re-designed their site which made
          grabbing information from it rather difficult. This version may not
          be as well coded and tested as I would like, but it was done in a
          hurry as 2.1.0 no longer works at all. So we now get weather from
          www.weather.com.
        o You can expect 2.2.x to come out in a few days.

    - April 16, 2002 - version 2.1.0
        o Fixed the README file, to inform the administrator that the options
          for weather are in the folder options menu rather than display.
        o The plugin no longer requires a minimum width for the folder list.
          This was a popular request.
        o Added support for 4 additional cities to be tracked, giving a total
          of 5.
        o Canadian weather may be possible to look up if a Canadian postal code
          is entered. This is still in testing. Please give me feedback!

    - March 4, 2002 - version 2.0.0
        o Complete overhaul of the entire plugin.
        o Accuweather apparently no longer supports those miniture images of
          local weather. So we now manually grab the information from the page
          and display it in a box.

    - 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

