Module UltimateMeteo EN

UltimateMeteo Module

Overview

The UltimateMeteo module is an extension for Dolibarr ERP/CRM published by Atoo-Net.

It displays real-time weather information directly on your third-party, supplier and contact cards, based on the address saved in Dolibarr. It uses free APIs and does not require any API key.

Property	Value
Author	Philippe Grand — Atoo-Net
Version	24.0.0
License	GNU GPL v3+
Minimum Dolibarr version	v24.0
Minimum PHP version	v8.0

Why use UltimateMeteo?

Weather conditions have a direct impact on many professional activities. UltimateMeteo integrates weather information where you need it — directly in your Dolibarr cards — so you can make better decisions without switching tools.

Use cases

Construction & Building trades

Before scheduling an outdoor intervention such as roofing, painting or foundations, check the weather forecast at your customer’s address directly from their card. Avoid sending a team to a worksite in rain or freezing conditions.

Agriculture & Landscaping

When planning treatments, sowing or mowing, check the weather conditions at your customer’s location. A quick look at the Weather tab tells you whether the week is suitable — without leaving Dolibarr.

Transport & Logistics

When preparing a delivery or pickup, check the wind speed and weather conditions at the destination. This helps anticipate delays, adjust routes or notify the customer in advance.

Events & Outdoor services

For caterers, event organizers or rental companies, knowing the forecast at the venue address helps confirm or adjust on-site logistics such as marquees, heating or staff equipment.

Field sales teams

Sales representatives on the road can check the weather at each stage before leaving. Combined with agenda management in Dolibarr, this provides planning that takes weather hazards into account.

Customer service & After-sales service

When a customer reports a problem such as water infiltration, equipment failure or a power outage, instantly viewing the recent weather at their address helps qualify the incident and prioritize the intervention.

Installation

Download the module from DoliStore
Unzip it and place the ultimatemeteo/ folder in htdocs/custom/
Go to Home → Setup → Modules/Applications
Find UltimateMeteo in the AtooNet section
Enable the module by clicking the button in the Enabled column

Enabling the UltimateMeteo module in the AtooNet section

Configuration

Permissions configuration

After enabling the module, configure access rights by user group in Home → Setup → Users & Groups → Groups:

Permission	Description
`Read weather data`	Allows users to view weather tabs on cards
`Create / Modify`	Allows users to trigger a data refresh
`Delete`	Allows users to delete weather records

Data cache

Since version 24.0.0, the module uses an intelligent cache:

Weather data is stored in the database in the llx_ultimatemeteo_currentweather table
If a record exists for a third party and is less than 30 minutes old, the data is updated with an UPDATE instead of creating a new record
If no recent record exists, a new one is created
This mechanism prevents excessive accumulation of rows in the database

Time zone

The module automatically detects the time zone configured in Dolibarr through the MAIN_TIMEZONE constant. If this constant is not defined, the default PHP server time zone is used.

Usage

Weather tab

The module adds a Weather tab to each third-party card: customers, prospects and suppliers.

When opening this tab, Dolibarr:

Retrieves the address, postal code and city saved on the card
Geocodes the address through the OpenStreetMap Nominatim API to obtain GPS coordinates
Queries the Open-Meteo API to retrieve current weather and forecasts
Displays the results with an interactive map

Weather tab on a Third Party card — current weather, forecasts and map

The displayed information includes:

Field	Description
Temperature (°C)	Current temperature in degrees Celsius
Wind speed (km/h)	Wind speed in km/h
Weather description	Weather condition: Clear sky, Overcast, Rain, Snow, Thunderstorm, etc.
Date	Date and time of the last observation

Weather forecast for the coming days

Below the current data, a table displays the forecast for 5 days with, for each day:

The date
The minimum temperature (Min)
The maximum temperature (Max)

Interactive map

An interactive OpenStreetMap map, using Leaflet 1.9.4, is displayed at the bottom of the page with:

A marker positioned on the third party’s city
A popup showing the location name
Zoom +/− available
OpenStreetMap attribution compliant with the OSM tile usage policy

Contact tab

The same Weather tab is available on contact/address cards. It works in the same way, using the contact’s address.

Weather tab on a Contact card

Supported weather conditions

The module uses standard WMO codes and automatically translates them into 5 languages: FR, EN, DE, ES, IT.

WMO code	Description
0	Clear sky
1	Mainly clear
2	Partly cloudy
3	Overcast
45 / 48	Fog / Depositing rime fog
51 / 53 / 55	Light / moderate / dense drizzle
61 / 63 / 65	Slight / moderate / heavy rain
71 / 73 / 75	Slight / moderate / heavy snow
77	Snow grains
80 / 81 / 82	Slight / moderate / violent rain showers
85 / 86	Slight / heavy snow showers
95	Thunderstorm
96 / 99	Thunderstorm with slight / heavy hail

APIs used

The module relies on entirely free APIs, with no registration or API key required:

API	Role	URL
Open-Meteo	Current weather and forecasts	https://api.open-meteo.com
OpenStreetMap Nominatim	Address geocoding → GPS coordinates	https://nominatim.openstreetmap.org
Leaflet 1.9.4	Interactive map library	https://leafletjs.com
OpenStreetMap Tiles	Map tiles	https://tile.openstreetmap.org

New in version 24.0.0

Fixes

403r error on OpenStreetMap maps: added referrerPolicy and attribution in compliance with the 2026 OSM tile policy
Leaflet pinned to version 1.9.4 with SRI integrity verification, instead of using an unversioned CDN URL
Secure API calls: replaced file_get_contents with cURL and a compliant User-Agent in the third-party hook
Data cache: UPDATE/INSERT mechanism with a 30-minute cache, removing systematic INSERTs on each display
Dynamic time zone: uses the Dolibarr configuration instead of a hard-coded Europe/Paris time zone

Improvements

Complete weather codes: added WMO codes 71–99, covering snow, showers, thunderstorms and hail, in the 5 language files
Internationalization: weather descriptions now use the Dolibarr translation system with $langs->trans()
Wiki help links: added contextual links to the wiki documentation on all module pages
Dolibarr v24 compatibility: updated patterns to comply with v24 conventions

FAQ

The weather is not displayed

Check that the third-party or contact card has both a postal code and a city filled in. Geocoding requires at least a city.

The map displays "Access blocked" or "403r"

This issue has been fixed in version 24.0.0. OpenStreetMap strengthened its Referer policy in early 2026. The update includes:

Adding referrerPolicy: "strict-origin-when-cross-origin" in the Leaflet configuration
Pinning Leaflet to a stable version, 1.9.4

If you still see this error, check that you are using version 24.0.0 of the module.

Is weather data updated automatically?

Data is retrieved each time the Weather tab is opened. A 30-minute cache prevents repeated API calls: if the data is less than 30 minutes old, it is simply updated in the database.

Does the module work offline?

No. The module requires Internet access to query the Open-Meteo and Nominatim APIs.

Which languages are supported?

The module is available in: French, English, German, Spanish, Italian.

How can I access the online help?

Each module page includes a contextual help link, using the ? icon in the top-right corner, which points to the corresponding section of this wiki page.

Other languages

French documentation for the UltimateMeteo module