Einbinden in die eigene Internetseite

Es gibt zwei Möglichkeiten MyBlitzortung auf der eigenen Internetseite zu verwenden.

Standalone

Nachdem die Installation abgeschlossen wurde, kann MyBlitzortung bereits so wie es ist verwendet werden. Einfach im Browser den Pfad zu MyBlitzortung eingeben und es sollte funktionieren. In dieser Form kann es auch als Frame auf der eigenen Homepage angezeigt werden.

Einbinden per PHP

MyBlitzortung wurde speziell daraufhin Entwickelt um es nahtlos in die eigene Homepage einzubinden. Die verschiedenen Bereiche (Karten, Statistiken…) können einzeln über PHP-Funktionen aufgerufen werden. Es ist damit auch möglich, Teile von MyBlitzortung zu verbergen, indem diese nicht eingebunden werden.

In den folgenden Content-Management-Systemen wurde MyBlitzortung schon erfolgreich eingebunden:

  • WordPress
  • Drupal

Als Einstieg ein simples Beispiel bei dem nur die Kartenansicht eingebunden wird:
<?php
include "dateipfad/zu/myblitzortung/blitzortung.php";
?><html>
...
Eigenes HTML oder PHP...
...
<?php
bo_show_map();
?>
...
</html>

Allgemeines

Wenn möglich, sollte der include-Befehl vor jeglicher Ausgabe stehen. Das ist eventuell nicht bei allen CMS möglich, so dass die Einbindung auch später erfolgen kann. Es kann dann jedoch zu Problemen beim Login kommen.

Ein Überblick über die einsetzbaren Funktionen gibt es hier:

Grafiken

Um die Grafiken ausliefern zu können, wird zusätzlich noch ein Hilfsskript benötigt. Die URL zu diesem Skript wird durch die Konstante BO_FILE in der config.php angegeben. Am einfachsten ist dies die blitzortung.php aus dem MyBlitzortung-Verzeichnis. Will man das eigentliche MyBlitzortung-Verzeichnis nicht verraten, so kann man auch eine eigene PHP-Datei anlegen, in der nur die blitzortung.php per include-Befehl eingebunden ist. MyBlitzortung kann man somit sogar außerhalb des DocumentRoot installieren.

Besonderheiten für den Login

Da der Link zum Login auf jeder Seite eingeblendet wird, muss MyBlitzortung wissen, hinter welcher URL sich der Login-Bildschirm verbirgt. Dafür ist in der settings.php die Konstante BO_LOGIN_URL vorgesehen. Integriert man MyBlitzortung in seine Homepage, so muss der Wert angepasst werden. Entweder man lässt ihn auf die Standalone zeigen: ?pfad/zur/blitzortung/index.php?bo_page=login? Besser ist es jedoch, man erstellt eine eigene Datei wo die Funktion bo_show_login() aufgerufen wird, und gibt diese als URL an.

Für die anderen Seiten gilt dasselbe, beispielsweise steht BO_LOGIN_ARCHIVE für die Url zum Archiv (nicht alle dieser Urls werden momentan benutzt).

Style

Die Stylesheet-Datei “style.css” aus dem MyBlitzortungs Verzeichnis sollte in die eigene HTML-Datei mit eingebunden werden. So braucht man sich erstmal kein Gedanken über das Aussehen machen und kann den Style in einer eigenen Datei entsprechend abändern. Wichtig: Die MyBlitzortung-Funktion muss in einem div-container mit der ID “myblitzortung” eingebunden sein. Die style.css “wirkt” nur auf diesen Bereich und nicht auf den eigenen HTML Code außerhalb.

Beispiel

Die eigene PHP-Datei (meinedatei.php) sieht so aus:
<?php
include "dateipfad/zu/myblitzortung/blitzortung.php";
?><html>
<head>
...
<link rel="stylesheet" href="url/zur/myblitzortung/style.css" type="text/css">
<link rel="stylesheet" href="own_style.css" type="text/css">
...
</head>
<body>
...
Beliebiger eigener HTML/PHP code
...
<?php
bo_show_menu();
?>
<div id="myblitzortung">
<?php bo_show_all(); ?>
</div>
Beliebiger eigener HTML/PHP code
...
</body>
</html>

config.php:
define('BO_FILE', '/url/zur/myblitzortung/blitzortung.php');
define('BO_ARCHIVE_URL', 'meinedatei.php?bo_page=archive');
define('BO_LOGIN_URL', 'meinedatei.php?bo_page=login);