Dokumentation

Für Wetterwarner 3.x · benötigt WordPress 6.3 und PHP 7.4 · Live-Demo

Inhalt

1. Installation
2. Warnregion finden
3. Block
4. Shortcode & Generator
5. Klassisches Widget
6. Anzeige der Warnungen
7. Warnkarte
8. Einstellungen
9. Aktualisierung & Datenquelle
10. Update von 2.x
11. Für Entwickler
12. Fehlersuche & API-Status
13. Hinweise & Lizenzen

Installation

1. Im WordPress-Backend Plugins › Installieren öffnen und nach „Wetterwarner“ suchen – oder die ZIP-Datei von WordPress.org herunterladen und nach /wp-content/plugins/ hochladen.
2. Das Plugin aktivieren.
3. Den Block „Wetterwarner“ auf einer Seite oder in einem Widget-Bereich einfügen und eine Warnregion wählen.

Voraussetzungen: WordPress ab 6.3, PHP ab 7.4, ein funktionierender WP-Cron und ein beschreibbares Upload-Verzeichnis (nur für die Warnkarte). Schreibrechte im Plugin-Ordner sind nicht mehr nötig.

Warnregion finden

Wetterwarner kennt alle Warnregionen des Deutschen Wetterdienstes – über 11.000 Einträge. Im Block und im Widget tippst Du einfach den Namen Deines Ortes oder Landkreises in die Regionssuche; die Suche verträgt auch Schreibweisen ohne Umlaute.

Hinter jeder Region steht eine Warncell-ID des DWD (z. B. 103241000 für die Region Hannover). Die ID wird in der Regionssuche angezeigt und für den Shortcode benötigt.

Block

Der Block „Wetterwarner“ (Kategorie Widgets) funktioniert im Block-Editor und in blockbasierten Widget-Bereichen. Der Editor zeigt eine Live-Vorschau mit den aktuellen Warnungen.

In der Seitenleiste stehen die Optionen in drei Gruppen:

Zusätzlich unterstützt der Block die üblichen Gestaltungsoptionen von WordPress: Ausrichtung (weit/volle Breite), Text-, Hintergrund- und Linkfarbe, Abstände sowie Schriftgröße und Zeilenhöhe.

Shortcode

Für Page-Builder, klassische Themes oder Textfelder gibt es den Shortcode [wetterwarner]. Er kennt dieselben Optionen wie der Block:

[wetterwarner region="103241000" max="5" map="60" map_region="nib"]

Nicht angegebene Attribute verwenden die Standardwerte aus der Block-Tabelle.

Shortcode-Generator

Such Deine Warnregion und stell die Optionen zusammen – der Shortcode enthält nur Werte, die vom Standard abweichen.

[wetterwarner region="103241000"]

Die Regionssuche fragt die Wetterwarner-API ab; übertragen wird nur der Suchbegriff.

Klassisches Widget

Für Themes ohne Block-Widgets steht unter Design › Widgets weiterhin das Widget „Wetterwarner“ zur Verfügung – mit Regionssuche und denselben Optionen wie der Block. Widgets aus Version 2.x werden beim Update automatisch übernommen (siehe Update von 2.x).

Anzeige der Warnungen

Jede Warnung zeigt Ereignis, Warnstufe, Gültigkeitszeitraum und – aufklappbar – Beschreibung und Handlungsempfehlungen des DWD. Vorabinformationen werden gesondert gekennzeichnet. Unter der Liste steht die Quellenangabe „Deutscher Wetterdienst“; sie ist durch die Lizenz der Daten vorgeschrieben und lässt sich nicht abschalten.

Die Ausgabe ist barrierearm aufgebaut: echte Überschriften, native Aufklapp-Elemente und Screenreader-Texte für die Warnstufe. Im Frontend werden weder jQuery noch Icon-Fonts geladen.

Warnkarte

Optional zeigt Wetterwarner die aktuelle Gemeinde-Warnkarte des DWD unter den Warnungen an. Die Breite legst Du in Prozent fest.

Die Karte wird im Hintergrund geladen und im Upload-Verzeichnis Deiner WordPress-Installation gespeichert. Besucher laden sie also von Deinem eigenen Server – nicht vom DWD. Die Karte wird inhaltlich nicht verändert.

Einstellungen

Unter Einstellungen › Wetterwarner findest Du:

• Farben: Hintergrundfarbe je Warnstufe (mit Transparenz). Sie gelten für alle Blöcke, Shortcodes und Widgets, bei denen „Nach Warnstufe einfärben“ aktiv ist.
• Datenstatus: Wann die Warnungen zuletzt erfolgreich von der Wetterwarner-API geladen wurden, welche Regionen genutzt werden und eventuelle Fehlermeldungen.
• Cache leeren: Verwirft die zwischengespeicherten Warnungen und Karten und lädt sie neu.
• Shortcode-Übersicht: Alle Attribute auf einen Blick.
• Nutzungsdaten: Freiwillige Zustimmung „Entwicklung unterstützen“, jederzeit widerrufbar (siehe unten).

Außerdem meldet Wetterwarner seinen Zustand unter Werkzeuge › Website-Zustand: ob aktuelle Warnungen ankommen, ob die Wetterwarner-API erreichbar ist und ob Karten gespeichert werden können. Im Reiter „Bericht“ stehen Version, nächste Hintergrundaktualisierung, genutzte Regionen und Farben.

Entwicklung unterstützen (Nutzungsdaten)

