wp-forecast

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

Screenshots

  • wp-forecast as a widget with two day forecast
  • wp-forecast admin dialog
  • wp-forecast in an iframe with a two day forecast

Installation

  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

FAQ

Where can I get further information about the plugin?

There are severeal ressources to visit:

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

Probably you used the automatic upgrade which disables the widget during update and sometimes 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.

Reviews

Februari 25, 2024
The plugin offers many and simple configuration options and does everything you need for the current weather and a forecast over several days - and all without high monthly or annual costs. Simply great.
Novambor 29, 2022
Very nice and useful Plugin. Easy to customize and works well with openweathermap API Key. The use of expensive ipstack API for Geolocation is not necessary. Customizing CSS in Child Themes CSS works also well. But one thing to mention, when you're using PHP 8.0 or grater, the API with openweather did not deliver data.
Oktubor 3, 2022 1 reply
I'm struggling to change some CSS rules. In wp-content/plugins/wp-forecast/wp-forecast-default.css I make the headers larger and the space between the day blocks larger, it works when I change it live on the browser but it doesn't when the page is loading again, still works with the old values. I'm using WPRocket, so I cleared countless times the cache, cleared every possible cache on browsers, deactivated and activated the plugin, erased the plugin, and installed it again....still has the same fucking old values! The page source code shows that the domain.com/el/wp-content/plugins/wp-forecast/wp-forecast-default.css?ver=9999 is loading, and the file has good large values, but every browser insists to show the old ones. I spent 4 hours of my precious time without any results. It's the first time after months that I feel exasperated! I give it 1 star because there isn't any lower.
Maarec 17, 2022
Even though I have Use visitors location checked, it still defaults to Frankfurt. Now it stopped working completely. Useless.
Jun 28, 2021
Great support by mail and good updates! AccuWeather stopped sending new data and quickly after, OpenWeathermap was added. So using my OpenWeathermap API it works perfectly again.
Read all 23 reviews

Contributors & Developers

“wp-forecast” is open source software. The following people have contributed to this plugin.

Contributors

“wp-forecast” has been translated into 3 locales. Thank you to the translators for their contributions.

Translate “wp-forecast” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

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 …