=== BBK-Warnung ===
Contributors: Harald Laier
Tags: warnung, bevölkerungsschutz, nina, bbk, hochwasser, unwetter, gefahr, sicherheit, shortcode
Requires at least: 5.0
Tested up to: 6.9
Stable tag: 2.7
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Zeigt aktuelle Warnmeldungen des Bundesamts für Bevölkerungsschutz (BBK) für beliebige Orte oder Landkreise per Shortcode an. Ideal für Kommunen, Feuerwehren und Bürger-Websites.

== Description ==

Dieses Plugin bindet die offizielle Warn-API des BBK (warnung.bund.de) in Ihre WordPress-Seite ein. Es ruft Warnungen zu Gefahrenlagen wie Unwetter, Hochwasser, Brände, Gefahrstoffaustritte oder Polizeimeldungen für frei wählbare Regionen ab.

**Hauptmerkmale**

* **Shortcode `[bbk_warnung]`** – zeige Warnungen für eine oder mehrere Regionen.
* **Durchsuchbare Regionsliste** – alle Gemeinden, Städte und Landkreise Deutschlands sind direkt auswählbar.
* **Shortcode-Generator** im Backend – stellt alle Optionen visuell zusammen.
* **Eigene Überschrift** – Sichtbarkeit und Text der Überschrift individuell steuerbar.
* **Externer Link-Hinweis** – weist Besucher darauf hin, dass ein Link zu warnung.bund.de führt.
* **Immer sichtbarer BBK-Link** – auch wenn keine Warnung aktiv ist, kann ein Link zur Startseite eingeblendet werden.
* **App-Download‑Links** – Verweise auf Google Play und Apple App Store.
* **Eigener Regionsname** – Überschreibt den automatischen Namen in der eckigen Klammer (nützlich für Verbandsgemeinden oder eigene Bezeichnungen).
* **Durchsuchbare ARS-Tabelle** – mit `[bbk_ars_tabelle]` können Sie alle gespeicherten Regionen (ARS, Name, Typ) als interaktive Tabelle anzeigen.
* **Eigenes CSS** – passen Sie das Aussehen der Warnbox über die Einstellungsseite an, ohne Plugin-Dateien zu ändern (siehe FAQ).
* **Mehrsprachig** – das Plugin ist vollständig internationalisiert. Eine deutsche Sprachdatei (.po/.mo) liegt bei.

**Beispiele für den Shortcode**

[bbk_warnung]                                   – verwendet die in den Einstellungen gewählte Region
[bbk_warnung ars="073350000000" show_extern="true"]  – externe Hinweise aktivieren
[bbk_warnung ars="073120000000, 073350000000" show_title="false" custom_name="Region Kaiserslautern"]
[bbk_warnung show_always_link="true" show_app_links="true"] – immer sichtbarer Link und App‑Download-Links

**Datenschutzhinweis**

Es werden keine personenbezogenen Daten erfasst. Die API-Abfragen erfolgen direkt vom Server des Plugins zu den BBK-Servern. Es werden keine Cookies gesetzt.

== Hinweise zur Datenquelle ==

Dieses Plugin nutzt die amtlichen Warnmeldungen des Bundesamts für Bevölkerungsschutz und Katastrophenhilfe (BBK) über die Schnittstelle von warnung.bund.de.

* **Datenquelle:** Bundesamt für Bevölkerungsschutz und Katastrophenhilfe (BBK) / warnung.bund.de
* **Einflussnahme:** Auf die Bereitstellung, Richtigkeit und Aktualität der Daten haben wir keinen Einfluss. Das Plugin greift die API-Daten ab und stellt sie unverändert dar. Die Warnmeldungen selbst werden nicht bearbeitet.
* **Verlinkung:** Für weiterführende Informationen wird automatisch auf die Originalmeldung auf warnung.bund.de verlinkt.
* **Verfügbarkeit:** Für eine dauerhafte und störungsfreie Verfügbarkeit der API kann keine Gewähr übernommen werden. Sollten die Daten aus technischen Gründen nicht abrufbar sein, kann es zu Fehlermeldungen oder leeren Ausgaben kommen.
* **Erster Aufruf der Einstellungen:** Nach der Installation und Aktivierung des Plugins kann der erste Aufruf der Einstellungsseite einige Sekunden länger dauern, da die Regionsdaten (alle Gemeinden und Kreise Deutschlands) in die Datenbank geschrieben werden. Dies ist ein einmaliger Vorgang.

== Installation ==

1. **Laden Sie das Plugin herunter** und entpacken Sie es in `/wp-content/plugins/bbk-warnung/`.
2. **Aktivieren Sie das Plugin** über das WordPress-Admin-Menü.
3. Gehen Sie zu **Einstellungen → BBK-Warnung** und wählen Sie eine Standard-Region aus.
4. Fügen Sie den Shortcode `[bbk_warnung]` in einen Beitrag, eine Seite oder ein Widget ein.

