Weather Forecast Widget Plugin

GENERAL

The weather data for this widget will be retrieved from the OpenWeatherMap API with your own API key.

INPUT DATA

You can show the weather for a CITY (input data: city name) or for specific COORDINATES (input data: latitude & longitude coordinates) in the widget.

PLACEMENT/SHORTCODE

The weather widget can be implemented in a page, a post or into the widget area with the help of the shortcode [weather_forecast_widget]. Furthermore you´ll be able to pass different attributes to each shortcode to override your settings for this widget placement (e.g. manage widget title with an shortcode attribute).

TEMPLATES

Currently you can choose 3 templates for the widget.
* Template 1
* Current day´s weather with a weather forecast for the next 3 days
* Template 2
* Template 2 uses Bootstrap!
* Current day´s weather with an hourly weather forecast and a weather forecast for the next 3 days
* Template 3
* Template 3 uses Bootstrap!
* Weather for the current day and for the next 7 days, each with an hourly weather forecast and a weather forecast for the next 3 days
* Alert Template 1
* Alert Template 1 uses Bootstrap!
* Active weather alerts

BACKGROUND IMAGE

For this widget, you´ll be able to choose your own background image. Either you set a static background image in the widget settings or you choose the dynamic variant (thumbnail of the page/post, where the shortcode is placed) will be used as a background image.

WEATHER DATA

In addition to the daily weather forecast, an hourly weather forecast can also be displayed in the widget. Both the daily and hourly weather forecast can be collapsed.

WEATHER ALERTS

The weather widget also shows weather alerts. These alerts are dismissable.

WEATHER ICONS

In the widget you´ll find awesome and beautiful weather icons. In the plugins settings page you can choose which weather icons you want to use for the widget.
* Animated Icons Filled
* Animated Icons Not Filled
* Static Icons

LAZY LOADING

You have the possibility to load the widget with lazy loading (ajax) to load the data only when necessary.

CACHING

Nowadays caching is an important topic. This weather forecast widget makes it possible to cache the received weather data for the next visitor, who will visit your website page/post next time. You´ll be able to set your desired caching time in the settings (caching time possible up to 1 hour => this should ensure that the weather data in the widget is as current as possible). With this caching possibility you´ll also save API calls.

SHORTCODE EXAMPLES

• Retrieve weather data for a city
  • [weather_forecast_widget city=”Kufstein”]
• Retrieve weather data for a city and show city name as title text
  • [weather_forecast_widget city=”Kufstein” title_cityname=”X”]
• Retrieve weather data for specific coordinates
  • [weather_forecast_widget lat=”47.5824″ lon=”12.1627″]
• Retrieve weather data for specific coordinates and show “Weather for Weather Widget” as title text
  • [weather_forecast_widget lat=”47.5824″ lon=”12.1627″ title_overwrite=”Weather for Weather Widget”]
• Retrieve weather data with lazy loading and template 3 for specific coordinates and expand the hourly and daily forecast initially
  • [weather_forecast_widget lazy_loading=”X” template=”3″ hourly_forecast=”show” daily_forecast=”show” lat=”47.5824″ lon=”12.1627″]
• Retrieve weather alerts with lazy loading and alert template 1 for specific coordinates and expand the weather alerts initially
  • [weather_forecast_widget lazy_loading=”X” template=”alert_1″ alerts=”show” lat=”47.5824″ lon=”12.1627″ max_width=”500px”]

SETTINGS

• Input box for your OPEN WEATHER MAP API key (the api key will be tested for validity while saving!)
• Dropdown box to choose if caching of the weather data is necessary and if yes, which CACHE TIME should be used.
• Media uploader/selector to choose a BACKGROUND IMAGE for the widget (optional – otherwise the page/post thumbnail will be used)
• Radiobuttons to select the WIDGET TITLE TEXT, which will be displayed in the widget. This setting will be used as a default if nothing else will be passed in the shortcode. If you´ll pass title_cityname or title_overwrite as a shortcode attribute, this attribute will be processed in the widget output.
• Dropdown to choose the POST META FIELD for the title text, if you selected the readio button “Post Meta Field (choose one of the dropdown below)“
• Choose, which WEATHER VALUES should be shown in the widget
• Choose, which UNITS should be used to display the weather values
• Choose, which WEATHER ICONS should be used for the widget

TRANSLATIONS

• German – adminbergtourentipptirol

Credits

• Static Weather Icons provided from Erik Flowers Weather Icons
• Animated Weather Icons provided from Basmilius Weather Icons

Via your ADMIN PANEL

1. Visit “Plugins > Add New”
2. Search for “Weather Forecast Widget”
3. Activate the “Weather Forecast Widget” through the plugins menu in your admin panel
4. Go to “After activation” below.

MANUALLY

1. Download weather-forecast-widget.zip – from Weather Forecast Widget Plugin Folder – and unzip
2. Upload the weather-forecast-widget folder to the “/wp-content/plugins/” directory using your FTP client
3. Activate the “Weather Forecast Widget” through the plugins menu in your admin panel
4. Go to “After activation” below.

AFTER ACTIVATION

1. Go to “Weather Forecast Widget > Settings” in your admin panel
2. Input your Open Weather Map API key and choose your desired settings.
3. You’re done and you can now implement the shortcode in your sidebar, posts and pages.

1. 

   The SETTINGS PAGE contains all parameters, which are available for the configuration of this plugin.

2. 

   The SETTINGS PAGE contains all parameters, which are available for the configuration of this plugin.

3. 

   Weather Forecast Widget - TEMPLATE 1

4. 

   Weather Forecast Widget - TEMPLATE 2

5. 

   Weather Forecast Widget - TEMPLATE 3

6. 

   Weather Forecast Widget - ALERT TEMPLATE 1 with alerts

7. 

   Weather Forecast Widget - ALERT TEMPLATE 1 without alerts

1.1.5

• Bug fixing: Removed a div end tag that was redundant

1.1.4

• New: Bootstrap is only loaded by this plugin if it has not yet been activated (by the active theme or other active plugins).
• New: New template: Alert Template 1 (“alert_1”).
• New: New shortcode parameter “alerts”.

1.1.3

• Bug fixing: Especially Template 2 + Template 3
• Bug fixing: Display the name of the day in one line in the daily forecast
• Bug fixing: There is an overflow in the hourly forecast on smaller devices (e.g. on smartphones) . Therefore, on smaller devices, only up to 3 columns are displayed over the day. On larger devices, all hourly forecast columns will remain.
• New: New shortcode parameters “show_hourly_forecast”, “show_daily_forecast”, “show_alerts”.
• New: From now on several [weather_forecast_widget] shortcodes can be used on one page with activated lazy loding (ajax).

1.1.2

• Bug fixing incompability between bootstrap templates and some themes

1.1.1

• Bug fixing incompability between bootstrap templates and some themes

1.1.0

• Bug fixing: Template 1
• New: Template 2
• New: Template 3
• New: Lazy loading shortcode attribute/functionality
• New: Hourly/daily weather forecast functionality
• New: Animated weather icons embedded
• New: Show weather alerts
• New: Using Bootstrap and Fontawesome
• Update the “Tested up to” value

1.0.1

• Bug fixing: Template 1
• Update the “Tested up to” value

1.0.0

• Initial load of the plugin.