Installation Instructions

1. Upload plugin files to your plugins folder, or install using WordPress' built-in Add New Plugin installer
2. Activate the plugin
3. Go to the plugin settings page (under Settings > WP Wunderground)
4. Configure the settings on the page. (Instructions for some setting configurations are on the box to the right)
5. Click Save Changes.
6. When editing posts, use the [forecast] "shortcode" as described on this plugin's Description tab

FAQ

How do I use my own icons?

If you want to use your own icons, you would add a filter to the bottom of your theme's functions.php file:

Version 1.2+

add_filter('wp_wunderground_forecast_icon', 'use_custom_wunderground_icons');

function use_custom_wunderground_icons($content=null) { 
    
    $myIconFolder = 'http://www.example.com/images/';
    
    $myFileType = '.gif';
    
    $content = preg_replace('/http\:\/\/icons\-ecast\.wxug\.com\/i\/c\/[a-z]\/(.*?)\.gif/ism', $myIconFolder.'$1'.$myFileType, $content);
    
    return $content;
}

Version 1.1

add_filter('wp_wunderground_forecast', 'use_custom_wunderground_icons');

function use_custom_wunderground_icons($content=null) { 
    
    $myIconFolder = 'http://www.example.com/images/';
    
    $myFileType = '.gif';
    
    $content = preg_replace('/http\:\/\/icons\-ecast\.wxug\.com\/i\/c\/[a-z]\/(.*?)\.gif/ism', $myIconFolder.'$1'.$myFileType, $content);
    
    return $content;
}

I am unable to activate the plugin.

This plugin requires PHP5, and Version 1.0 does not check for PHP compatibility. In future versions, it will show a more meaningful error and also support PHP 4.

For now, however, options are to upgrade the version of PHP (contact your web host) or to not use the plugin.

I want to modify the forecast output. How do I do that?

function replace_weather($content) {
    $content = str_replace('Rain', 'RAYNNNNN!', $content);
    $content = str_replace('Snow', 'SNNNOOOO!', $content);
    return $content;
}
add_filter('wp_wunderground_forecast', 'replace_weather');

What is the plugin license?

• This plugin is released under a GPL license.

Do I need a Wunderground account?

Nope, no account needed.

This plugin slows down my site.

Version 1.1 of the plugin added forecast caching, so the forecast is only re-loaded every 6 hours.

For previous versions, it is recommended to use a caching plugin (such as WP Super Cache) with this plugin; that way the forecast isn't re-loaded every page load.

Changelog

1.2.5

• Fixed issue where checkbox state wasn't being reflected in settings (as mentioned in this support thread)

1.2.4

• Removed error generation when XML file cannot be read (Error on line 427, as reported). Now, it just outputs an HTML comment error message.

1.2.3

• Fixed bug where Degree Measurement select drop-down would not show saved state as Celsius, even though it was working properly. (thanks Robson)
• Added proper HTML escaping for High/Low formatting and temperature output

1.2.2

• Added GoDaddy compatibility by switching from simplexml_load_file to wp_remote_fopen and simplexml_load_string (thanks, rjune)

1.2.1

• Fixed issue with "Give thanks" link

1.2

• Improved data storage, fixing issues users were having with Celsius / Fahrenheit settings and setting the number of columns in a table
• A new cache option has been added to the shortcode. Add cache=0 or cache= to the shortcode to disable storing forecasts. Not recommended; will dramatically slow down site.
  
  • If you want to refresh the results, you can add ?cache=false to your URL and the forecast will be updated.
• Added "width" option to shortcode to define table width. 100% is the default. Use width=0 or width= to disable hard-coding width in table.
• Changed the default high/low setting to add the degree symbol.
• Removed code whitespace when storing table for added speed
• Added CSS classes to forecast columns based on weather conditions. This will allow you to make "Partly Cloudy" columns gray, "Sunny" blue, etc.
• Added three new filters:
  • wp_wunderground_forecast_cache - How long results are cached for. Default: 6 hours.
  • wp_wunderground_forecast_icon
  • wp_wunderground_forecast_conditions
  • wp_wunderground_forecast_temp
• Rounded column width to two digits. Instead of 16.66666667%, it's now 16.67%

1.1

• Added data storage - the plugin will now store forecast tables for 6 hours. This should speed up the time it takes to load the forecasts.
• Added a check for PHP5 and simplexml_load_file, which are required for the plugin.

1.0

• Initial launch