EasyWeather

var ew = $('.ew').EasyWeather({ 
	providerId: 'ham' 
});

Remarks
This fallback mechanism will work only if there is at least one weather API account set.

var ew = $('.ew').EasyWeather({ 
	providerSequence: false 
});

Remarks
If you decide to use only some of the weather API providers then it is better performance-wise to remove the unused providers.

var ew = $('.ew').EasyWeather({ 
	providerSequenceIds: 'ham|yhw|wug' 
});

var ew = $('.ew').EasyWeather({
	geoProviderId: 'maxmd'
});

Remarks
This fallback mechanism will work only if there is at least one geolocation API account set.

var ew = $('.ew').EasyWeather({
	geoProviderSequence: false
});

Remarks
If you decide to use only some of the geolocation API services then it is better performance-wise to remove the unused providers.

var ew = $('.ew').EasyWeather({
	geoProviderSequenceIds: 'fgip|maxmd'
});

Remarks
Only the Open Weather Map service supports languages: en English - en, ru Russian - ru, it Italian - it, sp Spanish - sp, ua Ukrainian - ua, de German - de, pt Portuguese - pt, ro Romanian - ro, pl Polish - pl, fi Finnish - fi, nl Dutch - nl, fr French - fr, bg Bulgarian - bg, se Swedish - se, zh_tw Chinese Traditional - zh_tw, zh_cn Chinese Simplified - zh_cn, tr Turkish - tr, cz Czech - cz,

var ew = $('.ew').EasyWeather({
	providerId: 'owm',
	language: 'sp'
});

var ew = $('.ew').EasyWeather({
	location: 'Manila'
});

var ew = $('.ew').EasyWeather({
	enableGeolocation: true
});

Remarks
If disabled the script fallbacks to a cookie based storage

var ew = $('.ew').EasyWeather({
	localStorage: false
});

Remarks
In order to reduce the API calls, the script caches the weather information locally and it will perform a call again only when the stored information has expired.

var ew = $('.ew').EasyWeather({
	cacheDuration: 1800000 //30 mins in msecs
});

Remarks
Sunday must be the first day of the week as it is the first day of the days collection in javascript (0 index). forecasts must be on.

var ew = $('.ew').EasyWeather({
	forecasts: true,
	weekDays: ['Dom', 'Lun', 'Mar', 'Mer', 'Gio', 'Ven', 'Sab']
});

var ew = $('.ew').EasyWeather({
	todayLabel: 'Oggi'
});

Remarks
Two possible values: 'vertical' and 'horizontal'. forecasts must be on.

var ew = $('.ew').EasyWeather({
	forecasts: true,
	orientation: 'horizontal'
});

Remarks
The default template object contains 2 properties: current, forecast. The custom template object may override the current or forecast properties. Below a complete list of placeholders for the current condition template: {icn}, {desc}, {date}, {Condition.provider_link}, {lnkforecasts}, {temp}, {minmax}, {Condition.description}, {Condition.humidity}, {Condition.precipitation}, {Condition.wind}, {Condition.pressure}, {Condition.visibility}, {forecastsdisplay}, {forecasts}, {cssprfx}
and the placeholders for forecast template: {icn}, {icndesc}, {date}, {minmax}, {desc}, {cssprfx}

var ew = $('.ew').EasyWeather({
	template: {
		current: '<div>{temp}: {desc}</div>'
	}
});

var ew = $('.ew').EasyWeather({ 
	header: false
});

var ew = $('.ew').EasyWeather({
	refreshLink: false
});

Remarks
If enabled it turns the searchBox option on.

var ew = $('.ew').EasyWeather({
	enableSearch: true
});

Remarks
enableSearch has to be true.

var ew = $('.ew').EasyWeather({
	enableSearch: true,
	nbSearchResults: 10
});

var ew = $('.ew').EasyWeather({
	forecasts: true
});

Remarks
forecasts has to be enabled.

var ew = $('.ew').EasyWeather({
	forecasts: true,
	forecastsLink: true
});

Remarks
Check the Providers list to know what is the maximum number of days for the forecasts. forecasts has to be enabled.

var ew = $('.ew').EasyWeather({
	forecasts: true,
	nbForecastDays: 5
});

