Module UltimateMeteo IT

Modulo UltimateMeteo

Presentazione

Il modulo UltimateMeteo è un'estensione per Dolibarr ERP/CRM pubblicata da Atoo-Net.

Visualizza la meteorologia in tempo reale direttamente nelle schede dei terzi, fornitori e contatti, basandosi sull'indirizzo registrato in Dolibarr. Utilizza API gratuite e non richiede alcuna chiave API.

Proprietà	Valore
Autore	Philippe Grand — Atoo-Net
Versione	24.0.0
Licenza	GNU GPL v3+
Dolibarr minimo	v24.0
PHP minimo	v8.0

Perché utilizzare UltimateMeteo?

Le condizioni meteorologiche hanno un impatto diretto su molte attività professionali. UltimateMeteo integra le informazioni meteo dove servono — direttamente nelle schede Dolibarr — per prendere decisioni migliori senza cambiare strumento.

Casi d'uso

Edilizia e mestieri del settore costruzioni

Prima di pianificare un intervento esterno, come lavori su tetti, tinteggiatura o fondazioni, è possibile consultare le previsioni meteo all'indirizzo del cliente direttamente dalla sua scheda. In questo modo si evita di inviare una squadra in cantiere sotto la pioggia o con gelo.

Agricoltura e aree verdi

Durante la pianificazione di trattamenti, semine o lavori di sfalcio, è possibile verificare le condizioni meteo presso il cliente. Un semplice sguardo alla scheda Meteo indica se la settimana è favorevole — senza uscire da Dolibarr.

Trasporto e logistica

Durante la preparazione di una consegna o di un ritiro, è possibile verificare la velocità del vento e le condizioni meteo a destinazione. Questo permette di anticipare eventuali ritardi, adattare i percorsi o avvisare il cliente in anticipo.

Eventi e servizi esterni

Per catering, organizzatori di eventi o società di noleggio, conoscere le previsioni all'indirizzo del luogo dell'evento permette di confermare o adattare la logistica sul posto, ad esempio tensostrutture, riscaldamento o attrezzature del personale.

Forze vendita sul campo

I commerciali in trasferta possono consultare la meteorologia a ogni tappa prima di partire. In combinazione con la gestione dell'agenda in Dolibarr, questo consente una pianificazione che tiene conto degli imprevisti climatici.

Servizio clienti e assistenza post-vendita

Quando un cliente segnala un problema, come infiltrazioni d'acqua, guasto di un'attrezzatura o interruzione di corrente, visualizzare immediatamente la meteorologia recente al suo indirizzo aiuta a qualificare l'incidente e a dare priorità all'intervento.

Installazione

Scaricare il modulo da DoliStore
Decomprimere l'archivio e collocare la cartella ultimatemeteo/ in htdocs/custom/
Andare in Home → Configurazione → Moduli/Applicazioni
Individuare UltimateMeteo nella sezione AtooNet
Attivare il modulo facendo clic sul pulsante nella colonna Attivato

Attivazione del modulo UltimateMeteo nella sezione AtooNet

Configurazione

Configurazione dei permessi

Dopo l'attivazione, configurare i diritti di accesso per gruppo di utenti in Home → Configurazione → Utenti e gruppi → Gruppi:

Permesso	Descrizione
`Leggere i dati meteo`	Permette di visualizzare le schede meteo nelle schede degli elementi
`Creare / Modificare`	Permette di avviare un aggiornamento dei dati
`Eliminare`	Permette di eliminare i record meteo

Cache dei dati

Dalla versione 24.0.0, il modulo utilizza una cache intelligente:

I dati meteorologici sono memorizzati nel database nella tabella llx_ultimatemeteo_currentweather
Se esiste un record per un terzo da meno di 30 minuti, i dati vengono aggiornati tramite UPDATE invece di creare un nuovo record
Se non esiste alcun record recente, ne viene creato uno nuovo
Questo meccanismo evita un accumulo eccessivo di righe nel database

Fuso orario

Il modulo rileva automaticamente il fuso orario configurato in Dolibarr tramite la costante MAIN_TIMEZONE. Se questa costante non è definita, viene utilizzato il fuso orario predefinito del server PHP.

Utilizzo

Scheda Meteo

Il modulo aggiunge una scheda Meteo a ogni scheda di terzo: clienti, potenziali clienti e fornitori.

All'apertura di questa scheda, Dolibarr:

Recupera l'indirizzo, il codice postale e la città salvati nella scheda
Geocodifica l'indirizzo tramite l'API OpenStreetMap Nominatim per ottenere le coordinate GPS
Interroga l'API Open-Meteo per recuperare la meteorologia attuale e le previsioni
Visualizza i risultati con una mappa interattiva

Scheda Meteo in una scheda Terzo — meteo attuale, previsioni e mappa

Le informazioni visualizzate sono:

