=== wp-forecast ===
Contributors: tuxlog
Donate link: http://www.tuxlog.de
Tags: weather,forecast,widget
Requires at least: 2.8
Tested up to: 2.9.2
Stable tag: 2.9

wp-forecast is a highly customizable plugin for wordpress, showing weather-data from accuweather.com and/or weatherbug.com.

== Description ==
You are reading the readme.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 and/or weatherbug.com. 
please also refer to the terms of usage of accuweather.com and weatherbug.com

Features:

   + Displays the weather data from AccuWeather.com and or WeatherBug.com 
     at your wordpress pages, posts or sidebar
   + 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/seven days
	 * the nighttime forecast for up to nine nights
   + support wordpress widgets, easy placement :-)
   + customize the information you want to show
   + supports pull-down forecast data to efficiently use space
   + multiple wp-forecast widget support 
   + integration into your site via css (see below)
   + comes with an api for wordpress-pro's ;-)
   + comes with a checklist to validate your connection settings

Credits:

 + Barbary Jany			testing a lot and bring it to valid XHTML
 + Frans Lieshout&Wim Scholtes	translation to dutch
 + Luís Reis			translation to portugues
 + Håkan Carlström		translation to swedish
 + Gabriele von der Ohe		translation to german with entities
	        		(for iso-8859-1 or latin1 blogs)
 + Martin Loyer/Jean-Pierre	translation to french
 + Robert Lang			language file for en_US
 + Detti Giulio/Stefano Boeri	translation to italian
 + Eilif Nordseth		translation to norwegian
 + Michael S.R. Petersen	translation to dansk
 + Jaakko Kangosjärvi		translation to finish
 + Lukasz "linshi" Linhard	translation to polish
 + Castmir	     		translation to spanish
 + Tamas Koos			translation to hungarian
 + Valeria Pellegrini		translation to russian
 + Valentina Boeri		translation to romanian
 + Roland Geci			translation to slovak
 + All the others giving feedback about missing features and bugs.   
   Thank you very much for your contribution to wp-forecast.   


== 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/`\).

1. Activate the plugin on the plugin screen.

3. Visit the configuration page \(`Options -> WP-forecast`\) to pick the 
   number of widgets, data to display and to change any other option.

4. Visit the Themes/Widgets page to place your wp-forecast widget within 
   your themes sidebars or insert it manually and 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( <widget_id> ); 
                 } ?>
             </li></ul>`

     You have to replace <widget\_id> with the choosen widget id.
     For the first widget use wp\_forecast("A"), for the second 
     wp\_forecast("B") and so on.
     In most cases it is advisable to put the call into a 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
   there are three classes div.wp-forecast for outer formatting, 
   table.wp-forecast for the middle part or iconpart and 
   wp-forecast-details for everything below the icon


== Translations ==

   wp-forecast comes with various translations, located in the directory `lang`.
   if you would like to add a new translation, just take the file
   wp-forecast.pot (in the wp-forecast main directory) copy it to
   <iso-code>.po and edit it to add your translations (e.g. with poedit).

   please be aware that the number codes stand for the weather-situations.
   you can see the mapping in en_US.po. there are also the letters N, S, W, E
   they stand for the winddirections and can be translates either.

   there are different translations for the german language using
   different charsets. the default de\_DE uses UTF-8, de\_DE-iso-8859-1
   uses iso-8859-1 and de\_DE-latin1 uses HTML entitites.

   to use a different as the default just rename the appropriate file
   to de\_DE.po and de\_DE.mo


== Frequently Asked Questions ==
= Where can I get further information about the plugin? =

There are severeal ressources to visit:

* [The german reference][germanref] 
* [A short FAQ list in german][gerfaq]
* [A checklist in case of problems (german and english)][checklist] 
* [The english readme.txt][engreadme]
* [The english reference (a bit out of date but still useful)][engref]

[germanref]: http://www.tuxlog.de/wordpress/2008/wp-forecast-referenz-v14/ 
          "German wp-forecastreference"
[gerfaq]: http://www.tuxlog.de/wordpress/2007/wp-forecast-wie-geht-das/
	  "wp-forecast FAQ - Wie geht das?"
