Weather Block

Description

Weather Block is a simple and elegant WordPress block that displays real-time weather information for any city. The block fetches weather data from OpenWeatherMap API and presents it in a clean, responsive design.

Features

• 🌤️ Real-time weather data from OpenWeatherMap API
• ⚡ Smart caching — weather data is cached for 15 minutes per city to minimize API calls
• 🏙️ Customizable city input
• 🌡️ Temperature display in Fahrenheit
• 💧 Humidity percentage
• 💨 Wind speed in miles per hour
• 🎨 Clean, modern UI design
• 📱 Responsive layout
• 🔒 Secure API integration

Screenshots

The weather block displays:

• City name and weather description
• Weather icon from OpenWeatherMap
• Current temperature in Fahrenheit
• Humidity percentage with icon
• Wind speed with icon

Installation

Method 1: WordPress Admin (Recommended)

1. Download the Plugin

   • Download the Weather Block plugin ZIP file
   • Or clone the repository to your local machine

2. Install via WordPress Admin

   • Log in to your WordPress admin dashboard
   • Navigate to Plugins → Add New
   • Click Upload Plugin at the top of the page
   • Choose the Weather Block ZIP file
   • Click Install Now
   • After installation, click Activate Plugin

Method 2: Manual Installation

1. Upload Files

   • Extract the Weather Block ZIP file
   • Upload the weatherblock folder to your /wp-content/plugins/ directory
   • Ensure the folder structure is: /wp-content/plugins/weatherblock/

2. Activate the Plugin

   • Go to your WordPress admin dashboard
   • Navigate to Plugins → Installed Plugins
   • Find "Weather Block" in the list
   • Click Activate

Method 3: FTP Upload

1. Connect via FTP

   • Use an FTP client to connect to your server
   • Navigate to /wp-content/plugins/

2. Upload Files

   • Upload the entire weatherblock folder
   • Ensure all files are uploaded correctly

3. Activate

   • Go to WordPress admin → Plugins
   • Activate the Weather Block plugin

Usage

Adding the Weather Block

1. Edit a Post or Page

   • Create a new post/page or edit an existing one
   • Open the block editor (Gutenberg)

2. Insert the Block

   • Click the + button to add a new block
   • Search for "Weather Block" or "Weather"
   • Click on the Weather Block to insert it

3. Configure the Block

   • In the block settings panel (right sidebar)
   • Enter a city name in the "City Name" field
   • The block will automatically fetch and display weather data

Block Settings

• City Name: Enter any city name (default: Managua)
• The block automatically updates with current weather information
• Weather data includes temperature, humidity, and wind speed

Frequently Asked Questions

What weather data is displayed?

The block shows:

• Current temperature in Fahrenheit
• Weather description (e.g., "clear sky", "rain")
• Humidity percentage
• Wind speed in miles per hour
• Weather icon from OpenWeatherMap

Can I change the default city?

Yes! Simply edit the "City Name" field in the block settings to display weather for any city.

Is the weather data real-time?

Weather data is fetched from OpenWeatherMap and then cached for 15 minutes per city using the WordPress Transients API. This means the first visitor for a city triggers a live API call, and all subsequent requests within that 15-minute window are served from cache — resulting in faster page loads and lower API usage.

Does this plugin require an API key?

Yes. You need to provide your own OpenWeatherMap API key. Once you have a key, navigate to Settings → Weather Block in your WordPress admin dashboard to configure it.

Changelog

0.3.0

• Added 15-minute transient caching layer per city (reduces API calls, improves page load performance)
• Added weatherblock_clear_cache() helper for manual cache invalidation
• Bumped version and refactored central fetch function with inline documentation

0.2.0

• Refactored codebase for better maintainability
• Centralized API logic into weatherblock_fetch_from_api() helper
• Added Block Bindings API support (weatherblock/weather-data, weatherblock/city-name)
• Added custom REST API endpoint (/wp-json/weatherblock/v1/weather)
• Added Admin Settings page for API key configuration

0.1.0

• Initial release
• Weather block with city input
• Temperature, humidity, and wind speed display
• OpenWeatherMap API integration

Support

For support, feature requests, or bug reports, please contact the plugin author.

Credits

• Weather data provided by OpenWeatherMap
• Icons from OpenWeatherMap API
• Built with WordPress Block Editor (Gutenberg)