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

Autor: Matthias
Verfügbar seit: 0.9.0

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:

../../../../_images/weather.png
<meta>
    <plugins>
        <plugin name="openweathermap" />
    </plugins>
</meta>
...
<openweathermap q="Munich" appid="..." />