=== WEATHERICON ===

http://www.viper007bond.com/wordpress-plugins/weathericon/

Authors:
	Jeremiah Poling ( http://www.sonicpling.net )
	Garett Harnish ( garett@weathercode.nebo.zy.ca )

Incorporating improvements by:
	Viper007Bond ( http://www.viper007bond.com/ )
	TechGnome ( http://tannagh.com/ )
	Beel ( http://www.billhayes.us/wordpress )


WeatherIcon is a WordPress plugin that will display the current weather for a specified location. The plugin fetches it's data from the NOAA website and caches it for the time that you specify in the WeatherIcon options panel. It is highly configurable as it supports displaying multiple locations at once, many different units of measurement, and the ability to choose what weather data to display. It also includes a "widget" for the WordPress plugin WP-Dash which is a full replacement for the WordPress dashboard. For details, see http://somethingunpredictable.com/wp-dash/

== Upgrading From A Previous Version ==

If you are upgrading from a previous version, all you need to do is replace your existing `WeatherIcon.php` file with the one in this ZIP file (no need to upload the `wicons` or `alternate_icons` folders). Then, visit WeatherIcon's options page to double check your old settings and adjust any new options/features.

Note though that if you are upgrading from a version of WeatherIcon OLDER than 2.1.0, the plugin file, `WeatherIcon.php`, should now be located inside the `WeatherIcon` folder. This was done to better clean up your plugins folder and to keep all of the WeatherIcon files in one place. To upgrade, you will need to first deactivate WeatherIcon on the plugins page of your WordPress admin panel (don't worry, your options will be saved). You then need to DELETE the copy of `WeatherIcon.php` in your plugins folder, usually `wp-content/plugins/`, and then upload the `WeatherIcon.php` file from this ZIP file to your existing `WeatherIcon` folder.

Also, if you are displaying WeatherIcon with a different language file, note that more items may have been added to the language template, so you may need to update your language file.

== Installation ==

1. Upload to your plugins folder, usually `wp-content/plugins/`, keeping the directory structure intact (i.e. `WeatherIcon.php` should end up in `wp-content/plugins/WeatherIcon/`.

2. Activate the plugin on the plugin screen.

3. (Optional) Visit the configuration page (Options -> WeatherIcon) to pick the data to display and to change any other options that you wish.

4. Find the ICAO (International Civil Aviation Organization) airport code for the location that you want to display the weather for. (Basically, find the nearest airport to you or the location you want to display the weather for.) For a full, or at least a very large, list of ICAO airport codes, see http://weather.gov/tg/siteloc.shtml or http://weather.noaa.gov/data/nsd_cccc.txt

5. Edit your template file and put the WeatherIcon function where you want your weather data to show up. Example:

<ul>
  <?php WeatherIcon('station=SCEL&before=<li>&after=</li>'); ?>
</ul>

For a full list of function arguments, see the bottom of the configuration page.

== WP-Dash WeatherIcon Widget Details ==

If you have WP-Dash installed (see above link for details on this plugin), "WeatherIcon" will appear in your list of available widgets. Simply click "Launch" to create a new WeatherIcon widget instance and then click it's configuration button to choose a location and optionally a location label. You can even have the location put into the widget's header in place of "WeatherIcon" if you wish by checking the checkbox in the widget's configuration area.

== Frequently Asked Questions ==

= Why do my weather icons have black backgrounds in Internet Explorer? =

This is an Internet Explorer bug, or lack of a feature. It does not support PNG (an image type) transparency. Included in the `alternate_icons` folder is a folder called `transparent_gifs`. Inside are GIF versions of the default PNG icons. However, they are only 256 color and their transparency isn't as good, but you can use them if you wish. Just move them into your `wicons` folder and change the image extension on the WeatherIcon options page to ".gif".