=== ICIT Weather Widget ===

Contributors: interconnectit, sanchothefat, AndyWalmsley, Mim McNeela, spectacula, cm2creative
Tags: weather, widget
Requires at least: 3.8.1
Tested up to: 4.1
Stable tag: 2.3.2
License: GPLv2
License URI: http://www.gnu.org/licenses/gpl-2.0.html

The ICIT Weather Widget provides a simple way to show a weather forecast on your website.

== Description ==

Weather information is pulled from the OpenWeatherMap API. This plugin adds a widget that can be dropped into any sidebar, can be customised to suit your theme and won't hit any usage limits.
 
The widget can be configured as follows:

* Country - choose the country to get weather data from. (Some countries do not have an average result for weather conditions)
* City - Enter the name of your area to recieve the weather results.
* Display Mode - you can choose to show either a compact view of the current weather or show the forecast for the current day and next three days.
* Position - This will change the position of the forecast list, right, left, or bottom. If display is compact position will stay as bottom for positioning of the weather breakdown.
* Background colour during day - use the colour picker to choose what colour background you want during the day time.
* Background colour during night - use the colour picker to choose what colour background you want during the night time.
* Show Temperature in Celsius - sets the temperature display to degrees celsius rather than farenheit.
* Show weather breakdown - choose whether to display the wind, humidity and written weather condition, as well as the temperature and weather icon.
* Show Wind Speed in mph - sets the wind speed display to mph rather than km/h.
* Cache Time - this is the interval in minutes before the plugin refreshes the forecast data.
* Output CSS - toggle whether the widget should output it's own CSS.
* Show Credit Link - this plugin is offered completely free of charge. If you're feeling kind please leave this in to send some delicious web traffic our way :) 

You can override what gets displayed for the location by filling in the widget's title text.

For info on how to use the shortcode, check the FAQs.

== Installation ==

1. You can install the plugin using the auto-install tool from the WordPress back-end.
2. To manually install, upload the folder `/icit-weather-widget/` to `/wp-content/plugins/` directory.
3. Activate the plugin through the 'Plugins' menu in WordPress.

== Frequently Asked Questions ==

= The Widget is Not Displaying =

This could be because there are no weather results returned from OpenWeatherMap for your region or area. You can try being less specific eg. by entering the name of your nearest City rather than Town but if you feel there is a mistake please let us know.

= Using the shortcode =

Put the following shortcode in your post or page to diplay the widget there instead of a widget space: [icit_weather]
The shortcode can take the following parameters (value in brackets is the default if parameter is left out):

* title - Text to override the city/country name ("")
* city - City to search the weather for ("Liverpool")
* country - Country the city is in ("UK")
* celsius - true/false whether to show temperature in celcius ("true")
* breakdown - true/false whether you want breakdown of wind and humidity ("true")
* mph - true/false show wind speed in mph or km/h ("true")
* display - 'compact' show just current weather / 'extended' show the next 3 day forecast ("compact")
* position - 'bottom', 'right', 'left' the position of the forecast
* background_day - Colour of background during day ("#FF7C80")
* background_night - Colour of background during night ("#FF7C80")
* credit - true/false show the interconnect/it credit link

For example:
[icit_weather city="Liverpool" country="UK" celsius="true" breakdown="false" display="compact" background_day="red" background_night="rgb(129,160,255)"]

== Known problems ==

This widget should work in all themes, although some themes styling will mix with the widget leaving bits that look out of place.

IE7 does not support the icons we use for the weather display.
Works in IE8+, Chrome, Firefox, Opera, and Safari.

== Screenshots ==

1. Compact Mode
2. Extended Mode
3. Widget Settings

== Changelog ==

* 2.3.2 - Fixed icons sometimes not displaying, fixed using city id to get weather
* 2.3.1 - Fixed CloudyMoon icon
* 2.3   - Update icons and added styling option to move forecast list
* 2.2.1 - Added shortcode
* 2.2   - Changed api from using xml to json
* 2.1.1 - City name is now returned from OpenWeatherMap
* 2.1   - icit-weather-widget is now translatable.
* 2.0   - Now uses OpenWeatherMap, new icons and customisable css.

== Upgrade Notice ==

* 2.3.2 - Bugfixes!
* 2.3.1 - Fixed CloudyMoon icon
* 2.3   - Styling options
* 2.2.1 - Shortcode has been added
* 2.2   - You (hopefully) won't notice any difference except for a better error message
* 2.1.1 - Bugfix!
* 2.1   - Translatable!
* 2.0   - It Works!