Module UltimateMeteo IT
Modulo UltimateMeteo
Presentazione
Il modulo UltimateMeteo è un'estensione per Dolibarr ERP/CRM pubblicata da Atoo-Net.
Visualizza il meteo in tempo reale direttamente nelle schede di terzi, fornitori, contatti e membri, 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.2 |
| Licenza | GNU GPL v3+ |
| Versione minima di Dolibarr | v24.0 |
| Versione minima di PHP | v8.0 |
Perché utilizzare UltimateMeteo?
Le condizioni meteorologiche hanno un impatto diretto su numerose attività professionali. UltimateMeteo integra le informazioni meteo esattamente dove servono — direttamente nelle schede Dolibarr — per prendere decisioni migliori senza cambiare strumento.
Casi d'uso
Edilizia e professioni del settore
Prima di pianificare un intervento esterno, come lavori sul tetto, verniciatura o fondazioni, 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 manutenzione del verde
Durante la pianificazione di trattamenti, semine o sfalci, verificare le condizioni meteo presso il cliente. Un semplice sguardo alla scheda Meteo indica se la settimana è favorevole, senza uscire da Dolibarr.
Trasporti e logistica
Durante la preparazione di una consegna o di un ritiro, verificare la velocità del vento e le condizioni meteo a destinazione. Ciò consente di anticipare ritardi, adattare gli itinerari o avvisare il cliente in anticipo.
Eventi e servizi all'aperto
Per catering, organizzatori di eventi o società di noleggio, conoscere le previsioni all'indirizzo del luogo consente di confermare o adattare la logistica sul posto, come tendoni, riscaldamento o equipaggiamento del personale.
Forza vendita sul territorio
I commerciali in trasferta possono consultare il meteo a ogni tappa prima di partire. Abbinato alla gestione dell'agenda in Dolibarr, ciò 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, guasti alle apparecchiature o interruzioni di corrente, visualizzare immediatamente il meteo recente al suo indirizzo aiuta a qualificare l'incidente e a stabilire la priorità dell'intervento.
Installazione
- Scaricare il modulo da DoliStore
- Decomprimere e posizionare la cartella
ultimatemeteo/inhtdocs/custom/ - Accedere a Home → Configurazione → Moduli/Applicazioni
- Individuare UltimateMeteo nella sezione AtooNet
- Attivare il modulo facendo clic sul pulsante della colonna Attivo
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 |
Consente di visualizzare le schede meteo nelle varie anagrafiche |
Creare / Modificare |
Consente di avviare un aggiornamento dei dati |
Eliminare |
Consente di eliminare i record meteo |
Parametri del modulo
Dalla versione 24.0.1, la scheda Parametri della pagina di configurazione del modulo (Home → Configurazione → Moduli/Applicazioni → UltimateMeteo → icona ingranaggio) raggruppa tutte le impostazioni. Dalla versione 24.0.2, esse sono suddivise in cinque sezioni.
I valori predefiniti vengono impostati automaticamente all'attivazione del modulo. Vengono mantenuti anche se il modulo viene disattivato e poi riattivato.
Oggetti interessati
| Parametro | Valori | Predefinito | Descrizione |
|---|---|---|---|
| Oggetti sui quali visualizzare il meteo | Terzo, Contatto, Membro (scelta multipla) | Tutti e tre | Determina le schede Dolibarr che ricevono la scheda Meteo e, se applicabile, la riga di riepilogo nella scheda. |
La scelta Membro viene proposta solo se il modulo nativo Membri è attivato.
Nota: la modifica viene applicata immediatamente, al ricaricamento della scheda interessata. Non è necessario disattivare e riattivare UltimateMeteo. Deselezionare un oggetto nasconde la relativa scheda e impedisce l'accesso diretto alla pagina corrispondente, ma non elimina alcun dato già registrato.
Visualizzazione del meteo attuale
| Parametro | Valori | Predefinito | Descrizione |
|---|---|---|---|
| Unità di temperatura | Celsius / Fahrenheit | Celsius | Unità richiesta all'API Open-Meteo e visualizzata nella scheda Meteo. La modifica si applica sia al meteo attuale sia alla tabella delle previsioni. |
| Unità di velocità del vento | km/h, m/s, mph, nodi | km/h | Lo stesso principio si applica alla velocità del vento. L'unità nodi è utile per le attività nautiche. |
| Visualizzare il meteo nella scheda | Sì / No | Sì | Aggiunge una riga di riepilogo meteo direttamente nella scheda degli oggetti selezionati sopra, oltre alla scheda Meteo. Ogni visualizzazione della scheda genera una chiamata alle API esterne, nel rispetto della cache. |
| Soglia di allerta vento | Da 0 a 300 | 0 | Oltre questo valore, la velocità del vento viene evidenziata in rosso, sia nella scheda sia nella colonna Vento massimo delle previsioni. Il valore 0 disattiva l'allerta. |
Importante: la soglia di allerta è espressa nell'unità di vento selezionata. Se si passa da km/h a mph, ricordarsi di adeguare la soglia: non viene effettuata alcuna conversione automatica.
Previsioni
| Parametro | Valori | Predefinito | Descrizione |
|---|---|---|---|
| Visualizzare la tabella delle previsioni | Sì / No | Sì | Mostra o nasconde la tabella delle previsioni sotto il meteo attuale. |
| Numero di giorni di previsione | Da 1 a 16 | 5 | Numero di giorni visualizzati. Open-Meteo accetta fino a 16 giorni, con affidabilità decrescente oltre una settimana. |
| Colonne aggiuntive delle previsioni | elenco a scelta multipla | nessuna | Colonne opzionali aggiunte alle temperature minima e massima. |
Le colonne opzionali disponibili sono:
| Colonna | Dato Open-Meteo | Utilità |
|---|---|---|
| Descrizione meteo | weathercode |
Condizione dominante della giornata, con pittogramma |
| Precipitazioni | precipitation_sum |
Accumulo giornaliero di pioggia, in mm |
| Vento massimo | windspeed_10m_max |
Raffica massima prevista; segue la soglia di allerta vento |
| Alba / tramonto | sunrise, sunset |
Fascia oraria utilizzabile per un intervento esterno |
| Indice UV massimo | uv_index_max |
Esposizione solare, utile per la sicurezza delle squadre |
Queste colonne non comportano chiamate aggiuntive: vengono richieste nella stessa richiesta all'API Open-Meteo.
Mappa
| Parametro | Valori | Predefinito | Descrizione |
|---|---|---|---|
| Visualizzare la mappa | Sì / No | Sì | Visualizza la mappa OpenStreetMap che localizza il terzo. Disattivandola si evita il caricamento della libreria Leaflet da una CDN esterna. |
| Livello di zoom della mappa | Da 1 a 19 | 12 | 1 corrisponde al mondo intero, 19 al livello stradale. |
| Altezza della mappa (px) | Da 150 a 1200 | 500 | Altezza del riquadro della mappa, in pixel. |
Servizi esterni e parametri tecnici
| Parametro | Valori | Predefinito | Descrizione |
|---|---|---|---|
| Durata della cache (minuti) | Da 1 a 1440 | 30 | Durata di validità di un rilevamento prima che venga effettuata una nuova chiamata API. Un valore elevato riduce il numero di chiamate ai servizi esterni. |
| Timeout HTTP (secondi) | Da 1 a 60 | 5 | Tempo massimo di attesa durante le chiamate API. Un valore troppo alto rallenta la visualizzazione delle schede se un servizio non è disponibile. |
| Email di contatto tecnico | email dell'azienda | Trasmetta nell'intestazione User-Agent delle chiamate. La politica di utilizzo di Nominatim richiede che il gestore sia identificabile. Se il campo è vuoto, viene utilizzata l'email dell'azienda configurata in Dolibarr. | |
| URL del servizio di geocodifica | url | https://nominatim.openstreetmap.org/search | Servizio che converte la città del terzo in coordinate GPS. Può puntare a un'istanza Nominatim auto-ospitata. |
| URL dell'API meteo | url | https://api.open-meteo.com/v1/forecast | Servizio che fornisce i dati meteo. Può puntare a un'istanza Open-Meteo auto-ospitata. |
Nota: se uno dei due campi URL viene lasciato vuoto, il modulo utilizza automaticamente il servizio pubblico corrispondente.
Cache dei dati
Dalla versione 24.0.0, il modulo utilizza una cache intelligente:
- I dati meteo vengono memorizzati nel database nella tabella
llx_ultimatemeteo_currentweather - Se esiste un record per un terzo più recente della durata della cache configurata, 30 minuti per impostazione predefinita, i dati vengono aggiornati con UPDATE invece di creare un nuovo record
- Se non esiste alcun record recente, ne viene creato uno nuovo
- Questo meccanismo evita l'accumulo eccessivo di righe nel database
Fuso orario
Gli orari delle previsioni sono espressi nel fuso orario del luogo geocodificato tramite il parametro
timezone=auto dell'API Open-Meteo. Un terzo situato all'estero visualizza quindi i propri
orari locali e non quelli del server Dolibarr.
Utilizzo
Scheda Meteo
Il modulo aggiunge una scheda Meteo a ogni scheda terzo, cliente, potenziale cliente o fornitore, se l'oggetto Terzo è selezionato nel parametro Oggetti sui quali visualizzare il meteo.
Aprendo questa scheda, Dolibarr:
- Recupera l'indirizzo, codice postale e città, registrato nella scheda
- Geocodifica l'indirizzo tramite l'API OpenStreetMap Nominatim per ottenere le coordinate GPS
- Interroga l'API Open-Meteo per recuperare il meteo attuale e le previsioni
- Visualizza i risultati con una mappa interattiva
Le informazioni visualizzate sono:
| Campo | Descrizione |
|---|---|
| Temperatura | Temperatura attuale, nell'unità configurata, °C o °F |
| Velocità del vento | Velocità del vento, nell'unità configurata, km/h, m/s, mph o nodi. Evidenziata in rosso se viene superata la soglia di allerta |
| Descrizione meteo | Condizione meteorologica, come cielo sereno, coperto, pioggia, neve o temporale |
| Data | Data e ora dell'ultima osservazione |
Se l'opzione Visualizzare il meteo nella scheda è attiva, viene aggiunto anche un riepilogo su una riga con pittogramma, condizione, temperatura e vento direttamente nella scheda, senza dover aprire la scheda Meteo.
Previsioni meteo dei prossimi giorni
Sotto i dati attuali, una tabella visualizza le previsioni per il numero di giorni configurato, 5 giorni per impostazione predefinita, fino a 16. Ogni riga contiene:
- La data, nel fuso orario del luogo
- La temperatura minima, Min
- La temperatura massima, Max
- Le colonne opzionali attivate nella configurazione: descrizione meteo, precipitazioni, vento massimo, alba / tramonto, indice UV massimo
Questa tabella può essere completamente nascosta tramite il parametro Visualizzare la tabella delle previsioni.
Mappa interattiva
Una mappa OpenStreetMap interattiva, tramite Leaflet 1.9.4, viene visualizzata in fondo alla pagina con:
- Un indicatore 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
Il livello di zoom iniziale e l'altezza del riquadro sono configurabili e la mappa può essere disattivata per evitare qualsiasi caricamento da una CDN esterna.
Scheda Contatto
La stessa scheda Meteo è disponibile nelle schede dei contatti e degli indirizzi. Funziona allo stesso modo utilizzando l'indirizzo del contatto.
Scheda Membro
Dalla versione 24.0.2, la stessa scheda Meteo è disponibile nelle schede dei membri, a due condizioni:
- il modulo nativo Membri è attivato;
- l'oggetto Membro è selezionato nel parametro Oggetti sui quali visualizzare il meteo.
La geocodifica utilizza il codice postale e la città indicati nella scheda del membro. Un membro senza città visualizza la scheda, ma non è possibile calcolare alcun dato meteo.
I rilevamenti vengono registrati nella tabella llx_ultimatemeteo_currentweather con la
colonna fk_member. Se il membro è collegato a un terzo, viene valorizzata anche la colonna
fk_soc; altrimenti resta vuota.
Nota: la colonna fk_member viene aggiunta automaticamente durante l'aggiornamento
del modulo. Su un'installazione esistente, disattivare e riattivare UltimateMeteo una volta affinché
la modifica della struttura venga applicata. L'operazione non è distruttiva: i record esistenti vengono conservati.
Condizioni meteo 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 | Granelli di neve |
| 80 / 81 / 82 | Rovesci deboli / moderati / violenti |
| 85 / 86 | Rovesci di neve deboli / forti |
| 95 | Temporale |
| 96 / 99 | Temporale con grandine leggera / forte |
API utilizzate
Il modulo si basa su API completamente gratuite, senza registrazione né 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.2
Miglioramenti
- Scheda Meteo per i membri: nuova pagina
currentweather_member.phpche visualizza il meteo attuale, le previsioni e la mappa all'indirizzo del membro. Disponibile solo se il modulo nativo Membri è attivato - Oggetti interessati configurabili: un nuovo parametro Oggetti sui quali visualizzare il meteo consente di scegliere le schede che ricevono la scheda Meteo, Terzo, Contatto e Membro. La modifica viene applicata immediatamente, senza riattivazione del modulo
- Riepilogo nella scheda generalizzato: la riga di riepilogo meteo, in precedenza riservata ai terzi, ora viene visualizzata anche nelle schede contatto e membro selezionate
- Cache rispettata nelle tre schede: le schede terzo, contatto e membro aggiornano il record esistente finché è più recente della durata della cache configurata, invece di creare una nuova riga a ogni visualizzazione
Correzioni
- Cache realmente efficace: la freschezza di un record veniva confrontata sulla colonna
tms, unTIMESTAMPMySQL restituito in UTC, mentre Dolibarr scrive le date nel fuso orario del server. La differenza di fuso invalidava sistematicamente la cache e provocava una chiamata alle API esterne e una nuova riga a ogni visualizzazione. Il confronto viene ora effettuato sudate_weather - Warning PHP rimossi: quando la città era assente o la geocodifica non riusciva, le schede visualizzavano messaggi « Undefined variable ». Le variabili meteo vengono ora inizializzate prima della visualizzazione
- Colonna Membro nascosta: il campo
fk_membernon appare più nella tabella delle schede terzo e contatto
Database
- Nuova colonna
fk_memberinllx_ultimatemeteo_currentweather, aggiunta automaticamente al caricamento del modulo. L'operazione non è distruttiva
Novità della versione 24.0.1
Miglioramenti
- Scheda Parametri: 14 parametri di configurazione sostituiscono i valori codificati direttamente nel codice, unità, previsioni, mappa, servizi esterni, cache e timeout HTTP
- Unità configurabili: temperatura in °C o °F, vento in km/h, m/s, mph o nodi, trasmesse direttamente all'API Open-Meteo
- Allerta vento: soglia configurabile oltre la quale la velocità del vento viene evidenziata in rosso
- Previsioni configurabili: numero di giorni, da 1 a 16, e colonne opzionali, descrizione, precipitazioni, vento massimo, alba / tramonto e indice UV
- Mappa configurabile: zoom iniziale, altezza del riquadro e possibilità di disattivare completamente il caricamento dalla CDN esterna
- Servizi auto-ospitabili: gli URL di Nominatim e Open-Meteo sono configurabili per puntare alle proprie istanze
- Email di contatto tecnico: trasmessa nell'intestazione User-Agent, conformemente alla politica di utilizzo di Nominatim
- Traduzioni complete: le 5 lingue, fr, en, de, es, it, coprono ora tutte le etichette e i tooltip della configurazione
Correzioni
- Hook terzo riparato: la classe hook è stata spostata da
core/hooks/aclass/actions_ultimatemeteo.class.php, l'unica posizione analizzata dalHookManagerdi Dolibarr. Il riepilogo meteo nella scheda del terzo quindi non veniva mai visualizzato - Valori predefiniti: ora vengono impostati all'attivazione del modulo tramite
$this->const, conformemente alle pratiche del module builder - Geocodifica più precisa: la ricerca utilizza il codice postale e la città invece della sola città
- Unità nelle etichette: le diciture « (°C) » e « (km/h) » codificate direttamente nelle traduzioni sono state rimosse, poiché l'unità realmente configurata viene visualizzata accanto al valore
Novità della versione 24.0.0
Correzioni
- Errore 403r sulle mappe OpenStreetMap: aggiunta di
referrerPolicye dell'attribuzione conformemente alla politica delle tile OSM 2026 - Leaflet fissato alla versione 1.9.4 con verifica di integrità SRI, invece di un URL CDN non versionato
- Chiamate API protette: sostituzione di
file_get_contentscon cURL e User-Agent conforme nell'hook del terzo - Cache dei dati: meccanismo UPDATE/INSERT con cache di 30 minuti, che elimina l'INSERT sistematico a ogni visualizzazione
- Fuso orario dinamico: utilizzo della configurazione Dolibarr invece di un fuso Europe/Paris codificato direttamente
Miglioramenti
- Codici meteo completi: aggiunta dei codici WMO 71-99, 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 della v24
FAQ
Il meteo non viene visualizzato
Verificare che la scheda del terzo, contatto o membro contenga un codice postale e una città. La geocodifica richiede almeno una città.
La scheda Meteo non appare in una scheda
Aprire la scheda Parametri del modulo e verificare che l'oggetto interessato sia selezionato in Oggetti sui quali visualizzare il meteo. Per i membri, verificare inoltre che il modulo nativo Membri sia attivato: senza di esso, la scelta non viene nemmeno proposta.
Ho aggiornato il modulo ma la scheda membro restituisce un errore SQL
La colonna fk_member non è ancora stata creata. Disattivare e riattivare UltimateMeteo una volta: Dolibarr eseguirà nuovamente gli script SQL del modulo e aggiungerà la colonna. L'operazione non è distruttiva.
La mappa visualizza "Access blocked" o "403r"
Questo problema è stato corretto nella versione 24.0.0. OpenStreetMap ha rafforzato la propria politica relativa al Referer all'inizio del 2026. L'aggiornamento include:
- L'aggiunta di
referrerPolicy: "strict-origin-when-cross-origin"nella configurazione Leaflet - L'attribuzione obbligatoria
© OpenStreetMap contributors - Il fissaggio di Leaflet a una versione stabile, 1.9.4
Se l'errore è ancora presente, verificare di utilizzare effettivamente la versione 24.0.0 del modulo.
I dati meteo vengono aggiornati automaticamente?
I dati vengono recuperati a ogni apertura della scheda Meteo. Una cache evita chiamate API ripetitive: se l'ultimo rilevamento è più recente della durata della cache configurata, 30 minuti per impostazione predefinita, viene semplicemente aggiornato nel database invece di creare un nuovo record. Questa durata può essere modificata nella scheda Parametri del modulo.
Come visualizzare le temperature in Fahrenheit?
Nella scheda Parametri del modulo, scegliere Fahrenheit (°F) come unità di temperatura. L'unità viene trasmessa direttamente all'API Open-Meteo: la conversione viene quindi effettuata all'origine e l'unità scelta viene visualizzata accanto a ogni valore.
La soglia di allerta vento viene convertita automaticamente?
No. La soglia è espressa nell'unità di vento selezionata. Se si passa da km/h a mph, ricordarsi di adeguare di conseguenza il valore della soglia.
Il modulo funziona offline?
No. Il modulo richiede un accesso a Internet per interrogare le API Open-Meteo e Nominatim.
È tuttavia possibile restare su una rete interna indicando, nella scheda Parametri, gli URL di istanze Nominatim e Open-Meteo auto-ospitate e disattivando la mappa per evitare il caricamento di Leaflet da una CDN esterna.
Quali lingue sono supportate?
Il modulo è disponibile in: Francese, Inglese, Tedesco, Spagnolo, Italiano.
Come accedere alla guida online?
Ogni pagina del modulo dispone di un link di aiuto contestuale, icona ? in alto a destra, che rimanda alla sezione corrispondente di questa pagina wiki.
Vedi anche
- Atoo-Net — Editore del modulo
- Documentazione API Open-Meteo
- Politica di utilizzo delle tile OpenStreetMap
- Documentazione Leaflet