wp-forecast Plugin

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 open-meteo.com and/or openweathermap.com.
please also refer to the terms of usage of open-meteo.com and/or openweathermap.com.

Features:

• Displays the weather data from Open-Meteo.com and OpenWeatherMap.com
  at your wordpress pages, posts or sidebar
• Displays OpenUV.io data
• Let you choose the
  • location (of course)
  • the time after the weather data is refreshed
  • the langugage
  • metric or american measures
  • windspeed unit
  • the forecast days
  • the forecast for up to six/seven days
• 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 😉

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 & Alejandro 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
  +Lovrenco Vladislavić translation to croatian

• All the others giving feedback about missing features and bugs.
  Thank you very much for your contribution to wp-forecast.

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
wp-forecast_-.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 wp-forecast-en_US-en_US.po. there are also
the letters N, S, W, E they stand for the winddirections and can be
translates either.

To use your own translation, a different one as the default just rename the
appropriate file wp-forecast_-.po and
wp-forecast_-.mo

To add your translations online at the Translate WordPress project please visit
https://translate.wordpress.org/projects/wp-plugins/wp-forecast. This should be the prefered
way from now on.

1. Install via the WordPress plugin admin dialog (search for wp-forecast) or

2. 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/).

3. Activate the plugin on the plugin screen.

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

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

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

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

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

4. 

v9.4 (2024-04-05)

• added hint to OneCall API
• tested with WP 6.5

v9.3 (2024-02-26)

• fixed possibility of XSS from within WordPress with role contributor and up

v9.2 (2023-11-26)

• add two filters to change the weather data if wanted wp-forecast-openweathermap-data and wp-forecast-open-meteo-data
• fixed widget with location selection (some attributes were removed for security reasons)
• fixed label typo in admin dialog
• removed some index warnings during widget preview call

v9.1 (2023-09-20)

• added weather description from Open-Meteo and OpenWeatherMap instead of old Accuweather descriptions
• removed old accuweather translations
• completed OpenMeteo translations
• fixed some typos
• avoid warning if translation is missing
• fixed activation error in some constellations
• fixed saving setup on Multisite
• Echo received message in connectiontest

v9.0 (2023-09-18)

• fixed apparent temperature bug in Open-Meteo data
• added support for Fahrenheit for Open-Meteo
• get more precise UV index for Open-Meteo
• updated some documentation
• fixed typos in english translation
• fixed unescaped quotes in search results (e.g. O’Hare Airport)
• sunset and sunrise are now formatted from blog time format

v8.9 (2023-09-15)

• fixed bug with use visitor ip for location and OpenMeteo
• fixed timezone shift on some sunset/sunrise times
• adopted connection test for Open-Meteo.
• completed german translation

v8.8 (2023-09-13)

• added support for OpenMeteo as an alternative to accuweather
• add admin notice for the accuweather problem
• added OpenMeteo to asset banner

v8.7 (2023-01-20)

• updated widget translations

v8.6 (2023-01-13)

• added handling for empty timezone setting for OpenWeatherMap
• corrected typo in german translation
• removed DarkSky service because it is terminated
• added support for OpenWeatherMap new API v3 service
• removed hint for ending DarkSky service

v8.5 (2022-10-13)

• fixed html incompatibility with some themes

v8.4 (2022-09-19)

• fixed pulldown issue when called as shortcode
• fixed undefined id in shortcodes.php
• fixed some warnings about undefined indices

v8.3 (2022-09-16)

• fixed widget output concerning filtering

v8.2 (2022-09-13)

• fixed loading shortcode css correct
• fixed pulldown anchors in special constellations

v8.1 (2022-09-12)

• enhanced OpenUV error handling

v8.0 (2022-09-08)

• fixed check connection test with new modal dialog

v7.9 (2022-09-07)

• added local translation for multi language sites
• eliminated extract calls for security
• fixed minor WordPress standard issues

v7.8 (2022-09-04)

