#Open Weather

A simple, lightweight jQuery plugin used to display the current weather and forecast of any city using the free OpenWeatherMap API.

This plugin allows you to display the location, the current temperature, the current low temperature, the current high temperature, a description of the current weather, a weather icon, the humidity level, the wind speed, the pressure, the time the sun will rise, and the time the sun will set.

The plugin will also display the low temperature, the high temperrature, a description, a weather icon, the humidity level, and the pressure for the next 7 days.

An API key is not required but it is reccomended. Register here to obtain an OpenWeatherMap API key for your application.

See demo

##Instructions

Include jQuery and the plugin in the head or footer of your page.

<script src="//ajax.googleapis.com/ajax/libs/jquery/1.9.1/jquery.min.js"></script>
    
<script src="/js/plugins/openWeather.js"></script>

The only default output is the current temperature.

To display the current temperature, create an element on your page where the current temperature will be displayed.

<div class="weather-temperature"></div>

Initialize the plugin targeting the class, ID or element that you've created with either the 'city' option or 'lat' and 'lng' options set.

$('.weather-temperature').openWeather({
	city: 'Toronto,ON'
});

OR

$('.weather-temperature').openWeather({
	lat: 30,
	lng: 25
});

##Custom Icons

The OpenWeatherMap API returns their own set of icons, however, if you don't want to use them, the plugin also allows you to use 6 custom icons for both day and night, so 12 in total. Custom icons must be named as follows:

<p>clear.png</p>

<p>clouds.png</p>

<p>few.png</p>

<p>rain.png</p>

<p>snow.png</p>

<p>storm.png</p>

<p>mist.png</p>

To use custom icons create a directory where the icons will live and inside of that directory create two more directories, "day" and "night."

/img/icons/weather/day/
/img/icons/weather/night/

Place your custom icons inside the "day" and "night" directories and initialize the plugin using the customIcons option.

$('.weather-temperature').openWeather({
	city: 'Toronto,ON',
	customIcons: '/img/icons/weather/'
});

* Note that if you are using custom icons you must include all 12 images.

####Options

key: integer
A string that defines the OpenWeatherMap API key for your application (default: null).

lang: string
A string that defines the language (default: 'en').
(English - en, Russian - ru, Italian - it, Spanish - sp, Ukrainian - ua, German - de, Portuguese - pt, Romanian - ro, Polish - pl, Finnish - fi, Dutch - nl, French - fr, Bulgarian - bg, Swedish - se, Chinese Traditional - zh_tw, Chinese Simplified - zh_cn, Turkish - tr)

city: "city name, country / province/ state"
A string that defines the city (default: null).

lat: integer
An integer that defines the latitude (default: null).

lng: integer
An integer that defines the longitude (default: null).

units: "c / f"
A string that defines the type of units (default: 'c').

customIcons: "path"
A string that defines the path to the custom icons (default: null).

type: "weather / forecast / both"
A string that defines the type of weather report (default: weather).

weatherTarget: "id / class / element"
A string that defines the ID, class or element that will contain the weather (default: null).

weatherTemplate: "string"
A string that defines the content and structure of the weather display (default: null).
Variable Options:

• {{icon}}
• {{location}}
• {{temp}}
• {{tempMin}}
• {{tempMax}}
• {{units}}
• {{description}}
• {{humidity}}
• {{windSpeed}}
• {{pressure}}
• {{sunrise}}
• {{sunset}}

forecastDays: integer
An integer that defines the number of days you wish to display for the forecast (default: 0).

forecastTemplate: "string"
A string that defines the content and structure of the forecast display (default: null).
Variable Options:

• {{day}}
• {{icon}}
• {{tempMin}}
• {{tempMax}}
• {{units}}
• {{description}}
• {{humidity}}
• {{pressure}}

forecastTarget: "id / class / element"
A string that defines the ID, class or element that will contain the forecast (default: null).

success: function() {}
A function that runs after the plugin has successfully retrieved weather data. (default: function()).

error: function() {}
A function that runs if there was an error retrieving weather data. (default: function(message)).

#####Example:

$(function() {
		
	$('.weather-wrapper').openWeather({
		city: 'Toronto, ON',
		customIcons: '../src/img/icons/weather/',
		type: 'both',
		weatherTarget: '.weather',
		weatherTemplate: 
			'{{icon}}' +

			'<p><strong>Place</strong>' +
			'<br>{{location}}</p>' +
			
			'<p><strong>Temperature</strong>' +
			'<br>{{temp}}{{units}} ({{tempMin}}{{units}} - {{tempMax}}{{units}})</p>' +
			
			'<p><strong>Description</strong>' +
			'<br>{{description}}</p>' +
			
			'<p><strong>Humidity</strong>' +
			'<br>{{humidity}}</p>' +
			
			'<p><strong>Wind speed</strong>' +
			'<br>{{windSpeed}}</p>' +

			'<p><strong>Pressure</strong>' +
			'<br>{{pressure}}</p>' +
			
			'<p><strong>Sunrise</strong>' +
			'<br>{{sunrise}}</p>' +
			
			'<p><strong>Sunset</strong>' +
			'<br>{{sunset}}</p>',
		forecastDays: 5,
		forecastTarget: '.forecast',
		forecastTemplate:
			'<div class="entry">' +

				'<p><strong>{{day}}</strong></p>' +

				'{{icon}}' +

				'<p><strong>Temperature</strong>' +
				'<br>{{tempMin}}{{units}} - {{tempMax}}{{units}}</p>' +

				'<p><strong>Description</strong>' +
				'<br>{{description}}</p>' +

				'<p><strong>Humidity</strong>' +
				'<br>{{humidity}}</p>' +

				'<p><strong>Pressure</strong>' +
				'<br>{{pressure}}</p>' +
				
			'</div>',
		success: function() {
		
			//show weather
			$('.weather-wrapper').show();
			
		},
		error: function(message) {
		
			console.log(message);
		
		}
	});
	
});