Club Free

Joomla Extensions

CLUB

RokWeatherLatest Version: J1.5 1.4 / J2.5 1.6

RokWeather
Joomla 1.5Joomla 2.5

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

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 Display Override: When your default location cannot be reached by the Google API, you usually have to use a city near you in order to display the weather. However there are times where you really want to show your real town/city name. Here is where the Display Override comes in hand. It will gather the data from the default location while showing as a name the one set in this option.

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.

User interaction: This parameter allows to disable the ability for the user to interact with the weather module, meaning the user cannot change location.

Enable Units switch: Sometimes you might want to disallow the user from change the unit temperature. With this option you can prevent it from happening.

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

Forecast items to show: How many days of forward forecast you want the module to dis

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 any alpha, beta, release candidate and final versions.

Joomla 1.7.x/2.5.x

Legend:

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

----------- 1.6 Release [24-Jan-2012] -----------
# Joomla 2.5 compatibility fixes
# Fixed blank page when weather data is missing

----------- 1.3 Release [11-Jul-2011] -----------

# Updated Google API

----------- 1.2 Release [13-Jun-2011] -----------

09-Jun-2011 Djamil Legato
# Fixed aliases for icons
# Fixed an error

----------- 1.1 Release [01-Jun-2011] -----------

01-Jun-2011 Djamil Legato
^ Updated to the new Google API

----------- 1.0 Release [24-Mar-2011] -----------

24-Mar-2011
^ Updated to Joomla 1.6.x

----------- Initial Changelog Creation -----------

Joomla 1.5.x

Legend:

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

----------- 1.4 Release [11-Jul-2011] -----------
11-Jul-2011 Djamil Legato
# Fixed aliases for icons

----------- 1.3 Release [13-Jun-2011] -----------

09-Jun-2011 Djamil Legato
# Fixed aliases for icons
# Fixed an error

----------- 1.2 Release [01-Jun-2011] -----------

01-Jun-2011 Djamil Legato
^ Updated to the new Google API.

----------- 1.1 Release [27-Nov-2010] ---------------

27-Nov-2010 Juozas
# Fixed issue with Google API wind.

----------- 1.0 Release [30-Sep-2010] -----------

30-Sep-2010 Djamil Legato
# TipFix

----------- 0.9 Release [16-Aug-2010] -----------

16-Aug-2010 Djamil Legato
# Warnings clean up
+ MooTools 1.2 Compatibility

----------- 0.8 Release [09-Apr-2010] -----------

09-Apr-2010 Djamil Legato
# Preventing potential issue with SEF components
+ Added advanced option "Module Identification" which lets choose between "ID" or "Name" of the module to be passed to RokModule (defaults to ID)
+ Added new "Units switch" option that allows to prevent the user from switching between °C and °F units.
+ Added new "Location Display Override" option that allows to override the Default Location name display with anything. Useful when your town is not picked up by the Google API and you have to use the nearest city but want to still show your town name
+ Added new "User interaction" option that allows to prevent the users from interacting with the location and change it.

----------- 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 -----------