Module UltimateMeteo FR
Module UltimateMeteo
Présentation
Le module UltimateMeteo est une extension pour Dolibarr ERP/CRM éditée par Atoo-Net.
Il affiche la météo en temps réel directement dans les fiches de vos tiers, fournisseurs et contacts, en se basant sur l'adresse enregistrée dans Dolibarr. Il utilise des APIs gratuites et ne nécessite aucune clé API.
| Propriété | Valeur |
|---|---|
| Auteur | Philippe Grand — Atoo-Net |
| Version | 24.0.0 |
| Licence | GNU GPL v3+ |
| Dolibarr minimum | v24.0 |
| PHP minimum | v8.0 |
Pourquoi utiliser UltimateMeteo ?
Les conditions météorologiques ont un impact direct sur de nombreuses activités professionnelles. UltimateMeteo intègre les informations météo là où vous en avez besoin — directement dans vos fiches Dolibarr — pour prendre de meilleures décisions sans changer d'outil.
Cas d'utilisation
BTP & Métiers du bâtiment
Avant de planifier une intervention extérieure (toiture, peinture, fondations), consultez les prévisions météo à l'adresse de votre client directement depuis sa fiche. Évitez d'envoyer une équipe sur un chantier sous la pluie ou le gel.
Agriculture & Espaces verts
Lors de la planification de traitements, de semis ou de tonte, vérifiez les conditions météo chez votre client. Un simple coup d'œil sur l'onglet Météo vous indique si la semaine est favorable — sans quitter Dolibarr.
Transport & Logistique
Lors de la préparation d'une livraison ou d'un enlèvement, vérifiez la vitesse du vent et les conditions météo à destination. Cela permet d'anticiper les retards, d'adapter les itinéraires ou de prévenir le client à l'avance.
Événementiel & Services extérieurs
Pour les traiteurs, organisateurs d'événements ou sociétés de location, connaître les prévisions à l'adresse du lieu permet de confirmer ou d'ajuster la logistique sur site (chapiteaux, chauffage, équipement du personnel).
Forces de vente terrain
Les commerciaux en déplacement peuvent consulter la météo à chaque étape avant de partir. Combiné à la gestion de l'agenda dans Dolibarr, cela offre une planification intégrant les aléas climatiques.
Service client & SAV
Lorsqu'un client signale un problème (infiltration d'eau, panne d'équipement, coupure de courant), visualiser instantanément la météo récente à son adresse aide à qualifier l'incident et à prioriser l'intervention.
Installation
- Télécharger le module depuis DoliStore
- Décompresser et placer le dossier
ultimatemeteo/danshtdocs/custom/ - Aller dans Accueil → Configuration → Modules/Applications
- Localiser UltimateMeteo dans la section AtooNet
- Activer le module en cliquant sur le bouton de la colonne Activé
Configuration
Configuration des droits
Après activation, configurer les droits d'accès par groupe d'utilisateurs dans Accueil → Configuration → Utilisateurs & Groupes → Groupes :
| Permission | Description |
|---|---|
Lire les données météo |
Permet de voir les onglets météo sur les fiches |
Créer / Modifier |
Permet de déclencher une actualisation des données |
Supprimer |
Permet de supprimer des enregistrements météo |
Cache des données
Depuis la version 24.0.0, le module utilise un cache intelligent :
- Les données météo sont stockées en base de données dans la table
llx_ultimatemeteo_currentweather - Si un enregistrement existe pour un tiers depuis moins de 30 minutes, les données sont mises à jour (UPDATE) au lieu de créer un nouvel enregistrement
- Si aucun enregistrement récent n'existe, un nouveau est créé
- Ce mécanisme évite l'accumulation excessive de lignes en base de données
Fuseau horaire
Le module détecte automatiquement le fuseau horaire configuré dans Dolibarr (constante MAIN_TIMEZONE). Si cette constante n'est pas définie, le fuseau horaire par défaut du serveur PHP est utilisé.
Utilisation
Onglet Meteo
Le module ajoute un onglet Météo sur chaque fiche tiers (clients, prospects, fournisseurs).
En ouvrant cet onglet, Dolibarr :
- Récupère l'adresse (code postal + ville) enregistrée sur la fiche
- Géocode l'adresse via l'API OpenStreetMap Nominatim pour obtenir les coordonnées GPS
- Interroge l'API Open-Meteo pour récupérer la météo actuelle et les prévisions
- Affiche les résultats avec une carte interactive
Les informations affichées sont :
| Champ | Description |
|---|---|
| Température (°C) | Température actuelle en degrés Celsius |
| Vitesse du vent (km/h) | Vitesse du vent en km/h |
| Description météo | Condition météorologique (Ciel clair, Couvert, Pluie, Neige, Orage…) |
| Date | Date et heure de la dernière observation |
Prévisions météo des prochains jours
Sous les données actuelles, un tableau affiche les prévisions sur 5 jours avec pour chaque journée :
- La date
- La température minimale (Min)
- La température maximale (Max)
Carte interactive
Une carte OpenStreetMap interactive (via Leaflet 1.9.4) est affichée en bas de page avec :
- Un marqueur positionné sur la ville du tiers
- Un popup indiquant le nom de la localité
- Zoom +/− disponible
- Attribution OpenStreetMap conforme à la politique d'utilisation des tuiles OSM
Onglet Contact
Le même onglet Météo est disponible sur les fiches contacts/adresses. Il fonctionne de manière identique en utilisant l'adresse du contact.
Conditions météo supportées
Le module utilise les codes WMO standard et les traduit automatiquement dans 5 langues (FR, EN, DE, ES, IT) :
| Code WMO | Description |
|---|---|
| 0 | Ciel dégagé |
| 1 | Principalement dégagé |
| 2 | Partiellement nuageux |
| 3 | Couvert |
| 45 / 48 | Brouillard / Brouillard givrant |
| 51 / 53 / 55 | Bruine légère / modérée / dense |
| 61 / 63 / 65 | Pluie légère / modérée / forte |
| 71 / 73 / 75 | Neige légère / modérée / forte |
| 77 | Grains de neige |
| 80 / 81 / 82 | Averses faibles / modérées / violentes |
| 85 / 86 | Averses de neige faibles / fortes |
| 95 | Orage |
| 96 / 99 | Orage avec grêle légère / forte |
APIs utilisées
Le module repose sur des APIs entièrement gratuites, sans inscription ni clé API requise :
| API | Rôle | URL |
|---|---|---|
| Open-Meteo | Météo actuelle et prévisions | https://api.open-meteo.com |
| OpenStreetMap Nominatim | Géocodage adresse → coordonnées GPS | https://nominatim.openstreetmap.org |
| Leaflet 1.9.4 | Bibliothèque de carte interactive | https://leafletjs.com |
| OpenStreetMap Tiles | Tuiles cartographiques | https://tile.openstreetmap.org |
Nouveautés de la version 24.0.0
Corrections
- Erreur 403r sur les cartes OpenStreetMap : ajout du
referrerPolicyet de l'attribution conformément à la politique de tuiles OSM 2026 - Leaflet épinglé à la version 1.9.4 avec vérification d'intégrité SRI (au lieu d'une URL CDN non versionnée)
- Appels API sécurisés : remplacement de
file_get_contentspar cURL avec User-Agent conforme dans le hook tiers - Cache des données : mécanisme UPDATE/INSERT avec cache de 30 minutes (supprime l'INSERT systématique à chaque affichage)
- Fuseau horaire dynamique : utilisation de la configuration Dolibarr au lieu d'un fuseau Europe/Paris codé en dur
Améliorations
- Codes météo complets : ajout des codes WMO 71-99 (neige, averses, orages, grêle) dans les 5 fichiers de langue
- Internationalisation : les descriptions météo utilisent désormais le système de traduction Dolibarr (
$langs->trans()) - Liens d'aide wiki : ajout de liens contextuels vers la documentation wiki dans toutes les pages du module
- Compatibilité Dolibarr v24 : mise à jour des patterns pour respecter les conventions v24
FAQ
La météo ne s'affiche pas
Vérifier que la fiche tiers ou contact possède bien un code postal et une ville renseignés. Le géocodage nécessite au minimum une ville.
La carte affiche "Access blocked" ou "403r"
Ce problème a été corrigé dans la version 24.0.0. OpenStreetMap a renforcé sa politique de Referer début 2026. La mise à jour inclut :
- L'ajout du
referrerPolicy: "strict-origin-when-cross-origin"dans la configuration Leaflet - L'attribution
© OpenStreetMap contributorsobligatoire - L'épinglage de Leaflet à une version stable (1.9.4)
Si vous voyez encore cette erreur, vérifiez que vous utilisez bien la version 24.0.0 du module.
Les données météo sont-elles mises à jour automatiquement ?
Les données sont récupérées à chaque ouverture de l'onglet Météo. Un cache de 30 minutes évite les appels API répétitifs : si les données ont moins de 30 minutes, elles sont simplement mises à jour en base.
Le module fonctionne-t-il hors ligne ?
Non. Le module nécessite un accès Internet pour interroger les APIs Open-Meteo et Nominatim.
Quelles langues sont supportées ?
Le module est disponible en : Français, Anglais, Allemand, Espagnol, Italien.
Comment accéder à l'aide en ligne ?
Chaque page du module dispose d'un lien d'aide contextuel (icône ? en haut à droite) qui renvoie vers la section correspondante de cette page wiki.
Voir aussi
- Atoo-Net — Éditeur du module
- Documentation API Open-Meteo
- Politique d'utilisation des tuiles OpenStreetMap
- Documentation Leaflet