Remarks
Two possible values 'C' and 'F'. showUnit has to be enabled.

var ew = $('.ew').EasyWeather({
	tempUnit: 'F'
});

var ew = $('.ew').EasyWeather({
	showUnit: false
});

Remarks
Two possible values 'Kmph' and 'Miles'. showDetails has to be enabled.

var ew = $('.ew').EasyWeather({
	showDetails: true,
	windSpeedUnit: 'Miles'
});

var ew = $('.ew').EasyWeather({
	showCountry: false
});

var ew = $('.ew').EasyWeather({
	showRegion: true
});

var ew = $('.ew').EasyWeather({
	showMinMax: false
});

var ew = $('.ew').EasyWeather({
	showDescription: false
});

var ew = $('.ew').EasyWeather({
	showDetails: true
});

Remarks
The value has to be a '|' separated list and the order of the items is ignored. showDetails has to be enabled.

var ew = $('.ew').EasyWeather({
	showDetails: true,
	details: 'humidity|wind'
});

{
	humidity: 'Humidity: ',
	precipitation: 'Precipitation: ',
	wind: 'Wind: ',
	pressure: 'Pressure: ',
	visibility: 'Visibility: '
}

var ew = $('.ew').EasyWeather({
	showDetails: true,
	details: 'humidity|wind',
	detailLabels: { 
		humidity: 'Humidité: ',
		wind: 'Vent: '
	} 
});

var ew = $('.ew').EasyWeather({
	width: '185px'
});

var ew = $('.ew').EasyWeather({
	height: '120px'
});

var ew = $('.ew').EasyWeather({
	basePath: 'MyPath/EasyWeather/'
});

Remarks
Available themes: ew-dark-grey, ew-yellow, ew-green, ew-purple, ew-teal, ew-skyblue, ew-orange, ew-dark-purple, ew-brown, ew-transparent.

var ew = $('.ew').EasyWeather({
	theme: 'ew-brown'
});

var ew = $('.ew').EasyWeather({
	cssContainer: 'my-css-class-here'
});

Remarks
Ignored if enableSearch option is off.

var ew = $('.ew').EasyWeather({
	cssForm: 'my-css-class-here'
});

Remarks
Ignored if enableSearch option is off.

var ew = $('.ew').EasyWeather({
	cssInput: 'my-css-class-here'
});

Remarks
Depends on the header option, if enableSearch is true then it will be ignored.

var ew = $('.ew').EasyWeather({
	cssHeader: 'my-css-class-here'
});

var ew = $('.ew').EasyWeather({
	cssContent: 'my-css-class-here'
});

var ew = $('.ew').EasyWeather({
	create: function() {
		console.log(this);
	}
 });

$('.ew').on('ew.create', function(e) {
	$(this).css({ border: '3px solid blue' });
});

var ew = $('.ew').EasyWeather({
	load: function() {
		console.log(this);
	}
});

$('.ew').on('ew.load', function(e, data) {
	console.log(e, data);
});

Remarks
It receives a data literal object which is the location response object or the position object returned by the browser's native geolocation feature.

var ew = $('.ew').EasyWeather({
	locate: function(data) {
		console.log(data);
	}
});

$('.ew').on('ew.locate', function(e, data) {
	console.log(e, data);
});

Remarks
It receives a data literal object which is the search response object.

var ew = $('.ew').EasyWeather({
	search: function(data) {
		console.log(data);
	}
});

$('.ew').on('ew.search', function(e, data) {
	console.log(e, data);
});

var ew = $('.ew').EasyWeather({
	error: function() { 
		$(this).css({ border: '3px solid red' });
	}
});

$('.ew').on('ew.error', function(e, msg) {
	console.log(e, msg);
});

var ew = $('.ew').EasyWeather({
	fnLocate: function () {
		// Your logic here: AJAX call to alternative endpoint
		this.showSpinner();
    	var o = this,
    		url =  (location.protocol.indexOf('file') != -1 ? 'http:' : location.protocol) + 
    				'//j.maxmind.com/app/geoip.js',
    		loc, city, country;
 
    			$.getScript(url, function() {
		            city = geoip_city(),
		            country = geoip_country_name(),
		            loc =  city + (o.config().showCountry ? ', ' + country : '');
		            o.setLocation(loc, true);
		        });
	}	
});

