This module makes use of the Google Weather API to display the current temperature, weather condition and a four-day weather forecast, as you can see on the left of the page.

This is the first, and currently the only weather module with the following features:

• Uses the Google Weather API that provides 4-day weather forecast with images.
• Allows user to interactively enter zip codes (for US, UK and Canada) and city names.
• Displays the weather information in many different languages, as provided by Google.
• Allows you to display two or more weather modules in the same page.
• Supports both Joomla 1.0 and Joomla 1.5!
• You can turn on or off the input field.
• You can specify the default unit for the temperature (in °C or °F)
• You can switch between °C or °F interactively with no reloading of pages.
• You can choose to display wind speed in mph or km/h
• Available for all Joomla versions: Joomla 1.0.x, native 1.5.x, 1.6.x, 1.7.x and 2.5.x!

• I've implemented the Google Weather Mashup with the use of PHP's cURL library. So please make sure your PHP has the cURL library installed in order to use this module.
• Note that this module works only with PHP5 and above because of the use of the PHP function simplexml_load_string which is only available starting with PHP5.

You can see some live demos below:

• kksou Google Weather module demo #1: shows the weather forecast for 4 different cities in 4 different languages.
• kksou Google Weather module demo #2: you can show or hide the input field for each of the module.

If you find the module useful and would like to use the module without the "Powered-by" links, you may do so by purchasing a "Powered-by" removal license for only USD $10 per site.

Secured payment is processed by 2checkout.com. All major credit cards are accepted, including Visa, Mastercard and American Express, etc. You can also pay by PayPal. Once the transaction is completed, you will be given a link to download the registered version with the "Powered by" links removed.

1. First, make sure you're using PHP5 and above.
2. Then, make sure your PHP has the cURL library installed. You can do a quick check by doing a simple

<?php
phpinfo();
?>

If your PHP has the cURL library installed, you should see something similar to the following:



If you don't have the cURL library, there are numerous resources on the Internet that gives you very clear instructions on how to install cURL on various platform such as windows, linux, etc.

3. Download and install the "kksou Google Weather Module".
4. Make sure the module is published / enabled.
5. Select a module position where you want to place the module.

That's it! You should now see the kksou Google Weather module displayed in the module position you've specified.

You can set the following in the Parameters page:

1. Default City: This is the city that will be displayed when the module is first loaded. For large cities, you can just enter the city name e.g. San Francisco, London, Tokyo, Moscow, without the need to enter the country name.

For some countries (e.g. US, UK and Canada), you can just enter the zip code. E.g. '94305', 'W1A 1AZ'.



2. Language: Google supported language code in ISO 639-1 format
   e.g. English is en, French is fr, Italian is it, Japanese is ja, Chinese simplified is zh-cn, Chinese Traditional is zh-tw.
3. Unit for temperature: Choose between displaying the temperature in °F or °C.
4. Hide Input Field: If all you want is to display the weather forecast of a particular city, and DO NOT want the user to change that, you can select 'Yes' to hide the input field.
5. Hide Humidity: Select 'Yes' if you wish to hide the humidity information.
6. Hide Wind: Select 'Yes' if you wish to hide the wind information.
7. Hide Forecast: Select 'Yes' if you wish to hide the 4-day weather forecast.
8. Label for 'City': This is the label that is displayed just before the input field. The default label is 'City'. You can change the label into your own language and label.
9. Size of Input Field: Size of the input field. Default size is 12.
10. Request Interval: If you do some research on google, you will see that there arer cases where Google will "ban" your site from accessing the Google Weather API if the request is made too often (e.g. some sites try to get the weather forecast of all cities in US through a robot). By default, I set a interval 3 seconds between each request to Google. This will prevent your users from making too frequent weather forecast requests via your website. If you are not concerned about this, you can reduce this to 1 second.
11. Set Focus on Input Field: Set the focus (i.e. put the prompt) on the input field for city. Default is Yes.

The entire formatting of the stock quotes is done using CSS. If you do not like the default look and feel of the stock data, you can edit the following CSS file:

<your joomla root folder>/modules/mod_kksouGoogleWeather/mod_googleWeather.css

1. Input Field (for entering city name)

div.googleWeather input {
	margin-bottom: 6px;
}

2. Input Label (the label 'City')

div.googleWeather .input_label {
	font-weight:bold;
}

3. The current temepature

div.googleWeather .deg {
    font-size: 100%;
	color: #3366FF;
	font-weight:bold;
}

4. The image of the current weather condition

div.googleWeather .img2 {
	float: right;
}

5. The current weather condition

div.googleWeather .cond {
	font-size: 100%;
}

6. The current wind condition

div.googleWeather .wind {
    font-size: 100%;
}

1. v1.0.1 (for Joomla 1.0) and v1.5.1 (for Joomla 1.5)
   Released October 6, 2009

Streamlined the javascript codes.

2. v1.0.2 (for Joomla 1.0) and v1.5.2 (for Joomla 1.5)
   Released January 20, 2010
• Allow user to define the popup prompt in their own language. This is in response to the request by Doug.
• Added support for IE8. Thanks to Mike for contributing this.
• No longer shows San Francisco in the input field when you have defined other city as default.

3. v1.0.3 (for Joomla 1.0) and v1.5.3 (for Joomla 1.5)
   Released February 14, 2010

This is in response to the request by Mazgonar.

Added one more parameter in the config page to allow user to choose whether to set focus on the input field for the city.

4. v1.0.4 (for Joomla 1.0) and v1.5.4 (for Joomla 1.5)
   Released May 06, 2010

Conform to joomla.org guidelines.

5. v1.0.5 (for Joomla 1.0) and v1.5.5 (for Joomla 1.5)
   Released May 16, 2010

The module is now W3C XHTML 1.0 Transitional compliant.

6. v1.6.6 (for Joomla 1.6) and v1.7.7 (for Joomla 1.7)
   Released October 10, 2011

Native version of the Google Weather Module for Joomla 1.6 and 1.7!

7. v1.6.7 (for Joomla 1.6) and v1.7.7 (for Joomla 1.7)
   Released October 16, 2011

Support for km/h for wind speed. If you display the temperature in degree Celsius, the wind speed will be displayed in km/h. If you display the temperature in degree Fahrenheit, the wind speed will be displayed in mph.

Note: By default, Google only returns the wind speed information in mph. I used the PHP function preg_match() to search for the string "mph". If you have displayed the weather information in other languages (e.g. Russian) which does not display miles per hour as "mph", the module will just display whatever wind information that is returned by Google.