=== wp-forecast ===
Contributors: tuxlog
Donate link: http://www.tuxlog.de
Tags: weather,forecast,widget
Requires at least: 2.7
Tested up to: 3.8.1
Stable tag: 4.8
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,
Susanne Svensso 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
+ Pavel Soukenik translation to czech
+ Pavel Karnaukhov translation to ukraine
+ Zoran Maric translation to serbian (latin)
+ Petar Petrov translation to bulgarian
+ Udi Burg translation to hebrew
+ Uli Kozok translation to indonesian
+ Ali Zemani translation to persian
+ Amizda Idriz translation to bosnian
+ 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/`\).
2. 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: ``
You have to replace 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
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
.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 ==
= v4.8 (2014-01-30) =
* add updated hebrew translation
* optimized default icons with opt-gif and opt-png
* added css sprites feature for accuweather icons (experimental)
* fixed problem with dutch language and wind icons
* adopted default css to Twenty Fourteen
* added new accesspoint to access accuweather location search
= v4.7 (2013-10-21) =
* add updated czech translation. Thanks to eldenroot
* added update greek translation. Thanks to Nikos
* added a wind direction indicator
= v4.6 (2013-10-13) =
* fixed css output with wp_enqueue_script
* disabled service for google weather because google closed the api
* added uv-index to the accuweather data fields
= v4.5 (2013-05-07) =
* added serbian language (Thanks to Amizda Idriz)
* fixed langauge codes in language selection dialog
= v4.4 (2013-02-03) =
* fixed some php warnings
* added persian translation (Thanks to Ali Zemani)
* fixed language code in iframe header
= v4.3 (2012-12-24) =
* added new hebrew translation by Udi :-)
* added new greek translation by Nikos :-)
* added updated serbian translation by Zoran :-)
* fixed search dialog for some special accuweather responses
= v4.2 (2012-10-23) =
* changed global variable name for xml parsing to prevent collision
* added width and height attributes to img tags for better performance
* fixed HTML warning in admin dialog
* fixed problem with plugin_locale filter
* fixed problem with webservers which do not decompress automatically
* added indonesian language thanks to Uli
= v4.1 (2012-08-03) =
* fix admin dialog, it was not possible to save the WeatherBug Partner-ID
* only include javascript for multi widget in frontend
* changed translation loading from load_textdomain to load_plugin_textdomain
* fixed a problem with search dialog and individual wp-content folder
= v4.0 (2012-06-10) =
* support individual wp-content folder
* added hebrew translation from Udi Burg
= v3.9 (2012-05-26) =
* fixed a bug with new search dialog and multiwidgets
* fixed some php notices
* fixed weather provider switch in admin dialog
* check for apikey in search dialog for weatherbug
= v3.8 (2012-02-05) =
* fixed a special data constellation returned by accuweather for the pressure
* changed js loading to load thickbox only in admin dialog
* changed search dialog to an ajax like replacement
* redesigned the admin dialog a bit more convenient
* fixed an url problem in connection check
= v3.7 (2011-12-21) =
* fixed include of wordpress specific vars (wp-config.php, wp-load.php) to support secure setting
* various html5 validity fixes
* calculate copyright year automatically
= v3.6 (2011-07-06) =
* changed accuweather copyright notice to 2011
* removed use of HttpExt class for transport, since it was removed from wordpress 3.2
= v3.5 (2011-04-21) =
* added updated finish translation from Jaakko
* selection widget now accepts language_override to set langauge different from default
= v3.4 (2011-03-13) =
* added updated dansk translation (thanks to Michael S.R. Petersen)
* fixed a problem with wp 3.1 in network mode, due to a different search path th
e wrong setup.php was included
= v3.3 (2010-11-02) =
* moved enqueue script to init hook where it should be to avoid conflicts with other plugins
* added bulgarian translation
* if you return to a wp-forecast site which uses selection widget, your selected location will be remembered and automatically displayed when you return (uses cookies)
= v3.2 (2010-10-01) =
* fixed duplicate id in selection widget
= v3.1 (2010-08-02) =
* fixed several bugs when using presettings in multiusermode
* added support for GoogleWeather API
* added serbian latin translation (thanks to Zoran)
* fixed year in copyright notice
* update accuweather servicelink to new server
* fixed translation for superadmin dialog on multisites
* added colored checkboxes to superadmin dialog
* removed examples folder from package
= v3.0 (2010-05-15) =
* timeoffset is now considered for current time too
* added support for wpmu (maintain settings on a per blog base, support for wpmu admin plugin)
* updated dansk translation
* fixed handling of country specific characters in accuweather data
* added "Less..." link at the top (pull down widget)
* updated swedish translation
* added css class for iframe tag for shortcodes
= v2.9 (2010-02-19) =
* fixed an javascript, jquery incompatibility with ie6, ie7, ie8 concerning 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 ©
* 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