==o=====================o==
   Joomla Weather Module
==o=====================o==

 Installation/Customisation
       Tips & To Do...

===========================
       INSTALLATION:
===========================

1.  Install as a module in the back end of your Joomla! site.
2.  Publish the module in your prefered position.
3.  Find your prefered weatherstation at www.wunderground.com and copy the complete URL.
4.  Customise your module following the instruction below.

    Note:  In future versions customisation will be possible through the module 
    parameters but currently they do not work as well as editing the files
    themselves.  

===========================
        ATTENTION:
===========================

To reduce the data flow to the Wunderground servers, this module locally caches the
forecast information for 30 minutes to the following file in your root directory:

mod_WU-forecast.txt

When you change your location or language you therefore have to delete this file, 
or wait for 30 minutes to see the changes.

===========================
       TO CUSTOMISE:
===========================

>>> Preface:

The 5-day forecast at the following site is a good example of how Wunderground's
data can be made to look good - these qualities should be able to be achieved in 
future versions of this module:

http://www.wunderground.com/global/stations/03022.html


>>> What Changes What:


In the php file:

line 33  - Changes your icon directory.  NOTE - This should work but doesn't yet :( 
line 38  - Changes width in pixels of table.  
line 41  - Changes your required weather station URL.
line 70  - Changes your icon file names.  NOTE - This should work but doesn't yet :(
line 246 - Changes temperature colors.
line 360 - Changes title of table.
line 409 - Changes text to display PoP (Possibility of Precipitation)
           for example to 'Chance of Rain'.  
line 313 - Change setting for printing Heading.
line 314 - Change setting for printing Icons.
line 315 - Change setting for printing Text.

===========================
          TO DO:
===========================

1.  Make all of the above customisable through the module's parameters.  
2.  Make it possible to use your own icon set.
3.  Make it easy to change:

    - day title font color
    - day title background
    - forecast table cell background
    - table borders and padding

==========================
 MESSAGE FROM THE AUTHOR:
==========================

Thank you for your interest in this module.

This Joomla module is based on scripts from Saratoga-weather.org and 
shows the weather forecast for the next 7 days using information 
from www.wunderground.com. 

By following the customisation tips above you can get the weather for 
nearly every city in the world. For stations in the United States, US 
Territories or Canada however you will receive an error message. Check 
for country specific versions of this module at my homepage 
www.FlakkeeWEER.nl.

The copyright policy of Wunderground states that in order to use this 
script you need to:

1. Have your weather station submit data to WeatherUnderground as a WU member.
   (If you operate a weather station).  

2. Use this script ONLY on your personal, non-commercial weather station 
   website.

3. Leave attribution (and hotlinks) to WeatherUnderground as the source 
   of the data.

If you adhere to these three requirements, you should have fair use of 
the data provided by www.wunderground.com.

Regards,

Webmaster@FlakkeeWEER.nl

==========================
     VERSION HISTORY:
==========================


1.0 - 13 Oktober 2007 (First official release)
Designed for Joomla 1.0.x

1.1 - 15 Oktober 2007
Bug with sitelayout fixed
Translation of Precipitation in module-admin added
Readme added

1.2 - 1 Februari 2008
Bug with sitelayout fixed (caused by site Wunderground)

==========================
         THE END
==========================




