Module UltimateMeteo DE

Modul UltimateMeteo

Präsentation

Das Modul UltimateMeteo ist eine Erweiterung für Dolibarr ERP/CRM, herausgegeben von Atoo-Net.

Es zeigt die Wetterdaten in Echtzeit direkt in den Karteikarten Ihrer Dritten, Lieferanten und Kontakte an, basierend auf der in Dolibarr gespeicherten Adresse. Es verwendet kostenlose APIs und benötigt keinen API-Schlüssel.

Eigenschaft	Wert
Autor	Philippe Grand — Atoo-Net
Version	24.0.0
Lizenz	GNU GPL v3+
Dolibarr mindestens	v24.0
PHP mindestens	v8.0

Warum UltimateMeteo verwenden?

Wetterbedingungen haben direkten Einfluss auf zahlreiche berufliche Tätigkeiten. UltimateMeteo integriert Wetterinformationen genau dort, wo Sie sie benötigen — direkt in Ihren Dolibarr-Karteikarten — damit Sie bessere Entscheidungen treffen können, ohne das Werkzeug zu wechseln.

Anwendungsfälle

Bauwesen & Bauhandwerk

Bevor Sie einen Außeneinsatz planen, beispielsweise Dacharbeiten, Malerarbeiten oder Fundamentarbeiten, können Sie die Wettervorhersage an der Adresse Ihres Kunden direkt aus dessen Karteikarte heraus prüfen. So vermeiden Sie, ein Team bei Regen oder Frost auf eine Baustelle zu schicken.

Landwirtschaft & Grünflächenpflege

Bei der Planung von Behandlungen, Aussaaten oder Mäharbeiten können Sie die Wetterbedingungen beim Kunden prüfen. Ein kurzer Blick auf die Registerkarte Wetter zeigt Ihnen, ob die Woche günstig ist — ohne Dolibarr zu verlassen.

Transport & Logistik

Bei der Vorbereitung einer Lieferung oder Abholung können Sie die Windgeschwindigkeit und die Wetterbedingungen am Zielort prüfen. Dadurch lassen sich Verzögerungen vorhersehen, Routen anpassen oder Kunden frühzeitig informieren.

Veranstaltungen & Außendienstleistungen

Für Caterer, Veranstaltungsorganisatoren oder Vermietungsunternehmen ermöglicht die Kenntnis der Wettervorhersage am Veranstaltungsort eine bessere Bestätigung oder Anpassung der Logistik vor Ort, zum Beispiel Zelte, Heizung oder Ausrüstung des Personals.

Außendienst-Vertrieb

Vertriebsmitarbeiter im Außendienst können vor jeder Etappe die Wetterlage prüfen. In Kombination mit der Kalenderverwaltung in Dolibarr ermöglicht dies eine Planung, die wetterbedingte Risiken berücksichtigt.

Kundendienst & After-Sales-Service

Wenn ein Kunde ein Problem meldet, beispielsweise Wassereintritt, Geräteausfall oder Stromausfall, hilft die sofortige Anzeige der aktuellen Wetterlage an seiner Adresse dabei, den Vorfall besser einzuordnen und den Einsatz zu priorisieren.

Installation

Das Modul von DoliStore herunterladen
Das Archiv entpacken und den Ordner ultimatemeteo/ in htdocs/custom/ ablegen
Zu Startseite → Einstellungen → Module/Anwendungen gehen
UltimateMeteo im Abschnitt AtooNet suchen
Das Modul aktivieren, indem Sie auf die Schaltfläche in der Spalte Aktiviert klicken

Aktivierung des Moduls UltimateMeteo im Abschnitt AtooNet

Konfiguration

Konfiguration der Berechtigungen

Nach der Aktivierung konfigurieren Sie die Zugriffsrechte nach Benutzergruppe unter Startseite → Einstellungen → Benutzer & Gruppen → Gruppen:

