jsWeather bietet eine Lösung, allgemein verfügbare Wetterdaten aufzubereiten und benutzerfreundlich anzuzeigen. Dafür wird die einfach und sicher zu nutzende Wetter Anwendungsschnittstelle (API) von "OpenWeatherMap" verwendet.
OpenWeatherMap ist ein kommerzieller Onlinedienst, der eine Schnittstelle für den Abruf von Wetterdaten, Wettervorhersagen sowie historische Wetterdaten für die Entwickler von Webanwendungen und mobilen Geräten bereitstellt. Ein Teil der verfügbaren Daten kann nach Anmeldung kostenlos abgerufen werden.
Mit der Nutzung von OpenWeatherMap konnten drei Programmentwicklungen verwirklicht werden:
- jsWeather php-Klasse für die vereinfachte Nutzung von der OpenWeatherMap API
- jsWeather - ein Module für Joomla Version 4 und Version 5
jsWeather ist ein einfaches und vielseitiges Joomla-Modul, das Wetterinformationen für jeden Ort anzeigt, einschließlich von Informationen wie, Luftfeuchtigkeit, Luftdruck, Wind, Sicht. Es wurde von jschmidt-systemberatung unter Verwendung der letzten aktuellen Version von openWeatherMap als Wetterdatenquelle entwickelt.
Hauptmerkmale von jsWeather sind u.A.:
- Eine einfach zu nutzende und dynamische Anzeige von Wetterdaten
- wahlweise Anzeige vom aktuellen Wetter, einer 5 Tage Wettervorhersage oder einer kombinierten Anzeige von aktuellem Wetter und Wettervorhersage.
- In den jeweiligen Tagesdetails wird ein Temperaturdiagramm mit Tooltips bereitgestellt.
- unterstützt fünf verschieden Layouts für Anzeige vom aktuellen Wetter oder Wettervorhersagen.
- auf einer Seite können unterschiedliche Layouts gleichzeitig für verschiedene Module verwendet werden.
- Nutzt Wetterdaten, die über einen Standortnamen, geographische Koordinaten oder die Geolokation von Besuchern geliefert werden.
- bietet eine interaktive Lösung mit der Joomla Systemerweiterung jphpx
- für bessere Performance und System Nutzung können Wetterdaten zwischengespeichert (cached) werden. Seit der Version 1.4 wird die Joomla Datenbank als Cache Backend genutzt.
- Unterstützung von Sprachen
- Neu: alle englischen Texte von openweathermap werden in die jeweils unterstützte Sprache übersetzt. Dafür kann entweder die Google Single Client Translation API oder die Google Cloud Translation API eingesetzt werden.
- Unterstützung English
- Unterstützung Deutsch
- New: Unterstützung Spanisch
- Neu: Unterstützung Französisch
- Neu: Unterstützung Niederländisch
- OpenWeatherMap API Unterstützung
- aktuelles Wetter
- 5 Tage/3 Stunden Voraussage
- Neu: One Call API 3.0. Liefert u. A. detailierte Wetterinformationen und zeigt Wetterwarnungen an.
1. Installation
Sie können das jsWeather Module über die Methode "Aus Webkatalog installieren" auf Ihre Joomla-Site installieren oder laden Sie die jsWeather Module Installationsdatei von meiner Website herunter und installieren sie das Module via Admin Backend.Wetter in Hamburg -
6°C |
8:24 | 16:00 |
Luftfeuchte: | 93% |
Wind: | 24,1 km/h NO |
Luftdruck: | 1.023 hPa |
Sicht: | 8.000 m |
|
4°C
|
||
|
5°C
|
||
|
4°C
|
||
|
6°C
|
||
|
6°C
|
||
Temperatur Profil
|
|
- das Joomla "loadmodule" Inhalts-Plugin
- die Verwendung der Ajax Schnittstelle meines System-Plugin jphpx
- jsWeather Application mit der jphpx-Komponente einsetzen
Jooomla Plugin "loadmodule"
Das Joomla Core Inhalts-Plugin "loadmodule" ermöglicht das Einbetten von Joomla Modulen in Joomla Artikel.Seit Joomla-Version 3.9.0 gibt es neben den Plugin Alternativen "{loadposition xx}" und "{loadmodule yyy}" die Variante "{loadmoduleid z}, die ebenfalls vom Plugin umgesetzt wird.
In diesem Fall sucht das Plugin nach dem Modul, dessen id der Zahl z entspricht. Man kann zum Beispiel das Modul mit der "id 200" in den Beitrag einfügen, indem man in den Artikel-Text den Plugin-Tag "{loadmoduleid 200}" einsetzt.
Einsatz und Verwendung
Für den Einsatz des jsWeather Modules sind dafür folgende Schritte durchzuführen:- Erstellen eines jsWeather Moduls via Admin Backend.
Hinweis: Sie müssen dem Module keine Position zuweisen. - Notieren (merken) der ID des Modules
- Erstellen/editieren eines Joomla Artikels
- Einfügen des Plugin tags "{loadmoduleid x}" ("x" = Module-ID) in den Joomla Artikel
jphpx Ajax interface
Wenn die Erweiterung "jphpx" installert ist, kann man als Alternative eine interaktive Lösung von jsWeather implementieren. Damit hat man Möglichkeit über die Eingabe eines beliebigen Wetterstandorts die jeweiligen Wetterinformationen anzufordern. Die Lösung sehen Sie hier:
Installation der jphpx Ajax Schnitstelle
Notwendige Voraussetzung sind die Installationen von "jphpx" und dem jsWeather Module. Mit der Version 1.2. von jsWeather werden auch alle erfordelichen Komponenten für eine Implementierung bereitgestellt:
- html-Code und Scripts für die Benutzerschnittstelle
- Scripts zum Einbinden und Rendern der Module in den Joomla Artikel
Lösung konfigurieren
Folgende Schritte sind für eine erfolgreiche Implemierung notwendig:
-
jsWeather Module erstellen
Erstellen ein jsweather Module. Hinweis: Sie müssen dem Modulen keine Position zuweisen. Notieren (merken Sie sich) den Titel des Modules (der Titel sollten keine Leer- oder Sonderzeichen enthalten) -
jphpx Code entry einrichten
Über den Menupunkt "Komponenten" im Administrator Backend selektiert man die Option "jphpx Anwendung" bzw. "jphpx Code Entry". Damit wird die Komponente aufgerufen und man kann nun mit dem Button "Neu" eine neue jphpx Anwendung definieren. Definieren Sie die Code Quelle mit dem Wertmodules/mod_js_weather/jphpx/load_jsweather.php
. Nach dem Speichern notieren (merken Sie sich) die "id" des neuen jphpx Code Entry. -
Laufzeit Parameter anpassen
Mit den Laufzeit Parametern wird der html-Code und Scripts für die Benutzerschnittstelle angespasst. Editieren Sie dafür die Datei: jphpx_loadmodule.ini../modules/mod_js_weather/jphpx
. Verwenden Sie dazu z.B. die Editier-Funktion vom FTP-Client "Fillezilla" oder ein ähnliches Tool. Die Bedeutung der Parameter ist in der Datei aufgeführt. Folgende Einstellungen müssen angepasst werden:- "id" - jphpx Code Entry
- "module" - Titel des Modules"
-
jphpx Plugin Tag einbinden
Als letztes tragen Sie disen jphpx plugin tag"{jphpx [modules/mod_js_weather/jphpx/jphpx_loadmodule.php]}
"
an die Stelle Ihres Joomla Artikels ein, wo die jsWeather Module eingebettet werden sollen.
jsWeather Application mit der jphpx-Komponente erstellen und einsetzen
Wenn die Erweiterung "jphpx" installert ist, kann man als weitere Alternative jsWeather als eigenständige Application mit der Systemerweiterung jphpx einzusetzen. otwendige Voraussetzung sind die Installationen von "jphpx" und dem jsWeather Module. Mit der Version 1.4. von jsWeather werden auch alle erforderlichen Komponenten für eine Implementierung bereitgestellt:
Lösung konfigurieren
Folgende Schritte sind für eine erfolgreiche Implemierung notwendig:
-
jsWeather Module erstellen
Erstellen ein jsweather Module. Hinweis: Sie müssen dem Modulen keine Position zuweisen. Notieren (merken Sie sich) den Titel des Modules (der Titel sollten keine Leer- oder Sonderzeichen enthalten) -
jphpx Code Entrys einrichten
Über den Menupunkt "Komponenten" im Administrator Backend selektiert man die Option "jphpx Anwendung" bzw. "jphpx Code Entry". Damit wird die Komponente aufgerufen und man kann nun mit dem Button "Neu" neue jphpx Anwendungen definieren. Definieren Sie die folgende Code Quellen:- die jsweather App mit dem Wert
modules/mod_js_weather/jphpx/jphpx_jsweather_app.php
- das Module zum Rendern des jsWeather Modules .
modules/mod_js_weather/jphpx/load_jsweather.php
Nach dem Speichern notieren (merken Sie sich) die "id" des jphpx Code Entry des Modules zum Rendern des jsWeather Modules. - die jsweather App mit dem Wert
-
Laufzeit Parameter anpassen
Mit den Laufzeit Parametern wird der html-Code und Scripts für die Benutzerschnittstelle angespasst. Editieren Sie dafür die Datei: jphpx_jsweather_app_ini../modules/mod_js_weather/jphpx
. Verwenden Sie dazu z.B. die Editier-Funktion vom FTP-Client "Fillezilla" oder ein ähnliches Tool. Die Bedeutung der Parameter ist in der Datei aufgeführt. Folgende Einstellungen müssen angepasst werden:- "id" - jphpx Code Entry des Modules zum Rendern des jsWeather Modules .
- "module" - Titel des Modules"
Die in file "jphph_jsweather_app.ini" enthaltenen Text Einträge können bei Bedarf geändert bzw. angepasst werden.
Seit der Version 1.4.7 unterstützt jsWeather die Option share buttons für die js weather app anzuzeigen. Implementiert wird die Lösung von AddToAny. Dafür wird die Beispiel Konfigurations File"jphpx_jsweather_app_sample.ini"
mitgeliefert. Folgende Einstellungen können in die aktuellejphpx_jsweather_app_ini"
übernommen werden und ermöglichen die Nutzung von Share Buttons:share_button
mit dem Wert "1" wird die Nutzung eingeschaltetaddtoany
Enthält die Definitionen für "addtoany" Share Buttonscontact_url
enthält die URL eines Joomla Kontakts
Hinweis Bei einer Erstinstallation von jsWeather sind die Einträge schon vorhanden und müssen nur noch angepasst werden..- Menueintrag erstellen
Hier der Link zum Menu-Eintrag: Wetter anzeigen
Für den Einsatz des Moduls müssen Sie sich den kostenlosen API key von OpenWeatherMap" besorgen. Rufen Sie dann im Joomla admin Backend via "system->site Module" das Einrichtungs-Menu für Module auf. Klicken Sie im Menu den "Neu -Button" und selektieren Sie dann das Module "jsWeather".
Damit öffnet sích das HTML-Formular zum Konfigurieren des Moduls. Nutzen sie bitte in dem Formular die notwendigen Informationen für die Konfiguration mit der Option "Inline Hilfe umschalten". Damit werden Hilfetexte zu den jeweilige Moduleeinstellungen eingeblendet. Desweiteren beachten sie die anderen notwendigen Joomla Einstellungen (z. B. "Position", "Status", Menuzuweisung, etc.)
Module Typen
Wetter Anwendungen zeigen in der Regel nicht nur das aktuelle Wetter an, sondern zeigt auch meistens eine mehrtägige Wettervorhersage. Diese Möglichkeit bietet auch jsWeather mit seinen drei verschiedenen Moduletypen:
- aktuelles Wetter
Die aktuellen Wetterdaten einer Lokation werden von openweathermap angefordert und für die Anzeige aufbereitet. - Wettervorhersage
Die Wetterdaten für eine füntägige Wettervorhersage einer Lokation werden von openweathermap angefordert und für die Anzeige aufbereitet. - aktuell/Vorhersage
Die aktuellen Wetterdaten einer Lokation und die Wetterdaten für eine füntägige Wettervorhersage einer Lokation werden von openweathermap angefordert und für die Anzeige aufbereitet.
Layout Optionen (Templates)
Module Templates werden in Joomla zur Darstellung der aufbereiteten Daten von Modulen eingesetzt. Für die verschiedenen Moduletypen von jsWeather sind wegen der unterschiedlichen Datenaufbereitung auch verschieden Templates (Layouts) notwendig.
- Für den Moduletype aktuelles Wetter werden folgende Layouts eingesetzt:
- default zeigt eine vertikale Ausrichtung des Modules an
- horizontal zeigt eine horizontale Ausrichtung des Modules an
- Für den Moduletype Wettervorhersage werden die Layouts verwendet:
- Für den Moduletype aktuell/Vohersage wird das folgende Layouts verwendet:
- combined Hier wird für die aktuellen Wetterdaten und für die Wettervorhersage ein kombiniertes Layout it einer horizontal angeordneten Vorhersage verwendet
- combined2 Hier wird für die aktuellen Wetterdaten und für die Wettervorhersage ein kombiniertes Layout mit einer vertikal angeordneten Vorhersage verwendet
Stylesheets (Cascading Style sheets - CSS)
CSS wurde entworfen, um Darstellungsvorgaben weitgehend von den Inhalten zu trennen. Wenn diese Trennung konsequent vollzogen wird, werden nur noch die inhaltliche Gliederung eines Dokumentes und die Bedeutung seiner Teile in HTML oder XML beschrieben, während mit CSS gesondert davon, vorzugsweise in separaten CSS-Dateien, die Darstellung der Inhalte festgelegt wird (z. B. Layout, Farben und Typografie).
Das jsWeather module bietet zwei Möglichkeiten der Verwendung von CSS:
- fünf vom Modul unterstützte Formatierungen
- die Möglichkeit eine eigene Formatierung (ein eigenes CSS) einzusetzen.
- jsweather stellt hier das CSS-file "jsweather_custom.css" als Prototyp zur Verfügung. Es hilft bei der Entwicklung einer eigenen Option zur Formatierung, kann aber auch schon sofort eingesetzt werden.
Hinweis: Die File muss im Verzeichnis"../media/mod_js_weather/css"
gespeichert werden.
- jsweather stellt hier das CSS-file "jsweather_custom.css" als Prototyp zur Verfügung. Es hilft bei der Entwicklung einer eigenen Option zur Formatierung, kann aber auch schon sofort eingesetzt werden.
Hinweise
Wenn Sie nicht die Version 1.4.5 installiert haben, kann die Deinstallation von jsWeather zu einem Problem führen. Updaten sie in dem Fall zunächst auf die Version 1.4.5 (oder hoher) und danach sollte die Deinstallation erfolgreich sein.
Beim Einsatz von Geolocation Servern wird versucht, über die Internet Adresse des Website Besuchers die geografischen Koordinaten zu liefern. Diese Ortszuordnung kann aber nur so genau sein, wie sie in den jeweiligen Daten vorliegen, die von den Internet Providern zur Verfügung gestellt wurden. Man kann davon ausgehen, dass IP-basierte Geolokalisierungsdienste eine Genauigkeit von 55 bis 80 Prozent für die Region oder den Staat eines Benutzers bieten.
Wetterdaten sind niemals "punktgenau" sie beziehen sich immer auf eine mehr oder weniger große Region. Deshalb kann es durchaus sein, dass z. B. Regen angezeigt wird, obwohl am gewählten Ort kein Regen in Sicht ist.
Falls bei einer gültigen Eingabe eines Standort ein Fehler "400" auftritt, sollte man den Ortsnamen in Kleinbuchstaben eingeben und dann die Anforderung wiederholen. Sollte dies auch zu dem gleichen Fehler führen, geben Sie die die geografischen Koordinaten des Standorts ein.
Download jsWeather
jsWeather ist freie Software (wie Joomla!) - jedoch müssen Sie die GPL-Linzenzbestimmungen für seinen Einsatz beachten. Mehr über GPL und freie Software kann man bei GNU Org finden.
Zum Download von jsWeather klicken Sie das "download" Bild:
jsWeather Module Version 2.0 für Joomla!
Noch Fragen? Besuchen Sie das Support Forum oder senden Sie eine Email an den Entwickler, unseren Webmaster.