=== 30YearWeather Widget ===
Contributors: 30yearweather
Donate link: https://30yearweather.com
Tags: weather, widget, travel, climate, temperature, forecast, embed, tourism, best time to visit
Requires at least: 5.8
Tested up to: 6.9
Stable tag: 1.0.2
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Embed beautiful weather widgets showing 30 years of historical climate data for 470+ destinations worldwide.

== Description ==

**30YearWeather Widget** allows you to embed stunning, data-driven weather widgets on your WordPress site. Perfect for travel blogs, tourism websites, and destination guides.

= Key Features =

* **470+ Cities Worldwide** – From Paris to Tokyo, Bali to New York
* **30 Years of Data** – Based on NASA satellite historical records
* **Best Time to Visit** – Help your readers plan their trips
* **Temperature Charts** – Visual yearly temperature overview
* **Two Themes** – Dark and light mode to match your site
* **Two Layouts** – Classic (data-focused) or Visual (photo card)
* **Gutenberg Block** – Easy drag-and-drop in the new editor
* **Shortcode Support** – Works in classic editor too
* **Responsive** – Looks great on mobile devices
* **No API Key Required** – Just install and use

= Use Cases =

* Travel blogs showcasing destination weather
* Tourism websites helping visitors plan
* Hotel and resort websites
* Study abroad information pages
* Wedding planning resources
* Photography location guides

= How It Works =

The plugin embeds an iframe from 30yearweather.com that displays real-time weather data pulled from our servers. The data is based on 30 years of NASA POWER satellite observations, providing reliable historical averages.

= Shortcode Usage =

`[30yearweather city="prague" theme="dark" width="400" height="450"]`

**Parameters:**
* `city` – City slug (e.g., "paris", "new-york", "tokyo")
* `theme` – "dark" or "light"
* `layout` – "classic" or "visual"
* `content` – Comma-separated sections: "bestMonths,climate,temperatures,rain,humidity,tourism"
* `width` – Widget width in pixels (200-800)
* `height` – Widget height in pixels (150-800)

= Privacy =

This plugin embeds content from 30yearweather.com via iframe. No personal data from your visitors is collected or transmitted. The embedded widget does not use cookies or tracking scripts.

For more information, see our [Privacy Policy](https://30yearweather.com/privacy).

== Installation ==

= Automatic Installation =

1. Go to **Plugins > Add New** in your WordPress admin
2. Search for "30YearWeather Widget"
3. Click **Install Now** and then **Activate**

= Manual Installation =

1. Download the plugin ZIP file
2. Go to **Plugins > Add New > Upload Plugin**
3. Upload the ZIP file and click **Install Now**
4. Activate the plugin

= Using the Plugin =

**Gutenberg Block:**
1. Edit a post or page
2. Add a new block and search for "Weather Widget"
3. Select a city and customize settings in the sidebar
4. Publish!

**Shortcode:**
1. Add this shortcode to any post or page:
2.    `[30yearweather city="paris" theme="dark"]`
3. Replace "paris" with your desired city slug

== Frequently Asked Questions ==

= What cities are available? =

We support 470+ destinations worldwide. Popular cities include Paris, London, Tokyo, New York, Barcelona, Rome, Dubai, Bali, Sydney, and many more. Visit [30yearweather.com/widgets](https://30yearweather.com/widgets) to browse all available cities.

= Is this plugin really free? =

Yes! The plugin is 100% free and always will be. We provide this as a service to the travel community.

= Do I need an API key? =

No API key is required. Just install, activate, and start using.

= Can I customize the widget appearance? =

Yes! You can choose between dark and light themes, two different layouts (classic or visual), adjust the dimensions, and select which information sections to display.

= Does this affect my site's performance? =

The widget loads via a lazy-loaded iframe, meaning it only loads when the visitor scrolls to it. This has minimal impact on your page load time.

= Is the data accurate? =

Our data is based on 30 years of NASA POWER satellite observations. We show historical averages and probabilities, not real-time forecasts.

= Can I use multiple widgets on one page? =

Absolutely! You can add as many widgets as you need, each showing a different city.

== Screenshots ==

1. Weather widget showing Prague climate data (dark theme)
2. Widget in Gutenberg editor with settings panel
3. Light theme widget example
4. Visual layout with city photo background
5. Shortcode usage in classic editor
6. Dashboard quick-add widget

== Changelog ==

= 1.0.2 =
* Remove WordPress.org directory assets from plugin package
* Assets (icon, banner) to be uploaded separately via SVN after approval

= 1.0.1 =
* Fix plugin headers to match WordPress standards
* Minor improvements

= 1.0.0 =
* Initial release
* Gutenberg block support
* Shortcode support
* Dark and light themes
* Classic and visual layouts
* 470+ cities worldwide
* Dashboard widget

== Upgrade Notice ==

= 1.0.2 =
Removed directory assets from plugin package per review feedback.

= 1.0.1 =
Minor fix for plugin header standards compliance.

= 1.0.0 =
Initial release of 30YearWeather Widget. Embed beautiful weather data on your WordPress site!
