MFI Example Page

Eine vollständige, lauffähige Website. Sie holt selbstständig Wetterdaten, lässt daraus den Mähbarkeitsindex berechnen und zeigt das Ergebnis an – mit Empfehlung im Klartext, Indexwert und den Begründungen der einzelnen Prüfungen. Es ist kein Baukasten und kein Plugin für ein bestehendes System, sondern ein fertiger Satz Dateien, den Sie auf Ihren eigenen Webspace legen. Wie das Ergebnis aussieht, zeigt das laufende Beispiel unter mep.maehbarkeitsindex.de.

Für die Vorlage selbst fallen keine Kosten an. Der Zugang zur MFI API ist kostenfrei, ebenso der benötigte OpenWeather-Zugang in dem hier genutzten Umfang. Bezahlen müssen Sie nur Ihr eigenes Webhosting, sofern Sie noch keines haben.

Sie sollten Dateien auf einen Webspace hochladen können und wissen, wo Sie im Kundenmenü Ihres Hosters eine Datenbank anlegen. Programmierkenntnisse sind für die Einrichtung nicht nötig – der Assistent führt durch alle Schritte und prüft jede Eingabe. Für eigene Erweiterungen sind PHP-Grundkenntnisse hilfreich.

Wenn beide Zugangsschlüssel bereits vorliegen und die Datenbank angelegt ist, sind es meist 15 bis 30 Minuten. Rechnen Sie zusätzlich Wartezeit für die Schlüssel ein: MFI-Zugangsschlüssel werden von Hand freigeschaltet, neue OpenWeather-Schlüssel brauchen einige Stunden, bis sie funktionieren.

Nötig sind PHP ab Version 8.5, eine MySQL-Datenbank ab 8.0 oder MariaDB ab 10.4 und ein Apache-Webserver. Diese Angaben stehen in der Leistungsübersicht Ihres Hosters. Im Zweifel laden Sie die Dateien einfach hoch: Der erste Schritt des Einrichtungsassistenten prüft die Umgebung und sagt Ihnen genau, was fehlt.

Ein API-Key ist ein Zugangsschlüssel – eine lange Zeichenfolge, mit der sich Ihre Website bei der MFI API ausweist. Sie beantragen ihn kostenlos über das Registrierungsformular. Nach der Bestätigung Ihrer E-Mail-Adresse wird der Schlüssel von Hand freigeschaltet. Bewahren Sie ihn wie ein Passwort auf.

Ein Cronjob ist eine zeitgesteuerte Aufgabe, die der Server regelmäßig von selbst ausführt – hier alle 15 Minuten das Abrufen neuer Wetterdaten. Bietet Ihr Hosting keinen Cronjob, gibt es zwei Alternativen: die Betriebsart „beim Seitenaufruf", bei der die Daten erneuert werden, sobald jemand die Seite besucht, oder ein externer Cron-Dienst, der eine tokengeschützte Adresse Ihrer Website aufruft.

Der DocumentRoot ist das Verzeichnis, dessen Inhalt Ihr Webserver nach außen sichtbar macht. Idealerweise zeigt er auf den Ordner public/, damit Konfiguration und Programmcode gar nicht erst erreichbar sind. Lässt sich das bei Ihrem Hoster nicht einstellen, verschieben Sie den Inhalt von public/ in Ihr Webverzeichnis und die übrigen Ordner eine Ebene darüber; in zwei Dateien ist dann ein Pfad anzupassen. Die mitgelieferte Serverkonfiguration sperrt vorsorglich auch dann den Zugriff auf Konfigurations-, Datenbank- und Protokolldateien.

Nein. Sie können alle Dateien per FTP hochladen und die Einrichtung vollständig im Browser erledigen. Ein Shell-Zugang ist nur bequemer, wenn Sie das Projekt per Git aktuell halten oder die Wartungsbefehle direkt aufrufen möchten.