Berechtigung	Beschreibung
`Wetterdaten lesen`	Erlaubt die Anzeige der Wetter-Registerkarten in den Karteikarten
`Erstellen / Ändern`	Erlaubt das Auslösen einer Aktualisierung der Daten
`Löschen`	Erlaubt das Löschen von Wetterdatensätzen

Datencache

Seit Version 24.0.0 verwendet das Modul einen intelligenten Cache:

Die Wetterdaten werden in der Datenbank in der Tabelle llx_ultimatemeteo_currentweather gespeichert
Wenn für einen Dritten ein Datensatz existiert, der weniger als 30 Minuten alt ist, werden die Daten aktualisiert (UPDATE), anstatt einen neuen Datensatz zu erstellen
Wenn kein aktueller Datensatz vorhanden ist, wird ein neuer Datensatz erstellt
Dieser Mechanismus verhindert eine übermäßige Ansammlung von Zeilen in der Datenbank

Zeitzone

Das Modul erkennt automatisch die in Dolibarr konfigurierte Zeitzone über die Konstante MAIN_TIMEZONE. Wenn diese Konstante nicht definiert ist, wird die Standardzeitzone des PHP-Servers verwendet.

Verwendung

Registerkarte Wetter

Das Modul fügt jeder Karteikarte eines Dritten — Kunden, Interessenten und Lieferanten — eine Registerkarte Wetter hinzu.

Beim Öffnen dieser Registerkarte führt Dolibarr folgende Schritte aus:

Es ruft die in der Karteikarte gespeicherte Adresse ab, also Postleitzahl und Stadt
Es geokodiert die Adresse über die API OpenStreetMap Nominatim, um die GPS-Koordinaten zu erhalten
Es fragt die API Open-Meteo ab, um das aktuelle Wetter und die Vorhersagen abzurufen
Es zeigt die Ergebnisse mit einer interaktiven Karte an

Registerkarte Wetter in einer Dritten-Karteikarte — aktuelles Wetter, Vorhersagen und Karte

Die angezeigten Informationen sind:

Feld	Beschreibung
Temperatur (°C)	Aktuelle Temperatur in Grad Celsius
Windgeschwindigkeit (km/h)	Windgeschwindigkeit in km/h
Wetterbeschreibung	Wetterbedingung: Klarer Himmel, Bedeckt, Regen, Schnee, Gewitter …
Datum	Datum und Uhrzeit der letzten Beobachtung

Wettervorhersage für die kommenden Tage

Unterhalb der aktuellen Daten zeigt eine Tabelle die Vorhersage für 5 Tage an, jeweils mit:

Dem Datum
Der Mindesttemperatur (Min)
Der Höchsttemperatur (Max)

Interaktive Karte

Eine interaktive OpenStreetMap-Karte über Leaflet 1.9.4 wird am unteren Seitenbereich angezeigt mit:

Einem Marker, der auf der Stadt des Dritten positioniert ist
Einem Popup mit dem Namen des Ortes
Verfügbarem Zoom +/−
OpenStreetMap-Zuordnung gemäß der Nutzungsrichtlinie für OSM-Kacheln

Registerkarte Kontakt

Dieselbe Registerkarte Wetter ist auch in Kontakt-/Adresskarteikarten verfügbar. Sie funktioniert identisch und verwendet die Adresse des Kontakts.

Registerkarte Wetter in einer Kontakt-Karteikarte

Unterstützte Wetterbedingungen

Das Modul verwendet die standardisierten WMO-Codes und übersetzt sie automatisch in 5 Sprachen: FR, EN, DE, ES, IT.

WMO-Code	Beschreibung
0	Klarer Himmel
1	Überwiegend klar
2	Teilweise bewölkt
3	Bedeckt
45 / 48	Nebel / gefrierender Nebel
51 / 53 / 55	Leichter / mäßiger / dichter Nieselregen
61 / 63 / 65	Leichter / mäßiger / starker Regen
71 / 73 / 75	Leichter / mäßiger / starker Schneefall
77	Schneekörner
80 / 81 / 82	Leichte / mäßige / heftige Regenschauer
85 / 86	Leichte / starke Schneeschauer
95	Gewitter
96 / 99	Gewitter mit leichtem / starkem Hagel

