/*
Plugin Name: wp-forecast
Plugin URI: http://www.tuxlog.de
Description:  wp-forecast is a highly customizable plugin for wordpress, 
	      showing weather-data from accuweather.com.
Version: 0.8
Author: Hans Matzen <webmaster at tuxlog dot de>
Author URI: http://www.tuxlog.de
*/

/*  Copyright 2006,2007  Hans Matzen  (email : webmaster at tuxlog.de)

    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
*/

you are reading the reame.txt file for the wp-forecast plugin.
wp-forecast is a plugin for the famous wordpress blogging package,
showing the weather-data from accuweather.com. please also refer to
the terms of usage of accuweather.com

THIS SOFTWARE IS IN BETA STATUS AT THE MOMENT


== features ==

   + Displays the weather data from AccuWeather.com at your wordpress
   pages
   + Let you choose the 
	 * location (of course)
	 * the time after the weather data is refreshed
	 * the langugage (currently only english or german are
	   available)
	 * metric or american measures
	 * windspeed unit
	 * the forecast days 
	 * the daytime forecast for up to nine days
	 * the nighttime forecast for up to nine nights
   + support wordpress widgets, easy placement and setup :-)
   + customize the information you want to show



== requirements ==

   + PHP >=4.3
   + Wordpress >2.2.x


== installation ==
	
	1.  Upload to your plugins folder, usually
	    `wp-content/plugins/`, keeping the directory structure intact
	    (i.e. `wp-forecast.php` should end up in
	    `wp-content/plugins/wp-forecast/`).


	2.  Activate the plugin on the plugin screen.

	3.  Visit the configuration page (Options -> WP-forecast) to
            pick the data to display and to change any other options
            that you wish.

	4a. Visit the Themes/Widgets page to place your wp-forecat 
	    widget within your theme

	and/or
	   
	4b. Edit your template file and put the wp-forecast function
            where you want your weather data to show up. 
	    Example:
	   
	    <ul>
	     <li>
	       <?php if(function_exists(wp_forecast)) { 
	                wp_forecast(); 
		} ?>
	     </li>
	    </ul>

	    Depending on what theme you use, it may be necessary to put 
	    the call into another div environment.

	5.  Optional
	    If you would like to have another set of icons download it
	    from http://accunet.accuweather.com/wx/accunet/graphics_icons.htm 
	    and put it into the wp-content/plugins/wp-forecast/icons folder

        6.  Optional
	    If you would like to change the style, just edit wp-forecast.css


== translations ==

If you would like to add a new langauge to wp-forecast, just take the
few steps written below and send the result to webmaster at tuxlog dot de

    1. edit language.php copy section
      
       if ($LANGUAGE=="en") {
       ...
       
       ...
       }
       
       and place it again at the end of the file (but before ?>)

    2. change the language code en to <your language code> in the
       copied section
       
    3. translate all these words   

    4. save the file :-)

    5. edit wp-forecast-admin.php
       
       look for  "<b>Language: </b>"
       below enter one line containing
	     <option value="your-language-code" <?php if
	     ($wpf_language=="your-language-code") echo
	     "selected"?>>your-lanuage (e.g. french)</option>

    6. save the file :-)


== history ==
2007-01-15 v0.1	   Initial beta release 
2007-05-17 v0.2    Fixed some incorrect XHTML code
		   Fixed path settings for icons and css
		   Tested with various browsers
2007-05-18 v0.3    Integrate forecast
2007-05-31 v0.4	   -- never published
2007-06-03 v0.5	   added support for wp widgets
		   Fixed some further incorrect XHTML code
		   added selection of the firlds to show
		   added windspeed unit support (hope you like
		   it Barbara :-))
		   added german language support for admin page
2007-06-07 v0.6	   Fixed a lot of incorrect XHTML 
		   added translation for winddirection
		   changed display of low- and hightemperature in forecast
		   no decimals for windspeed
		   fixed two phrases in translation
		   added hint for dealing with german umlaute and search
		   location dialog
		   added a bit error handling to surpress long error messages
	  	   when receiving no or invalid xml from accuweather
2007-06-11 v0.7    Fixed an incompatibility with wpSEO (used same global
                   variable language which should never happen)
2007-06-18 v0.8	   added dutch language support
		   show time in wordpress format (option: time_format)

== todo ==
   - add more languages
   - remove redundant code  
   - support for more than one location (more than one wp-forecast plugin)
 