[checklist]: http://www.tuxlog.de/uncategorized/2009/checkliste-fur-wp-forecast-checklist-for-wp-worecast/
          "wp-forecast checklist for connection problems"
[engreadme]: http://www.tuxlog.de/wp-content/downloads/wp-forecast-readme-2.4.txt
          "you are actually reading this one"
[engref]: http://www.tuxlog.de/wordpress/2008/wp-forecast-reference-v17-english/
          "english reference for wp-forecast"

= After upgrading the plugin my widgets are gone. Any Ideas? =

Probably you used the automatic upgrade which disables the widget during update and therefore removes the configured widgets. Just add the widgets again.

= After upgrading my settings are gone. How can this be? =

Probably you have enabled "Delete options during plugin deactivation?" and used automatically update or disabled the plugin during update. When this option is marked everey database entries inserted by wp-forecast are removed from the database.

== Screenshots ==
1. wp-forecast as a widget with two day forecast
2. wp-forecast admin dialog
3. wp-forecast in an iframe with a two day forecast


== Changelog ==

= v2.9 (2010-02-19)
* fixed an javascript, jquery incompatibility with ie6, ie7, ie8 concenring the selection dialog widget

= v2.8 (2010-01-30) =
* prevent wp-forecast-nowp.css from being deleted during automatic plugin update
* added beaufort to set of windunits
* updated dutch translation, thanks to Wim :-)
* fixed warning during autoupdate with wordpress >Version 2.8.6
* rounded pressure to get rid of long values

= v2.7 (2010-01-22) =
* added unit label to timeoffset field in admindialog
* added selection dialog widget to let user choose which location to view
* extended pulldown widget to use more than one pulldown widget per page 
* prevent wp-forecast.css from being deleted during automatic plugin update

= v2.6 (2009-12-17) =
* fixed wrong urlencoded link to weather forecast at accuweather
* fixed undefined variable warning for $wp_forecast_pre_transport in wp-forecast.php
* fixed uncompress bug in wordpress 2.9 with workaround in fetch_url
* fixed invalid xhtml/javascript in admin dialog once more
* added open in new window feature for weather provider link
* added time offset to correct wrong calculated accuweather times

= v2.5 (2009-10-17) =
* fixed wrong html in widget dialog with wordpress v2.8, that leads to problems with placing widgets in internet explorer
* set default for widget call via v2.8.1 widgetdialog
* replaced "Copyright" with &copy; 
* added parameters width and height to shortcode
* added feature to show/hide forecast data with javascript
* added transport check to admin dialog

= v2.4 (2009-07-04) =
* changed readme to support new changelog feature at wordpress.org
* fixed faq section in readme, resized icon
* added default css file which is used when no user specific one is available
* fixed div container when date/time is disabled
* fixed widget title to be display correct

= v2.4beta (2009-06-18) =

* fixed translation of winddirection in api
* added translation for romanian
* fixed russian and italian translation
* modified show function to use data api
* avoid to store new cache when http fetch results in failure notice from acuweather
* add support for weatherbug
* reduced the number of database reads and writes and raise performance
* changed the xhtml using only div and not table or others
* added shortcode wpforecast
* catch error when weather bug does not deliver a shorttext
* since it leads to problems with some installations
* added menu icon
* moved settings to main menu
* switched the widget dialog to new oo-progamming for versions after 2.7.1
* added a preselection of the transfer method to be used with wp-forecast


= v2.3 (2009-01-30) =

* fixed some wrong italian translations
* added shorttext for api daily forecast
* fixed translation in api
* process failure notice from accuweather if it occures
* added lat and lon to data api
* switched to wordpress default function to get remote data from accuweather
* changed default value of cache refresh to 1800 seconds
* added translation to russian


= v2.2 (2008-12-29) =

* fixed some mistakes in finish translation (thanks to Jaska)
* added hungarian translation
* added parameter to avoid option deletion when deactivating the plugin
* added parameter for direct call to add a html-header
* added multi-checkbox-switch in admin-dialog (for convenience only)
* added translation for winddirections
* added data api for wordpress-pro's to design layouts individually


= v2.1 (2008-11-09) =

