Vorsicht
Dies ist die Dokumentation des aktuellen Entwicklungszweigs der CometVisu. Es besteht daher die Möglichkeit, dass einige der hier beschriebenen Features mit dem aktuellsten Release der CometVisu nicht genutzt werden können.
Das OpenweatherMap Plugin
Beschreibung
Das OpenweatherMap Plugin fügt der Visu ein Widget für die Wettervorhersage hinzu.
Einstellungen
Für eine grundsätzliche Erklärung des Aufbaus der Konfiguration und der Definition der im folgenden benutzten Begriffe (Elemente, Attribute) sollte zunächst dieser Abschnitt gelesen werden: Grundsätzliches.
Das Verhalten und Aussehen des OpenweatherMap-Plugins kann durch die Verwendung von Attributen und Elementen beeinflusst werden. Die folgenden Tabellen zeigen die erlaubten Attribute und Elemente. In den Screenshots sieht man, wie beides über den Editor bearbeitet werden kann.
Nur die mit ….. unterstrichenen Attribute/Elemente müssen zwingend angegeben werden, alle anderen sind optional und können daher weg gelassen werden.
Erlaubte Attribute im OpenweatherMap-Element
Element |
Attribut |
|||
|---|---|---|---|---|
Name |
Inhalt |
Beschreibung |
||
openweathermap |
lang |
en, de oder fr |
Sprache / Datum-Formatierung |
|
appid |
Text |
Persönlicher Zugriffsschlüssel von https://openweathermap.org/ |
||
description |
Text |
Beschreibungstext, zeigt den Ortsname an, wenn leer gelassen. „false“ deaktiviert Anzeige |
||
detailItems |
integer |
Anzeige von Details wenn Wert 1 ist (Voreinstellung). 0 deaktiviert Anzeige |
||
forecast24hItems |
integer |
Anzahl der Einträge (0…8) |
||
forecastDailyItems |
integer |
Anzahl der Einträge (0…4) |
||
showSunrise |
true oder false |
Sonnenauf- und untergang anzeigen |
||
owID |
Text |
OpenWeatherMap City ID aus http://bulk.openweathermap.org/sample/city.list.json.gz |
||
q |
Text |
Wenn owID nicht verwendet wird: Ortsname und ISO 3166 Ländercode, durch Komma getrennt |
||
lat |
Text |
Wenn owID oder q nicht verwendet wird: Geographische Breite des Ortes |
||
lon |
Text |
Wenn owID oder q nicht verwendet wird: Geographische Länge des Ortes |
||
refresh |
integer |
Aktualisierungsintervall in Minuten |
||
class |
Text |
Füge dieses Attribut der CSS Klasse hinzu, so dass das Widget durch ein eigenes Stylesheet zusätzlich formatiert werden kann. |
||
Wichtig
Der Wert des Attributs appid muss durch den eigenen Schlüssel ersetzt werden!
Das OpenweatherMap nutzt den Web-Service von https://openweathermap.org/ um die aktuellen Wetterdaten bzw. Vorhersage darstellen zu können. Um auf diese Daten zugreifen zu können benötigt man einen Schlüssel, der dort auf der Homepage kostenlos erzeugt werden kann und im Attribut appid angegeben werden muss.
Erlaubte Kind-Elemente und deren Attribute
Keine.
XML Syntax
Alternativ kann man für das OpenweatherMap Plugin auch von Hand einen Eintrag in der visu_config.xml hinzufügen.
Vorsicht
In der Config selbst dürfen NUR UTF-8 Zeichen verwendet werden. Dazu muss ein auf UTF-8 eingestellter Editor verwendet werden!
Wichtig
Der Wert des Attributs appid muss durch den eigenen Schlüssel ersetzt werden!
Hier der minimale Beispielcode der das OpenweatherMap Plugin aus dem folgenden, Screenshot erzeugt:
<meta>
<plugins>
<plugin name="openweathermap" />
</plugins>
</meta>
...
<openweathermap q="Munich" appid="..." />