Voreingestellt sind 15 Minuten. Kürzere Abstände sind nicht sinnvoll: Die MFI API lässt pro Zugangsschlüssel standardmäßig nur alle 300 Sekunden eine Berechnung zu und antwortet sonst mit einer Fehlermeldung. Zusätzlich begrenzt die Vorlage die Wetterabrufe auf 200 pro Tag, damit Sie nicht versehentlich in die Grenzen des kostenfreien Zugangs laufen.

Der kostenfreie OpenWeather-Zugang liefert keine Bodentemperatur und keine Bodenfeuchte. Ohne diese Werte überspringt die MFI API den Bodencheck und weist die Datenqualität als „teilweise" aus. Die Vorlage blendet den Check deshalb standardmäßig automatisch aus – das ist kein Fehler, sondern gewolltes Verhalten.

Langzeitwerte wie die Regenmenge der letzten 14 Tage berechnet die Vorlage aus ihren eigenen gespeicherten Läufen. Diese Historie muss sich erst aufbauen. Ein abgeleiteter Wert wird erst gesendet, wenn das jeweilige Zeitfenster zu mindestens 80 Prozent belegt ist – die längeren Fenster kommen also nach und nach dazu.

Ja, das ist vorgesehen, erfordert aber PHP-Kenntnisse. Die Wetterquelle steckt hinter einer klar abgegrenzten Schnittstelle: Sie legen eine eigene Klasse im Ordner für Wetterquellen an und tragen sie in der Übersicht der verfügbaren Quellen ein. Mit einer eigenen Station stehen dann meist auch Bodenwerte zur Verfügung, sodass alle fünf Prüfungen laufen und die Datenqualität steigt.

Nicht ohne Anpassung. Die Vorlage ist bewusst auf einen Standort ausgelegt, damit sie übersichtlich bleibt. Die Datenbank führt allerdings bereits eine Standortkennung mit, sodass eine Erweiterung möglich ist.

Ja. Farben und Abstände ändern Sie über eine eigene Stylesheet-Datei, die nach dem mitgelieferten Design geladen wird; eine kommentierte Vorlage mit allen Variablen liegt bei. Ein eigenes Logo tragen Sie in der Konfiguration ein, alle sichtbaren Texte stehen gesammelt in einer Sprachdatei. Wer Farben ersetzt, sollte die Kontraste nachmessen, damit die Barrierefreiheit erhalten bleibt.

Ja. Ihre eigenen Seiten, Ihre Gestaltung und Ihre Konfiguration liegen in Bereichen, die von der Versionsverwaltung ausgenommen sind. Die mitgelieferten Gegenstücke dürfen sich bei Updates weiterentwickeln, ohne Ihre Fassung zu überschreiben.

In aller Regel ja – beides ist für den Betrieb einer Website meist verpflichtend. Die Vorlage liefert die Texte bewusst nicht mit, weil sie von Rechtsform, Hosting und eingesetzten Diensten abhängen. Sie legen die Seiten wie jede andere eigene Seite an und lassen die Texte im Zweifel rechtlich prüfen.

Im laufenden Betrieb nicht. Es gibt kein Tracking, keine externen Schriftarten und keine eingebundenen Fremdinhalte – alle Dateien liegen auf Ihrem Server. Ein einziges technisches Cookie wird während der Einrichtung gesetzt, um den Assistenten vor fremdem Zugriff zu schützen. Ihre Website selbst ruft im Hintergrund OpenWeather und die MFI API auf; für Ihre eigene Datenschutzerklärung ist das relevant.

Ja. Es gelten die Nutzungsbedingungen der MFI API; unter anderem ist die Quelle anzugeben. Das mitgelieferte Badge im Fußbereich der Vorlage erfüllt diese Anforderung bereits, weitere Varianten stehen im Styleguide bereit.

Erste Anlaufstelle ist das mitgelieferte Diagnosewerkzeug, das Umgebung, Datenbank, Erreichbarkeit der API und Schreibrechte in einem Durchlauf prüft und Probleme konkret benennt. Bleibt eine Frage offen, helfen die Diskussionen und der Issue-Tracker des Projekts weiter. Fragen zur API selbst beantwortet die API-FAQ.