Club Free

Joomla Extensions

CLUB

RokWeatherLatest Version: 0.7

RokWeather

Powerful Real Time Weather Reporting RokWeather, as the name suggests, is an Ajax-powered weather module which utilizes the Google API allowing you to easily display weather data and related information from regions all across the globe.

RokWeather includes options to display temperature, climate, wind speed as well as allowing the location to be configured from the frontend by the users of your site for more personalized weather information making RokWeather a perfect addition to any site.

NOTICE: In order for RokWeather to work, you need to install the RokModule component which facilitates the AJAX used in the module. You can download it from the Extensions section in RokDownload.

Also, if you experience the Fatal error: Call to undefined function curl_init() error then you need to have CURL enabled on your server. You can ask your hosting provider to activate this.

List of Features

  • Graphical Representation: the module is packaged with images to showcase all types of weather from rain to sunshine
  • Location Chooser: click the current area and type your desired location and the module will show the appropriate weather
  • Temperature Units: RokWeather has support for both the Fahrenheit and Celsius temperate scales
  • Forecast: Up to 4 days worth of weather forecast
  • Multiple Readings: optional parameters to show humidity, wind speed and weather descriptions

The extension is a Joomla 1.5 only module and uses the Google weather API to showcase its data. There are a wide range of options to choose from and the parameter switches determine the layout of RokWeather, which can show all in a block layout, or minimal data in a collapsed layout.

Screenshots

RokWeather - bring the powerful Google Weather API to Joomla

History

RokWeather first made an appearance with the May 2009 Joomla Template Release, the SolarSentinel template. As the May template was demoed as a News template, it was seen as appropriate to create a weather module.

Installation - Joomla 1.5


Downloading the Extension Files

  • RokWeather Module (mod_rokweather.zip) This file is the module package you will use to install RokWeather into Joomla.

Using the Joomla Installer

From the Menu in your Joomla Administrator, go to Extensions → Install/Uninstall.

Next, browse for your mod_rokweather.zip file you downloaded and then click Upload File & Install.


installation


Accessing the Module Page

Next, go to Extensions → Module Manager. From the list, find RokWeather and open it to be brought to the RokWeather Module Manager page, which lists all the available options for the module.


Configuration

RokWeather is a highly configurable module that allows you to control the various aspects of its appearance and functions. Details of each options are as follows:-

Default Location: The module displays the weather information of a default location on first, or cookie refreshed, load. This option decides which location is chosen as the default. As the setting uses the Google API, any location that can be used by Google will work here. For example, the default option is Golden, CO and will display the weather details from this location. Remember that a visitor can change this setting for them, by clicking on the location title and typing a new one.

Location Caching: This parameter is self explanatory. When enabled, it stores the location details in cache so that the details are not called fresh on each load from Google. This saves performance and improves performance.

Enable Location Cookie: When enable, this option stores the users location details in a cookie, that is, if they are selected a different location through the procedure explained above. Therefore, when the user refreshes, it does not default back to the location in the module setting, but the one the individual visitor chose for themselves. It changes when the cookie has expired.

Enable Icon Display: In the top left of the module is the weather icon which displays the current temperature and a diagram of the current weather. You can show or hide this image with this setting.

Enable Humidity Display: Another option offered by the Google API, you can set weather the Humidity reading for your area is visible in the module.

Humidity

Enable Wind Display: Similar to the Humidity option above, you can also control the display of wind data.

Wind

Enable 4 Day Forecast: The bottom of the module displays the forecast 4 days in advance, this includes an icon of the weather plus other data such as temperature.

Forecast

Default Degree Type: As we have 2 temperature units for weather forecast (notwithstanding the Kelvin scale), you can choose between them in the module. Although, the option to dynamically change the degree type on the module is still present, this affects the unit displayed on default. For example, in the USA, you would want to display Fahrenheit whereas in Europe, Celsius would be the preferred option.

Requirements

RokWeather has the following requirements in order to operate:-
  • Joomla 1.5x - ensure you are using the latest version.
  • RokModule - this is a free component that we offer that facilitates the use of Ajax, you can download it from the Extensions section in RokDownloads.
  • CURL - this needs to be enabled on your server for the module to work. You can contact your hosting provider to activate this for you.

Changelog

This is a changelog for RokWeather, inclusive of alpha, beta and release candidate versions.

Legend:

* -> Security Fix
# -> Bug Fix
+ -> Addition
^ -> Change
- -> Removed
! -> Note

----------- 0.7 Release [18-Nov-2009] -----------

18-Nov-2009 Brian Towles
# Added bug fix for PHP 5.3

----------- 0.6 Release [17-Jul-2009] -----------

17-Jul-2009 James Spencer
+ Added tool-tips to forecast images
+ Added module class suffix param
# Fixed calculations for fahrenheit
# Fixed validation issue  

----------- 0.5 Release [16-Jun-2009] -----------

16-Jun-2009 Djamil Legato
+ Built-in RokModule check
# iPhone and iPod Touch have single click instead of double for editing the location
 
----------- 0.4 Release [03-May-2009] -----------
 
03-May-2009 Djamil Legato
+ Added forecast items option
 
----------- 0.3 Release [02-May-2009] -----------
 
02-May-2009 Djamil Legato
# Language fix for IE
 
----------- 0.2 Release [01-May-2009] -----------

01-May-2009 Djamil Legato
+ Portuguese language support
 
----------- 0.1 Release [29-Apr-2009] -----------

29-Apr-2009 Djamil Legato
! Initial release.
 
----------- Initial Changelog Creation -----------