Verwendete APIs

Das Modul basiert auf vollständig kostenlosen APIs, ohne Registrierung und ohne erforderlichen API-Schlüssel:

API	Rolle	URL
Open-Meteo	Aktuelles Wetter und Vorhersagen	https://api.open-meteo.com
OpenStreetMap Nominatim	Geokodierung Adresse → GPS-Koordinaten	https://nominatim.openstreetmap.org
Leaflet 1.9.4	Bibliothek für interaktive Karten	https://leafletjs.com
OpenStreetMap Tiles	Kartenkacheln	https://tile.openstreetmap.org

Neuheiten der Version 24.0.0

Korrekturen

Fehler 403r bei OpenStreetMap-Karten: Hinzufügen von referrerPolicy und der Zuordnung gemäß der OSM-Kachelrichtlinie 2026
Leaflet fest auf Version 1.9.4 gesetzt mit SRI-Integritätsprüfung, anstelle einer nicht versionierten CDN-URL
Gesicherte API-Aufrufe: Ersetzung von file_get_contents durch cURL mit konformem User-Agent im Hook der Dritten
Datencache: UPDATE/INSERT-Mechanismus mit 30-Minuten-Cache, wodurch systematische INSERTs bei jeder Anzeige entfernt werden
Dynamische Zeitzone: Verwendung der Dolibarr-Konfiguration anstelle einer fest codierten Zeitzone Europe/Paris

Verbesserungen

Vollständige Wettercodes: Hinzufügen der WMO-Codes 71–99, also Schnee, Schauer, Gewitter und Hagel, in den 5 Sprachdateien
Internationalisierung: Wetterbeschreibungen verwenden jetzt das Dolibarr-Übersetzungssystem $langs->trans()
Wiki-Hilfelinks: Hinzufügen kontextbezogener Links zur Wiki-Dokumentation auf allen Seiten des Moduls
Kompatibilität mit Dolibarr v24: Aktualisierung der Patterns gemäß den Konventionen von v24

FAQ

Das Wetter wird nicht angezeigt

Prüfen Sie, ob in der Karteikarte des Dritten oder Kontakts sowohl eine Postleitzahl als auch eine Stadt eingetragen sind. Für die Geokodierung ist mindestens eine Stadt erforderlich.

Die Karte zeigt "Access blocked" oder "403r" an

Dieses Problem wurde in Version 24.0.0 behoben. OpenStreetMap hat Anfang 2026 seine Referer-Richtlinie verschärft. Das Update enthält:

Das Hinzufügen von referrerPolicy: "strict-origin-when-cross-origin" in der Leaflet-Konfiguration
Das Festlegen von Leaflet auf eine stabile Version, 1.9.4

Wenn dieser Fehler weiterhin angezeigt wird, prüfen Sie, ob Sie wirklich Version 24.0.0 des Moduls verwenden.

Werden die Wetterdaten automatisch aktualisiert?

Die Daten werden bei jedem Öffnen der Registerkarte Wetter abgerufen. Ein Cache von 30 Minuten verhindert wiederholte API-Aufrufe: Wenn die Daten weniger als 30 Minuten alt sind, werden sie einfach in der Datenbank aktualisiert.

Funktioniert das Modul offline?

Nein. Das Modul benötigt Internetzugang, um die APIs Open-Meteo und Nominatim abzufragen.

Welche Sprachen werden unterstützt?

Das Modul ist verfügbar auf: Französisch, Englisch, Deutsch, Spanisch, Italienisch.

Wie greife ich auf die Online-Hilfe zu?

Jede Seite des Moduls verfügt über einen kontextbezogenen Hilfelink über das Symbol ? oben rechts, der auf den entsprechenden Abschnitt dieser Wiki-Seite verweist.

Siehe auch

Andere Sprachen