* added language support for spanish (thanks to Castmir) and 
* polish (thanks to Lukasz)
* fixed minor css bug 


= v2.0 (2008-11-02) =

* added finish translation (thanks to Jaska)
* fixed a problem with overloaded textdomains (translations)
* since wordpress does not a sanity check if a loaded domain is reloaded, we have to do it


= v1.9 (2008-10-04) =

* surpress fsockopen warning messages in case of connection problems and output the error as html comment


= v1.8 (2008-09-17) =

* added css class wpf-icon to make it easier formating the weather icons
* added autodetection for icon filetype
* gif, png and jpg are supported
* corrected some translations


= v1.7 (2008-07-20) =

* removed a bit of redundant html when widget title is empty
* fixed bug in output of current conditions
* added option to show a link to the accuweather forecast
* added dansk translation


= v1.6 (2008-07-11) =

* removed some hardcoded css
* it is now possible to call the widget directly outside from wp
* fixed a problem with wp >2.5 and the widget dialog
* removed some redundant html
* when showing no current weather information 
* placed forecast header into own table with own css class
* added timeout parameter for the accuweather connections
* rounded humidity to integer values
* fixed some typos in swedish translation and added norwegian selection (thanks to RAM_OS) 


= v1.5 (2008-05-12) =

* fixed two dutch phrases in dutch translation
* added norwegian translation (thanks to Eilif)


= v1.4 (2008-01-26) =

* fix loading the wright textdomain when called from outside wordpress
* added a bit debug code
* work around for a bug in k2rc3 theme
* added italian translation
* added english lanuage file
* a bit of code cleanup
* extend function wp-forecast to select language per widget
* added functions to display a set and a range of widgets at once


= v1.3 (2007-12-26) = 

* added french translation
* added german icon 11 (fog, 11_de.gif)
* extended css classes to support horizontal view via css
* removed repeating section title 


= v1.2 (2007-11-05) =

* extend error handling for serverloss
* added iso8859-1 coded german translation
* fixed bug with german winddirections
* added a widget title
* removed standard location label (this can be handled via alternate location)


= v1.1 (2007-10-01) =

* fixed: setting the current time could not be disabled
* fixed: on some servers the current date was converted to 0
* switched translations to gettext as recommended by wp codex


= v1.0 (2007-09-09) =

* fixed accuweather call for us locations
* now works with wordpress mu


= v1.0b4 (2007-09-01) = 

* fixed humidity / pressure checkbox
* removed hard coded formatting, added css class
* added support to show current time


= v1.0b3 (2007-07-29) =

* fixed output of before/after widget stuff for empty forecast
* fixed different parameters for calling wp_forecast as widget and from sidebar.php
* added swedish translation (thx to Håkan Carlström)


= v1.0b2 (2007-07-25) =

* work around for bug 4275 in wordpress 2.2
* removed widget id from output


= v1.0b (2007-07-17) =

* added support for up to 20 widgets with different locations and settings 
* added portugese language support
* weather data is now cached in the database 
* no cookies needed anymore
* default value of missing translations is now english
* removed configuration dialog from widgets page to avoid misunderstanding about setup
* fixed some minor errors


= v0.9.1 (2007-07-01) =

* added new field windgusts
* fixed some incompatibility with complex themes


= v0.9 (2007-06-23) =

* added copyright notice
* added date for current conditions
* added alternative location name


= v0.8 (2007-06-18) =

* added dutch language support
* show time in wordpress format (option: time_format)

= v0.7 (2007-06-11) =
* Fixed an incompatibility with wpSEO (used same global variable language which should never happen)


= v0.6 (2007-06-07) =

* 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


= v0.5 (2007-06-03) =

* added support for wp widgets
* Fixed some incorrect XHTML code
* added selection of the fields to show
* added windspeed unit support (hope you like it Barbara :-))
* added german language support for admin page


= v0.4 (2007-05-31) =

* never published, only code cleaning done


= v0.3 (2007-05-18) =

* Integrate forecast


= v0.2 (2007-05-17) =

* Fixed some incorrect XHTML code
* Fixed path settings for icons and css
* Tested with various browsers


= v0.1 (2007-01-15) =

* Initial beta release 