Nach der Installation fragt ein Hinweis im Backend, ob Du die Entwicklung mit technischen Daten unterstützen möchtest. Nur mit Deiner Zustimmung werden beim regulären Abruf zusätzlich die Adresse Deiner Website sowie die Versionen von Plugin, WordPress und PHP übermittelt – keine Daten Deiner Besucher, keine zusätzlichen Anfragen. Widerrufen kannst Du jederzeit unter Einstellungen › Wetterwarner; der Eintrag wird dann gelöscht. Details stehen in der Datenschutzerklärung.

Aktualisierung & Datenquelle

Wetterwarner lädt Warnungen nie beim Seitenaufruf. Stattdessen holt WP-Cron höchstens alle 5 Minuten die Warnungen aller genutzten Regionen in einer Anfrage; Seitenaufrufe bedienen sich aus dem lokalen Speicher. Das hält die Seite schnell und schont die Server des DWD.

Die Daten kommen von der Wetterwarner-API (api.wetterwarner.de). Sie lädt die amtlichen Warnungen und Warnkarten des Deutschen Wetterdienstes laufend und hält sie zentral vor, damit nicht jede Website die teils mehrere Megabyte großen Rohdaten laden muss. Übertragen werden nur die Warncell-IDs der genutzten Regionen.

Ist die API kurzzeitig nicht erreichbar, zeigt das Plugin weiter die zuletzt geladenen Warnungen an. Den Zustand siehst Du im Datenstatus in den Einstellungen.

Update von 2.x

Version 3.0 ist ein kompletter Neubau: Die Daten kommen nicht mehr aus den RSS-Feeds von wettwarn.de, sondern vom Deutschen Wetterdienst – bereitgestellt über die Wetterwarner-API.

• Bestehende Widgets werden automatisch übernommen. Die alten wettwarn.de Feed-IDs werden dabei der passenden DWD-Warnregion zugeordnet.
• Lässt sich eine Feed-ID nicht zuordnen, erscheint ein Hinweis im Backend mit den betroffenen IDs – wähle die Region im Widget dann neu aus.
• Die Warnkarte liegt jetzt im Upload-Verzeichnis statt im Plugin-Ordner.
• Der Tooltip beim Überfahren wurde durch aufklappbare Details ersetzt.
• Mindestanforderungen sind jetzt WordPress 6.3 und PHP 7.4.

Bitte prüfe nach dem Update kurz Deine Widgets. Die Dokumentation der alten Version findest Du unter Version 2.x (Legacy).

Für Entwickler

// Beispiel: Warnungen vor der Ausgabe auf Unwetter (ab Stufe 3) beschränken
add_filter( 'wetterwarner_warnings', function ( $warnings, $region_id ) {
	return array_values( array_filter( $warnings, fn( $w ) => $w['stage'] >= 3 ) );
}, 10, 2 );

Die Ausgabe trägt die CSS-Klasse wetterwarner (Shortcode zusätzlich wetterwarner--shortcode), einzelne Elemente folgen dem Schema wetterwarner__….

Fehlersuche

Die Warnungen aktualisieren sich nicht

Ein Caching-Plugin oder der Seiten-Cache des Hosters liefert die Seite eventuell länger aus. Unter Einstellungen › Wetterwarner siehst Du, wann die Daten zuletzt geladen wurden. Steht dort „Noch nicht geladen“, läuft WP-Cron vermutlich nicht – etwa weil DISABLE_WP_CRON gesetzt ist, ohne dass ein Server-Cron eingerichtet wurde.

„Wetterwarnungen sind derzeit nicht verfügbar“

Die Wetterwarner-API war nicht erreichbar, und es liegen noch keine zwischengespeicherten Warnungen vor. Prüfe zuerst den API-Status. Häufige Ursache ist eine Firewall beim Hoster, die ausgehende Verbindungen blockiert. Der Website-Zustand zeigt die genaue Fehlermeldung.

Die Karte wird nicht angezeigt

Prüfe, ob die Kartenbreite größer als 0 ist und das Upload-Verzeichnis beschreibbar ist (Website-Zustand). Nach dem ersten Einfügen erscheint die Karte mit der nächsten Hintergrundaktualisierung.

Der Block ist auf der Website unsichtbar

Das ist gewollt, solange keine Warnung vorliegt und „Auch ohne Warnungen anzeigen“ aus ist. Im Editor weist ein Hinweis darauf hin.

API-Status

Ob die Wetterwarner-API gerade läuft, zeigt die Statusseite. Dort werden auch Störungen und Wartungsarbeiten angekündigt.

Die Statusanzeige wird von Better Stack geladen, siehe Datenschutzerklärung.

Hilfe bekommen

Im Support-Forum auf WordPress.org oder über das Supportformular. Hilfreich ist der Bericht aus Werkzeuge › Website-Zustand › Bericht („Bericht in die Zwischenablage kopieren“).

Hinweise & Lizenzen

• Wetterwarner ersetzt keine amtliche Informationsquelle. Der DWD übernimmt keine Gewähr für die Verfügbarkeit der Daten.
• Warnungen, Warnkarten und Warnregionen: Deutscher Wetterdienst, CC BY 4.0. Die Quellenangabe darf nicht entfernt werden. Nutzungsbedingungen des DWD.
• Plugin: GPLv2 oder später. Icons von Lucide (ISC, Warndreieck aus Feather unter MIT).
• Nur für die Nutzung in Deutschland vorgesehen. Keine Verbindung zur gleichnamigen Android/iOS-App.