Track weather conditions during your visitors' sessions and correlate weather with behaviour. The plugin adds 11 new visit dimensions (temperature, humidity, pressure, wind, …) populated from WeatherAPI; each one ships with its own report, segment, API method and goal/conversion metrics.
- 11 weather dimensions: Condition, Cloud, Temperature, Felt temperature, Humidity, Pressure, Precipitation, UV, Visibility, Wind direction, Wind speed.
- Goals & conversions on every dimension: break down conversion rate, conversions and revenue by
any weather metric. Weather is also persisted to
log_conversion, so historical conversions stay pinned to the weather they were tracked under. - Segments for every dimension (
weatherTemperature,weatherCondition, …). - Conditions in the language of each user: condition texts are matched against the official WeatherAPI list and displayed in the Matomo user's language, the same condition tracked in several languages is merged.
- Units follow the website settings: per-site units (°C/°F, mm/in, mb/inHg, km/mi, km/h/mph) on a dedicated Administration → Websites → Weather page. The Weather tag sends metric values, Matomo converts them when tracking.
- WeatherAPI key kept on the server: save the key in the plugin settings, the Weather tag gets the weather through Matomo and the key never appears in your website code.
- Bar-chart visualizations for scale-based reports with logical numeric ordering on the x-axis
(1, 2, 10, 20, not 1, 10, 2, 20), unit shown in the column title (
Temperature (°C)). - Top 15 + Others on categorical reports by default (Condition, Wind direction).
- Visitor log weather card (Vue component) following Matomo's light and dark themes, with a wind direction arrow.
- Matomo Tag Manager template included (Openmost category).
- Weather attached to every visit of a browser session: the weather is cached for one hour and added to the tracking requests, no extra request.
- Privacy friendly: through Matomo, WeatherAPI only receives rounded coordinates or a truncated IP. No third-party IP-geolocation service.
- Tracking input is validated: out-of-range or malformed values are dropped at ingest (Humidity 0-100, UV 0-20, Wind direction restricted to the 16-point compass, …).
Install via the Matomo Marketplace, or upload to plugins/WeatherReports and activate.
On activation Matomo will offer a database migration that adds the weather_* columns to
log_visit and log_conversion. See docs/index.md for the full setup walk-through
and docs/faq.md for FAQ.
./vendor/bin/phpunit -c plugins/WeatherReports/phpunit.xml --testsuite "WeatherReports Unit"
TZ=UTC npx vitest run plugins/WeatherReportsThe visitor log card is a Vue component built with the Matomo Vite build (Node 24):
./console vue:build WeatherReportsThe condition translations in data/conditions.php are generated from
https://www.weatherapi.com/docs/conditions.json.
Weather is looked up from the visitor location. Through the Matomo endpoint (recommended), WeatherAPI receives the coordinates found by Matomo geolocation rounded to about 10 km, or the visitor IP without its last byte. When the tag calls WeatherAPI directly with its own key, WeatherAPI receives the visitor IP. Mention it in your privacy policy.
- Matomo 6.x
- PHP 8.1+
- MySQL 8.0+ or MariaDB 10.6+
- Marketplace: https://plugins.matomo.org/WeatherReports
- Issues: https://github.com/openmost/WeatherReports/issues
- Homepage: https://openmost.com/matomo/extensions/weather-reports
GPL v3 or later
