This plugin hasn’t been tested with the latest 3 major releases of WordPress. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

Easy Weather Widget


Easy Weather Widget provides you with an easy to use widget which outputs weather information. When creating the widget just enter in your U.S. zip code and save, it will display the current weather on your site.

I completely rewrote the widget and made it filterable. You need to obtain and enter an API key, which has a free tier that should cover many use cases to obtain at Settings > General in your WP backend. See for more information.

The following filters are available:

eww_template to override the output template for the widget, see below for more information.

note, if you are overriding the template, please heed the notice to comply with the OpneWeatherMap license which states the OpenWeatherMap name must be mentioned as a weather source in a visible part of the application. (obtained 8/2016 from

eww_ioc_container to override the IoC container if you want to use different classes in the application (including the API to grab weather data)

Usage of eww_template filter

Add a “views” directory and file named “custom-eww.php” to your template directory. The “custom-eww.php” file will be your custom template for this example.

Example of using a custom template from within your theme PHP 5.3+ which allows closures


        add_filter( 'eww_template', function ( $template ){
            $template_dir = get_template_directory();
            return $template_dir . '/views/custom-eww.php';
        } );


This plugin takes advantage of Grunt for validating JavaScript, SASS compilation and minification. To take advantage of Grunt you have to have both npm and Grunt installed. Visit the respective sites for the applications and make sure they are installed. Once installed, if you want to edit/fork this plugin, it will be helpful to be familiar with these two tools.


  1. If installing manually, unzip and copy the resulting directory to your plugin directory.
  2. Activate the plugin through the ‘Plugins’ menu in WordPress.
  3. Add the “Easy Weather Widget” widget to any widgetized area/sidebar and configure as desired.


Installation Instructions
  1. If installing manually, unzip and copy the resulting directory to your plugin directory.
  2. Activate the plugin through the ‘Plugins’ menu in WordPress.
  3. Add the “Easy Weather Widget” widget to any widgetized area/sidebar and configure as desired.
Does this work outside of the United States?

Current version uses’s API and it works in the US and Canada


June 9, 2021
I’ve been using this Plug-in for a few years now and I love it. I like for my visitors to know what the weather is doing here. I updated my WP sites to 5.7.2 the other day, and this afternoon I got a notice from someone on an email notification list that the Skype link in the email for our Tuesday meeting wasn’t working. I checked and discovered that he did not have today’s email—the Skype link remains the same so that didn’t matter—and I hadn’t received it either. I went to the website and got a notice the sight had a critical error. I checked my email and had received a message with a link to WP Recovery Mode and it pointed to this Plug-in as being the problem. After deactivating it, the email went out automatically, and the site came back online. Again, I love this app. Please update it to work with 5.7.2 and beyond. Thanks, Mathis…
December 19, 2017 1 reply
This plugin works great! Simple and uses a great API for the data. I like how easy it is to customize the template. Also, from a PHP standpoint, the code is well written, documented and organized. I especially like the fact that they’re autoloading things and using object oriented design. This makes it much faster for me to walk through the code and see what’s going on.
Read all 6 reviews

Contributors & Developers

“Easy Weather Widget” is open source software. The following people have contributed to this plugin.


Translate “Easy Weather Widget” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



  • Validate that this plugin works with WordPress 4.9.1


  • Fix for missing wi-day-partly-cloudy class (changed to wi-day-cloudy)


  • Add translation domain


  • Fix translation issue
  • Clean up the widget’s markup
  • Adapt the SCSS to be more BEM like
  • Fix some issues where we were not implementing interfaces properly


  • Adding more information to help show users how to obtain an API
  • Refactor IoC container for cache
  • Add filter to hook into IoC container


  • Internal efficiency updates
  • Fix bugs for unset widgets throwing warnings


  • Breaking changes, rewrote from the ground up!


  • Added ability to have multiple instances of the widget on a single page

  • Fix for malformed markup in the admin


  • Made plugin translatable


  • CSS bugfix


  • Bugfix causing classes not to be loaded properly


  • Fix to enable caching


  • Rewrote widget
  • Ability to change the title of the widget
  • Ability to set the temperature scale (Fahrenheit, Celsius or Kelvin)


  • Initial Release