• fixed shortcode call

v7.7 (2022-09-03)

• removed support for WordPress multisite admin settings
• fixed various PHP Sniffer errors and warnings
• redesigned admin dialog for connection test (ajax)
• redesigned admin dialog for location search (ajax)
• fixed special problem with some even more special precipitation values from the weatherprovider

v7.6 (2022-08-27)

• completed sanitize vars in admin dialog and update nonces
• extended connection test for OpenWeatherMap
• added some missing translations

v7.5 (2022-02-08)

• fixed warning in admin dialog when QUERY_STRING is not set

v7.4 (2021-10-19)

• fixed current precipitation for 1h

v7.3 (2021-10-16)

• added support for precipitation with OpenWeathermap.org

v7.2 (2021-06-14)

• fixed some warning of undefined indexes
• added OpenWeathermap weather data provider since accuweather does not send correct forecast data anymore
• added admin hint about weatherservice changes
• fixed wind direction mapping

v7.1 (2021-04-07)

• fixed refresh of weather data on WP ajax call
• added support for svg icons
• fixed call of round function for PHP8

v7.0 (2020-09-16)

• fixed curly brackets syntax in funclib
• fixed date_i18n timezone issue by replacing it with php date function

v6.9 (2020-06-01)

• fixed link to accuweather weathersite for locations in the US

v6.8 (2020-05-20)

• fixed WPLANG warning

v6.7 (2020-01-25)

• fixed timezone with sunrise and sunset from DarkSky
• fixed shift of conditions for different timezones
• fixed decimals for DarkSky night temepratures

v6.6 (2019-11-25)

• fixed some conditions or to ||
• open lat and lon for DarkSky locations withour giving a location
• removed old WeatherBug error message

v6.5 (2019-11-16)

• added some css classes for DarkSky
• round some values from DarkSky (e.g. degrees)

v6.4 (2019-11-10)

• removed support for WeatherBug since the free API was discontinued
• added support for DarkSky weather API
• fixed some notices
• removed old fashioned debugging aid

v6.3 (2019-10-20)

• fixed some more undefined index Notices

v6.2 (2019-09-12)

• fixed language override parameter for shortcode
• fixed some undefined index Notices

v6.1 (2019-01-19)

• added option to disable load of default CSS rules
• removed some PHP notices

v6.0 (2018-10-26)

• added interface to data from OpenUV.io to show detailed UV data
• added interface to ipstack.com for getting the visitors location for displaying the weather
• reordered the admin dialog
• added new widget showing data from OpenUV.com
• added UV icons, thanks to Lars

v5.9 (2018-08-12)

• javascript for ajax like call is only loaded when needed now
• updated spanish translation, thanks to Alejandro

v5.8 (2018-02-17)

• removed deprecated function call for PHP7

v5.7 (2017-09-23)

• added PHP7 compatibility

v5.6 (2017-08-27)

• tested with WordPress 4.8.1
• fixed some descriptions
• removed older files from package
• fixed a network bug which occurs sometimes
• reduces max numer of widgets to 8 avoiding heavy loading on some sites

v5.5 (2015-08-25)

• fixed deprecated constructor call for WP_Widget which leads to problems with some PHP Versions

v5.4 (2015-02-14)

• error handling if no icon code found in weather data
• updated french translation
• switched to new accuweather server

v5.3 (2015-02-11)

• error handling if no icon code found in weather data

v5.2 (2015-02-08)

• updated italian translation Thanks to Peter P.
• fixed some php warnings
• fixed dutch translation

v5.1 (2014-10-24)

• support for using shortcode in normal textwidget
• update croatian translation Thanks to Stjepan

v5.0 (2014-07-29)

• made the css a bit more responsive
• added croatian language (Thanks to Lovrenco)

v4.9 (2014-05-04)

• added contextual help and support email in admin dialog
• removed unused code (was commented since v3.x)
• removed old langauge files

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