xoapWeather - Readme
===================

  xoapWeather - Process XML feeds from weather.com for display on a web site            
			    keeping with in weather.com's standards for caching.

  Version 1.2 - April 2003
  -------------------------
  http://www.spectre013.com
  
    Copyright (C) 2003  Brian Paulson <spectre013@spectre013.com>
 
    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

  Requirements:
    php 4 or >
	Subscription to The Weather Channel's XML feed Service (FREE @ http://www.weather.com)


  Summary:
   	xoapWeather was developed keeping in mind the standards of weather.com's Terms
	regarding Caching, links, and proper displaying of Information. 
	
  Download:
    You can get the newest version at http://www.spectre013.com/.

  Credits:
   	Thanks to Kris Zawadka [kris@h3x.com] for the XML Parsing Functions.
	Thanks to Brian Devendorf <brian@brianjd.com> for the Extended Forecast layout.
	Thanks to all those who have posted bugs and suggestions to the forums to help
	make xoapWeather a better application.
    

  Installation:
    1. Upload all the file to the Directory called weather
		a. Determine storage method: database or file.
			1. If you are going to use the database support(mysql) create the 
			   necessary database and tables from the xoap.sql file.
    		2. If your going to use file support make sure the directory wxCache 
			   writable by your web server.
   	2. Subscribe to weather.com's XML Feed http://www.weather.com/services/oap.html - its FREE
    3. Fill out the variables at the top of the xoapWeather.php.
	
  Upgrade:
  	1. change your index.php to:
		include("xoapWeather.php");
		$weather = new xoapWeather();
		$weather->loadXoap(81007,$_GET['display']);
	2. Fill out the variables at the top of the xoapWeather.php
	
  ChangeLog:
   1.0 > 1.1
    Added the ability to search for a location by city name.
	revised code that retrieves the XML file to handle errors better.
	fixed spelling errors.
  1.1 > 1.2
	Revised code that retrieves the XML file.
	Added Database support (mysql).
	Added socket support.
	All output is XHTML Compliant.
	Added ability to have multiple instances of the application on same page.
	Other small code fixes.
	
  Support:
    There is support forums located http://www.spectre013.com


    Enjoy!