== Frequently Asked Questions ==

= Warum dauert der erste Aufruf der Einstellungen so lange? =

Nach der Installation und Aktivierung des Plugins kann der erste Aufruf der Einstellungsseite einige Sekunden länger dauern, da die Regionsdaten (alle Gemeinden und Kreise Deutschlands) in die Datenbank geschrieben werden. Dies ist ein einmaliger Vorgang.

= Wie finde ich den richtigen ARS (Regionalschlüssel) für meinen Ort? =

Nutzen Sie entweder die durchsuchbare Select2-Liste auf der Einstellungsseite oder den Shortcode `[bbk_ars_tabelle]`, der alle gespeicherten Regionen mit ARS und Namen anzeigt. Alternativ verlinken die Einstellungen auch direkt auf die offiziellen Excel‑Listen des Statistischen Bundesamtes.

= Wie verwende ich den Shortcode für mehrere Orte? =

Geben Sie die ARS kommagetrennt an: `ars="073350000000, 091630000000"`. Für beide Orte werden dann die Warnungen des jeweiligen übergeordneten Kreises angezeigt.

= Kann ich die Überschrift ausblenden oder durch einen eigenen Text ersetzen? =

Ja, mit `show_title="false"` wird die Überschrift ganz unterdrückt. Mit `custom_title="Mein Warnhinweis"` setzen Sie einen eigenen Text.

= Was bedeutet der externe Link-Hinweis? =

Wenn `show_extern="true"` gesetzt ist, erscheint hinter jedem Warnlink der Text „(externer Link zu warnung.bund.de)“. So wissen Ihre Besucher, dass sie zu einer externen Behördenseite weitergeleitet werden.

= Wie kann ich das Aussehen der Warnungen anpassen? =

Auf der Einstellungsseite finden Sie das Textfeld **Eigenes CSS (optional)**. Dort können Sie beliebige CSS-Regeln eintragen, z. B.:

.bbk-warnung-header { color: #b30000; font-size: 1.6em; }
.bbk-warnung-container { background: #f0f7ff; border-left: 5px solid #cc0000; }
.bbk-warnung-list a { color: #0056b3; text-decoration: none; }

Diese Regeln werden automatisch auf jeder Seite mit dem Shortcode ausgegeben. So können Sie Farben, Schriftarten, Abstände oder Rahmen an Ihr Theme anpassen – ohne die Plugin‑Dateien zu ändern.

= Die Warnungen werden nicht angezeigt. Was kann ich tun? =

Prüfen Sie zunächst, ob die Region in der Datenbank vorhanden ist (Seite mit `[bbk_ars_tabelle]`). Stellen Sie sicher, dass Ihre WordPress-Installation `wp_remote_get` erlaubt und die Firewall keine API-Abfragen blockiert. Das Plugin cacht die Warnungen für 5 Minuten – nach einer erneuten Warnung kann es kurz dauern.

= Ist das Plugin mehrsprachig? =

Ja, alle Texte sind übersetzbar. Die aktuelle Version wird mit einer deutschen Sprachdatei ausgeliefert. Bei Interesse können Sie über Poedit auch andere Sprachen (z. B. Englisch) erstellen.

== Changelog ==

= 2.7 =
* Verbesserte Unterscheidung von kreisfreien Städten und Landkreisen in der Regionsauswahl (z. B. „Regensburg (kreisfreie Stadt)“ vs. „Regensburg (Landkreis)“).

= 2.6 =
* Verbesserte Deduplizierung: Identische Warnungen für mehrere angefragte Regionen (ARS) werden nur einmal ausgegeben.
* Die Regionsnamen aller betroffenen Orte werden in einer eckigen Klammer kommagetrennt zusammengefasst (z. B. `[Otterbach, Katzweiler, Schneckenhausen]`).
* Die Warnung selbst erscheint nur einmal – verhindert mehrfache Wiederholungen, z. B. bei Verbandsgemeinden.

= 2.5 =
* Erste stabile Version
* Unterstützung aller deutschen Gemeinden und Kreise
* Umfangreiche Shortcode-Parameter (heading, external hint, always link, app icons, custom name)
* Shortcode-Generator im Backend
* ARS-Tabelle (`[bbk_ars_tabelle]`) für durchsuchbare Regionsliste
* Eigenes CSS-Feld in den Einstellungen
* Caching für hohe Performance (API-Transients)
* Internationalisierung (Textdomain `bbk-warnung`)
* Deutsche Sprachdatei (.po/.mo) enthalten

= 2.4 =
* Interne Vorversion – nicht öffentlich