Meteo - weather module

[maximus]

Meteo is a weather integration module for ProcessWire. It fetches current weather and forecast data, normalizes responses from different providers into one predictable array format, and can optionally render ready-made weather widgets.

Providers

Meteo supports:

• Open-Meteo
• OpenWeatherMap
• WeatherAPI.com

Open-Meteo works without an API key. OpenWeatherMap and WeatherAPI.com can be used as primary or fallback providers when API keys are configured.

Features

• Current weather, hourly forecast, and daily forecast
• City geocoding
• Provider fallback chain
• File cache with configurable TTL
• Structured array output for custom templates or frontend frameworks
• Bundled widget templates: card, full, minimal
• Widget themes: auto, light, dark
• One-click Material M3 demo page installer
• Error tracking via getLastError()

Basic usage

$meteo = $modules->get('Meteo');

$weather = $meteo->getWeather(40.7128, -74.0060, [
    'location_name' => 'King of Prussia',
    'timezone' => 'America/New_York',
]);

echo $weather['current']['temperature'];
echo $weather['current']['weather_label'];

Render a bundled widget:

echo $modules->Meteo->styleTag();

echo $modules->Meteo->renderWidgetForCity('King of Prussia', [
    'language' => 'en',
    'widget_theme' => 'auto',
], 'card');

 

Links

• GitHub: https://github.com/mxmsmnv/Meteo
• Documentation: https://github.com/mxmsmnv/Meteo/blob/main/docs/USAGE.md

[Peter Knight]

Nice illustration too 🙂 Did you need this module developed for your forums?

[maximus]

Thanks Peter!

Not specifically for the forums. I needed a reusable weather module for ProcessWire projects: normalized provider data, cache, fallbacks, geocoding, and optional widgets.

The illustration is basically a quick visual overview of the module features. For some modules there isn’t always a meaningful screenshot to show, especially when the main value is in the API or backend logic, so I decided to make a small illustration for each module. It makes the project easier to scan and gives the release page a more polished, professional feel 🙂

[maximus]

Meteo update: Apple WeatherKit provider

Small update for Meteo: Apple WeatherKit support has been added.

Meteo now supports these providers:

• Open-Meteo
• OpenWeatherMap
• WeatherAPI.com
• Apple WeatherKit

Apple WeatherKit uses Apple REST API authentication and requires ES256 JWT tokens. For that part Meteo now uses a separate helper module, TokenForge, which handles JWT generation and caching.

• Meteo repository: https://github.com/mxmsmnv/Meteo
• TokenForge repository: https://github.com/mxmsmnv/TokenForge

Apple WeatherKit requirements

To use the Apple provider you need:

• Apple Developer account
• Team ID
• WeatherKit Services ID
• Key ID
• downloaded Apple .p8 private key
• TokenForge installed

Recommended key location is a private, non-public path such as:

/site/assets/private/AuthKey_YOURKEYID.p8

Meteo asks TokenForge to create and cache the short-lived WeatherKit JWT, then sends it as a Bearer token to Apple WeatherKit.

This update is in Meteo 1.1.0.