Widgets

Mit Widgets lassen sich Teile des Vogelschlagmelders in die eigene Vereinswebseite einbauen. Besucher melden dann direkt dort, ohne die Seite zu wechseln. Technisch handelt es sich um iFrames – kleine Fenster, in denen der Vogelschlagmelder innerhalb einer anderen Seite angezeigt wird.

Unter Widgets in der Adminoberfläche steht für jedes Widget ein fertiger Code zum Kopieren bereit. Er wird im Baukasten oder CMS der eigenen Webseite in einen HTML-Block eingefügt – bei WordPress etwa im Block „Individuelles HTML“.

Es gibt drei Widgets:

Widget	Inhalt	Höhe im Code
Meldeformular	das vollständige Formular ohne Kopf- und Fußbereich	1200 px
Gefahrenkarte	die Karte mit Legende	560 px
Zähler	die Anzahl der Vogelkollisionen	170–190 px

Die Widgets übernehmen das Farbschema aus den Anpassungen.

Meldeformular einbetten

Code kopieren legt den Code in die Zwischenablage:

<iframe src="https://vogelschlag.example.org/embed/meldeformular"
        width="100%" height="1200" style="border:0;max-width:760px;"
        loading="lazy" allow="geolocation" title="Vogelschlag melden"></iframe>

Das eingebettete Formular ist höchstens 760 Pixel breit und passt sich schmaleren Spalten an. Überschrift, Einleitungstext und Hinweisbox der Startseite fehlen. Wichtige Hinweise sollten deshalb auf der einbettenden Seite über dem Formular stehen.

Die Höhe von 1200 Pixeln reicht für das Formular in der Grundform. Werden viele Fotos hinzugefügt oder zusätzliche Felder eingeblendet, erscheint im iFrame eine Bildlaufleiste. Bei Bedarf kann der Wert height im Code erhöht werden.

Standortbestimmung nur über HTTPS

Die Schaltfläche Standort automatisch bestimmen funktioniert im iFrame nur, wenn auch die einbettende Webseite über HTTPS erreichbar ist. Das nötige Attribut allow="geolocation" ist im Code bereits enthalten.

Gefahrenkarte einbetten

Der Code bettet die Rasterkarte mit Legende ein, ohne Zähler, Info-Boxen und Link-Boxen. Voraussetzung ist, dass die Gefahrenkarte öffentlich zugänglich ist (siehe Gefahrenkarte). Andernfalls zeigt das Widget nur eine Fehlerseite.

Zähler einbetten

Unter Angezeigte Zähler wird gewählt, was das Widget zeigt:

Auswahl	Anzeige
Alle Zähler (gesamt, Jahr, Monat)	drei Kacheln nebeneinander
Nur Kollisionen gesamt	eine Kachel
Nur Kollisionen dieses Jahr	eine Kachel
Nur Kollisionen diesen Monat	eine Kachel

Der Code passt sich der Auswahl automatisch an. Die Vorschau unter dem Code zeigt das Widget mit der gewählten Einstellung und den aktuellen Zahlen. Auf der eigenen Webseite sieht das Widget mit allen Zählern so aus:

Gezählt wird wie auf der Gefahrenkarte: Duplikate zählen nicht, Meldungen mit mehreren Kollisionen zählen mehrfach. Historische Daten gehen nur in „gesamt“ ein und nur, wenn das unter Historische Daten eingeschaltet ist.

Erlaubte Domains

Hier wird festgelegt, auf welchen Webseiten die Widgets erscheinen dürfen. Ohne diese Liste könnte jede beliebige Webseite das Meldeformular einbinden und als eigenes ausgeben.

• Eine Domain pro Zeile, zum Beispiel nabu-jena.de.

• *.nabu-jena.de erlaubt alle Subdomains, etwa www.nabu-jena.de.

• Ohne https:// wird HTTPS angenommen. Für eine Seite, die nur über HTTP erreichbar ist, muss http:// davorstehen.

• Pfade wie nabu-jena.de/vogelschutz sind nicht erlaubt und werden ohne Meldung ignoriert. Es zählt immer die ganze Domain.

Leere Liste erlaubt alles

Bleibt das Feld leer, gilt die Umgebungsvariable WIDGET_ALLOWED_DOMAINS aus der Installation. Ist auch sie leer, dürfen die Widgets auf jeder Webseite eingebettet werden. Sobald die eigene Webseite feststeht, sollte sie hier eingetragen werden.

Zeigt eine Webseite das Widget nicht an, sondern eine leere Fläche oder eine Fehlermeldung des Browsers, fehlt sie fast immer in dieser Liste – oder sie ist mit www. erreichbar, eingetragen ist aber nur die Domain ohne www..

Alle übrigen Seiten des Vogelschlagmelders, etwa die Startseite oder die Adminoberfläche, lassen sich grundsätzlich nicht einbetten. Wer statt des Widgets die Startseite in einen iFrame setzt, sieht eine leere Fläche.