var ew = $('.ew').EasyWeather({
	fnLoad: function () {
		var location = this.location;
		// Your logic here: AJAX call to alternative endpoint
	}
});

var ew = $('.ew').EasyWeather({
	fnSearch: function () {
		var location = this.getAskedLocation();
		// Your logic here: AJAX call to alternative endpoint
	}
});

var ew = $('.ew').EasyWeather({
	fnSetIconUrl: function(o){
		var code = o.code;
		return '/img/weather/'+ code + '.png';
	}
});

var ew = $('.ew').EasyWeather();
console.log(ew[0].config());

var ew = $('.ew').EasyWeather();
console.log(ew[0].provider());

var ew = $('.ew').EasyWeather();
console.log(ew[0].getWeatherProviderIds());

var ew = $('.ew').EasyWeather();
console.log(ew[0].geoProvider());

var ew = $('.ew').EasyWeather();
console.log(ew[0].getGeoProviderIds());

Remarks
providerSequence must be true.

var ew = $('.ew').EasyWeather();
ew[0].setWeatherProvider('wug');

Remarks
geoProviderSequence must be true.

var ew = $('.ew').EasyWeather();
ew[0].setGeoProvider('maxmd');

Remarks
If the requested information is already cached and not expired yet, it will retrieve the data from the cache (localStorage or cookie).

var ew = $('.ew').EasyWeather();
ew[0].load();

Remarks
If the requested information is already cached and not expired yet, it will retrieve the data from the cache (localStorage or cookie).

var ew = $('.ew').EasyWeather();
ew[0].locate();

Remarks
If resetOriginalProvider true, it resets the original weather provider if it was previously changed.

var ew = $('.ew').EasyWeather();
ew[0].refresh();

var ew = $('.ew').EasyWeather();
console.log(ew[0].getWeatherData());

var ew = $('.ew').EasyWeather();
console.log(ew[0].getLocation());

var ew = $('.ew').EasyWeather();
ew[0].setLocation('New York', true);

var ew = $('.ew').EasyWeather();
ew[0].displayLocation('Hello world!');

Remarks
If the optional location argument is supplied, it will return the item name for the specified location. If the isForecasts is true it returns the name of the forecasts data.

var ew = $('.ew').EasyWeather();
console.log(ew[0].getStoredItemName());

Remarks
Both name and requestTime are mandatory. requestTime is the current date time in milliseconds and it is used to compare it against the time stamp of the stored item. If the difference is greater than the cache duration, then the item is considered expired and a null value is returned by the method.

var ew = $('.ew').EasyWeather();
var name = ew[0].getStoredItemName();
var item = ew[0].getValidStoredItem(name, new Date().getTime());
console.log(item);

Remarks
name is the key of the weather data and it is mandatory. data is the weather object to be stored as a JSON string. timestamp is date time of the current data, it is optional. If not supplied in will set the current date time.

var ew = $('.ew').EasyWeather();
var name = ew[0].getStoredItemName();
var data = { data: {} };
ew[0].storeItem(name, data);

var ew = $('.ew').EasyWeather();
var name = ew[0].getStoredItemName();
ew[0].removeStoredItem(name);

var ew = $('.ew').EasyWeather();
console.log(ew[0].clearCache());

var ew = $('.ew').EasyWeather();
console.log(ew[0].clearAllCache());

Remarks
type can have 2 possible values: current and forecast.

var ew = $('.ew').EasyWeather();
console.log(ew[0].getTemplate('forecast'));

Remarks
date must be a date object. The returned day string comes from the days defined in the weekDays option.

var ew = $('.ew').EasyWeather();
console.log(ew[0].getWeekDay(new Date()));

Remarks
The error message replaces the whole weather content.

var ew = $('.ew').EasyWeather();
ew[0].showError('Hello world!');

Remarks
container is optional and it defines the jQuery element containing the spinner and the message.

var ew = $('.ew').EasyWeather();
ew[0].showSpinner('Hello world!');

var ew = $('.ew').EasyWeather();
console.log(ew[0].cont);

var ew = $('.ew').EasyWeather();
console.log(ew[0].header);