Campo	Descrizione
Temperatura (°C)	Temperatura attuale in gradi Celsius
Velocità del vento (km/h)	Velocità del vento in km/h
Descrizione meteo	Condizione meteorologica: cielo sereno, coperto, pioggia, neve, temporale…
Data	Data e ora dell'ultima osservazione

Previsioni meteo dei prossimi giorni

Sotto i dati attuali, una tabella mostra le previsioni per 5 giorni con, per ogni giornata:

La data
La temperatura minima (Min)
La temperatura massima (Max)

Mappa interattiva

Una mappa interattiva OpenStreetMap tramite Leaflet 1.9.4 viene visualizzata nella parte inferiore della pagina con:

Un marker posizionato sulla città del terzo
Un popup che indica il nome della località
Zoom +/− disponibile
Attribuzione OpenStreetMap conforme alla politica di utilizzo delle tile OSM

Scheda Contatto

La stessa scheda Meteo è disponibile nelle schede contatti/indirizzi. Funziona in modo identico utilizzando l'indirizzo del contatto.

Scheda Meteo in una scheda Contatto

Condizioni meteorologiche supportate

Il modulo utilizza i codici WMO standard e li traduce automaticamente in 5 lingue: FR, EN, DE, ES, IT.

Codice WMO	Descrizione
0	Cielo sereno
1	Prevalentemente sereno
2	Parzialmente nuvoloso
3	Coperto
45 / 48	Nebbia / Nebbia con brina
51 / 53 / 55	Pioviggine leggera / moderata / intensa
61 / 63 / 65	Pioggia leggera / moderata / forte
71 / 73 / 75	Neve leggera / moderata / forte
77	Granuli di neve
80 / 81 / 82	Rovesci leggeri / moderati / violenti
85 / 86	Rovesci di neve leggeri / forti
95	Temporale
96 / 99	Temporale con grandine leggera / forte

API utilizzate

Il modulo si basa su API completamente gratuite, senza registrazione e senza chiave API richiesta:

API	Ruolo	URL
Open-Meteo	Meteo attuale e previsioni	https://api.open-meteo.com
OpenStreetMap Nominatim	Geocodifica indirizzo → coordinate GPS	https://nominatim.openstreetmap.org
Leaflet 1.9.4	Libreria per mappe interattive	https://leafletjs.com
OpenStreetMap Tiles	Tile cartografiche	https://tile.openstreetmap.org

Novità della versione 24.0.0

Correzioni

Errore 403r sulle mappe OpenStreetMap: aggiunta di referrerPolicy e dell'attribuzione conforme alla politica delle tile OSM 2026
Leaflet bloccato alla versione 1.9.4 con verifica di integrità SRI, invece di un URL CDN non versionato
Chiamate API sicure: sostituzione di file_get_contents con cURL e User-Agent conforme nell'hook dei terzi
Cache dei dati: meccanismo UPDATE/INSERT con cache di 30 minuti, eliminando gli INSERT sistematici a ogni visualizzazione
Fuso orario dinamico: utilizzo della configurazione Dolibarr invece di un fuso orario Europe/Paris codificato in modo fisso

Miglioramenti

Codici meteo completi: aggiunta dei codici WMO 71–99, che coprono neve, rovesci, temporali e grandine, nei 5 file di lingua
Internazionalizzazione: le descrizioni meteo utilizzano ora il sistema di traduzione Dolibarr $langs->trans()
Link di aiuto wiki: aggiunta di link contestuali alla documentazione wiki in tutte le pagine del modulo
Compatibilità Dolibarr v24: aggiornamento dei pattern per rispettare le convenzioni v24

FAQ

La meteorologia non viene visualizzata

Verificare che nella scheda del terzo o del contatto siano correttamente inseriti un codice postale e una città. La geocodifica richiede almeno una città.

La mappa mostra "Access blocked" o "403r"

Questo problema è stato corretto nella versione 24.0.0. OpenStreetMap ha rafforzato la propria politica Referer all'inizio del 2026. L'aggiornamento include:

L'aggiunta di referrerPolicy: "strict-origin-when-cross-origin" nella configurazione Leaflet
Il blocco di Leaflet su una versione stabile, 1.9.4

Se visualizzate ancora questo errore, verificate di utilizzare correttamente la versione 24.0.0 del modulo.

I dati meteo vengono aggiornati automaticamente?

I dati vengono recuperati ogni volta che viene aperta la scheda Meteo. Una cache di 30 minuti evita chiamate API ripetitive: se i dati hanno meno di 30 minuti, vengono semplicemente aggiornati nel database.

Il modulo funziona offline?

No. Il modulo richiede un accesso a Internet per interrogare le API Open-Meteo e Nominatim.

Quali lingue sono supportate?

Il modulo è disponibile in: Francese, Inglese, Tedesco, Spagnolo, Italiano.

Come accedere all'aiuto online?

Ogni pagina del modulo dispone di un link di aiuto contestuale tramite l'icona ? in alto a destra, che rimanda alla sezione corrispondente di questa pagina wiki.

Vedi anche

Altre lingue