# HD Weather Widget by The Waypoint

A beautiful HD weather widget with high-resolution 331dpi backgrounds, 5-day forecasts, and modern OpenWeatherMap integration.

## Version 1.2.0

![WordPress](https://img.shields.io/badge/wordpress-5.0%2B-blue)
![PHP](https://img.shields.io/badge/php-7.4--8.2-blue)
![License](https://img.shields.io/badge/license-GPLv2%2B-green)

## Features

- ✅ HD Quality 331dpi weather backgrounds (48 conditions)
- ✅ 5-day forecast (configurable)
- ✅ Current conditions (temp, humidity, wind)
- ✅ Multiple locations support
- ✅ OpenWeatherMap v2.5 API (HTTPS)
- ✅ WebP optimized images (92% smaller)
- ✅ Shortcode & widget support
- ✅ 30-minute caching
- ✅ Responsive design

## Quick Start

1. **Get API Key**: [OpenWeatherMap](https://openweathermap.org/appid) (free)
2. **Install**: Upload to `/wp-content/plugins/` and activate
3. **Configure**: Settings → HD Weather Widget, enter API key
4. **Use**: Add shortcode or widget

### Shortcode Example

```
[waypoint-weather lat="48.0624" lon="-114.0733" units="F" size="tall" forecast_days="hide" override_title="Bigfork, Montana, US"]
```

## Requirements

- WordPress 5.0+
- PHP 7.4 to 8.2
- OpenWeatherMap API key (free)

## Installation

### WordPress Admin
1. Plugins → Add New → Upload Plugin
2. Choose ZIP file → Install → Activate
3. Settings → HD Weather Widget → Enter API key

### Manual
1. Extract ZIP to `/wp-content/plugins/`
2. Activate via Plugins menu
3. Configure in Settings → HD Weather Widget

## Documentation

Full documentation in Settings → HD Weather Widget after installation.

### Parameters

- `location` - lat/long
- `units` - F or C
- `size` - tall
- `forecast_days` - 1-5 or hide
- `hide_stats` - 0 or 1
- `show_link` - 0 or 1
- `override_title` - Custom text
- `background` - Custom image URL

## Changelog

### 1.1.0 - October 24, 2025
- PHP 7.4-8.2 compatible
- WordPress 6.6.1 tested
- WebP images (92.4% smaller)
- API v2.5 with HTTPS
- Security hardening
- Admin documentation
- Performance improvements

### 1.0.0 - December 5, 2013
- Initial release

## Credits

- Original: John Grefe, James Steward - The Waypoint (2013)
- Based On: Awesome Weather Widget by Hal Gatewood
- Modernized: John Grefe & Evaline Grefe 
- Weather Data: OpenWeatherMap

## License

GPLv2 or later
