Aufruf von OpenLogbook aus der eigenen Webseite heraus
Es gibt viele Yachten, die bereits ihre eigene Webseite haben. Auch für solche Yachten ist OpenLogbook ein interessantes Angebot. Sie können die folgenden Funktionen von OpenLogbook in Kombination mit der eigenen Website nutzen:
- Nutzung der Logbuchfunktionen und der Kartendarstellung der Positionen und der Rute als Erweiterung der eigenen Webseite
- Mit dem E-Mail-Interface kann das Logbuch von unterwegs (per KW oder Satellit) geführt werden.
- Die Pflege, Anzeige und Auswahl der einzelnen Reisen einer Yacht.
- Die Kontaktform, die es ermöglicht Nachrichten zu erhalten, ohne die eigene E-Mail-Adresse bekannt zu geben.
- Die Nutzung des Gästebuchs (noch nicht implementiert).
Alles was der interessierte Nutzer dazu tun muss, ist in seine Seite die entsprechenden Links einzufügen. Wie diese Links zu gestalten sind, um die in OpenLogbook vorbereiteten Möglichkeiten optimal auszunutzen wird im Folgenden an verschiedenen Beispielen erläutert.
Voraussetzungen
Um sinnvolle Links von Deiner Webseite nach OpenLogbook zur erzeuge (z.B. den Aufruf Deines Logbuchs aus Deiner Webseiter heraus) sollten folgende Vorausetzungen sollten voher erfüllt sein:
- Die eigene Yacht muss in OpenLogbook registriert und vom Administragor freigegeben sein. (Tutorial zum registrieren einer Yacht)
- Mindestens eine Reise sollte angelegt sein. (Tutorial zum Anlegen einer Reise)
- Mindestens ein Position Report (Logbucheintrag) sollte eingetragen sein. (Tutorial zum Erzeugen eines neuen Position Reports)
Erst nach dem diese Voraussetzungen erfüllt sind, ist im folgenden beschriebene Verlinkung sinnnvoll.
Der einfachste Link
Der einfachste Link ist der folgende: Zeige alle Logbücher in OpenLobook
Dieser Link öffnet die Seite in OpenLogbook, auf der der Nutzer sich die Yacht auswählen kann, deren Logbuch er öffnen möchte. Um einen solchen Link auf Deiner Webeite zu erzeugen, würdest Du im HTML–Text Deiner Seite folgenden Befehl schreiben:
<a href=" http://www.openlogbook.de/olb/web/d/yacht_select.php">Zeige alle Logbücher in OpenLobook </a>
Natürlich ist das bisher nicht besonders spannend. Schließlich will man in aller Regel nicht auf alle Yachten, sondern nur auf die eigene verlinken. Im Weiteren wird genau das erläutert.
Der Aufbau eines Links
Bevor wir weitere Beispiele ansehen, wollen wir uns zunächst mit dem allgemeinen Aufbau eines Links vertraut machen.
Ein Link besteht immer aus einer so genannten URL (Uniform Resource Locator) damit ist die eigentliche Internetadresse der aufzurufenden Seite gemeint. Dahinter kann – getrennt durch ein Fragezeichen – ein so genannter Query String folgen. In diesem Query String können zusätzliche Parameter an die aufzurufende Webseite gesendet werden. Die einzelnen Paramert werden durch ein Und-Zeichen (&) voneinander getrennt. In OpenLogbook werden diese Parameter verwendet um
- Eine Yacht auszuwählen,
- Eine Reise dieser Yacht zu definieren,
- Das Aussehen der Seite zu beeinflussen.
Verlinkbare Seiten in OpenLogbook
Folgende OpenLogbook-Seiten sind mit Deiner Webseite sinnvoll verlinkbar:
1) Seite zur Auswahl einer Reise (YachtID muss als Parameter angehangen werden):
www.openlogbook.de/olb/web/d/logbook/reise_select.php
2) Seite zur Anzeige der Yacht und Crew-Informationen (YachtID muss als Parameter angehangen werden):
www.openlogbook.de/olb/web/d/logbook/yacht_info.php
3) Seite zur Anzeige der Reiseinformationen (YachtID und ReiseNr müssen als Parameter angehangen werden):
www.openlogbook.de/olb/web/d/logbook/reise_info.php
4) Seite zur Anzeige Logbuchs (YachtID und ReiseNr müssen als Parameter angehangen werden):
www.openlogbook.de/olb/web/d/logbook/logbook.php
5) Seite zur Anzeige der Kartendarstellung (YachtID und ReiseNr müssen als Parameter angehangen werden):
www.openlogbook.de/olb/web/d/logbooklogmap.php
6) Seite zur Anzeige der Kontaktform (YachtID muss als Parameter angehangen werden):
www.openlogbook.de/olb/web/d/logbook/contact_yacht.php.php
7) Seite zur Anzeige des Gästebuches (YachtID muss als Parameter angehangen werden):
noch nicht implementiert
Parameter
Von den entsprechenden Seiten in OpenLogbook werden folgende Parameter verstanden:
Parameter für Yacht- und Reisedefinition
YachtID: Die eindeutige Identifikationsnummer einer Yacht in OpenLogbook. Dieser Parameter muss immer übergeben werden, ansonsten wird die Seite nicht geöffnet.
ReiseNr: Jede Yacht in Openlogbook kann verschiedene Reisen anlegen. Das hilft um die Seite übersichtlicher zu gliedern. Ein Logbucheintrag ist also immer auch einer Reise zugeordnet. Um das Logbuch einer bestimmten Reise zu öffnen, muss auch die ReiseNr als Parameter übergeben werden.
Home: Der Link auf diejenige Seite, die geöffnet werden soll, wenn der Nutzer auf den Link „Home“ in OpenLogbook klickt. Fehlt dieser Parameter, wird die Taste „Home“ in OpenLogbook nicht angezeigt. Beispiel: Home=www.trade-wind.de
Parameter für das unterdrücken von Links
Yacht: Wird der Parameter Yacht=0 übergeben, wird die Taste „Yacht“ im Menü nicht mit angezeigt. Der Nutzer kann dann die Seite der Vorstellung der Yacht und der Crew in OpenLogbook nicht mehr direkt aufrufen.
Leg: Wird der Parameter Leg=0 übergeben, wird die Taste „Reise“ im Menü nicht mit angezeigt. Der Nutzer kann dann die Seite mit der Auswahl der Reisen für die jeweilige Yacht in OpenLogbook nicht mehr direkt aufrufen.
Logbook: Wird der Parameter Logbook=0 übergeben, wird die Taste „Logbook“ im Menü nicht mit angezeigt. Der Nutzer kann dann die Seite mit den Logbüchern in OpenLogbook nicht mehr direkt aufrufen.
Map: Wird der Parameter Map=0 übergeben, wird die Taste „Karte“ im Menü nicht mit angezeigt. Der Nutzer kann dann die Seite mit den Logbüchern in OpenLogbook nicht mehr direkt aufrufen.
Contact: Wird der Parameter Contact=0 übergeben, wird die Taste „Kontakt“ im Menü nicht mit angezeigt. Der Nutzer kann dann die Seite mit der Kontaktform in OpenLogbook nicht mehr direkt aufrufen.
Parameter für die Erzeugung von nutzerspezifischen Tasten mit entsprechenden Links
Label1: Text für die erste nutzerspezifische Taste.
Link1: Link für die erste nutzerspezifische Taste.
Label2: Text für die zweite nutzerspezifische Taste.
Link2: Link für die zweite nutzerspezifische Taste.
Label3: Text für die dritte nutzerspezifische Taste.
Link3: Link für die dritte nutzerspezifische Taste.
Beispiele
Reiseauswahl
Es soll die Reiseauswahl der Segelyacht "Girofle" (YachtID=30) geöffnet werden. Home soll nicht angezeigt werden.
Link: Zeige die Reisen der Segelyacht "Girofle"
HTML Text:
<a href="http://www.openlogbook.de/olb/web/d/logbook/reise_select.php?YachtID=30">Zeige die Reisen der Segelyacht "Girofle"</a>
Es soll die Reiseauswahl der Segelyacht "Girofle" (YachtID=30) geöffnet werden. Home soll die Seite www.trade-wind.de sein
Link: Zeige die Reisen der Segelyacht "Girofle"
HTML Text:
<a href="http://www.openlogbook.de/olb/web/d/logbook/reise_select.php?YachtID=30&Home= www.trade-wind.de ">Zeige die Reisen der Segelyacht "Girofle"</a>
Anzeige von Yacht- und Crewinformationen
Es sollen die Yacht- und Crewinformationen der Segelyacht "Girofle" (YachtID=30) angezeigt werden. Home soll nicht angezeigt werden.
Link: Zeige die Yacht- und Crewinfo der Segelyacht "Girofle"
HTML Text:
<a href="http://www.openlogbook.de/olb/web/d/logbook/yacht_info.php?YachtID=30"> Zeige die Yacht- und Crewinfo der Segelyacht "Girofle" </a>
Anzeige der Reiseinformationen
Es sollen die Reiseinformationen der ersten Reise (ReiseNr=1) der Segelyacht "Girofle" (YachtID=30) angezeigt werden. Home soll nicht angezeigt werden.
Link: Zeige die Reiseinformationen der ersten Reise der Segelyacht "Girofle"
HTML Text:
<a href="http://www.openlogbook.de/olb/web/d/logbook/reise_info.php?YachtID=30&ReiseNr=1"> Zeige die Reiseinformationen der ersten Reise der Segelyacht "Girofle" </a>
Anzeige der Reiseinformationen mit nutzerspezifischen Link
Es sollen die Reiseinformationen der ersten Reise (ReiseNr=1) der Segelyacht "Girofle" (YachtID=30) angezeigt werden. Home soll nicht angezeigt werden. Zusätzlich soll eine Taste mit der Aufschrift „Bildergalerie“ erzeugt werden, bei deren Betätigung zur Bildergalerie von Trade-Wind gesprungen wird.
Link: Zeige die Reiseinformationen der ersten Reise der Segelyacht "Girofle"
HTML Text:
<a href="http://www.openlogbook.de/olb/web/d/logbook/reise_info.php?YachtID=30&ReiseNr=1&Label1=Bildergalerie&Link1=www.trade-wind.de/P1/German/Bildergalerie.php"> Zeige die Reiseinformationen der ersten Reise der Segelyacht "Girofle" </a>
Anzeige der Kontaktform
Es sollen die Kontaktform der Segelyacht "Girofle" (YachtID=30) angezeigt werden. Home soll nicht angezeigt werden.
Link: Zeige die Kontaktform der Segelyacht "Girofle"
HTML Text:
<a href="http://www.openlogbook.de/olb/web/e/logbook/contact_yacht.php?YachtID=30 "> Zeige die Reiseinformationen der ersten Reise der Segelyacht "Girofle" </a>
Anzeige des Logbuchs
Es soll das Logbuch der ersten Reise (ReiseNr=1) der Segelyacht "Girofle" (YachtID=30) angezeigt werden. Home soll die Seite www.trade-wind.de sein
Link: Zeige das Logbuch der ersten Reise der Segelyacht "Girofle"
HTML Text:
<a href="http://www.openlogbook.de/olb/web/e/logbook/logbook.php?YachtID=30&ReiseNr=1&Home= www.trade-wind.de "> Zeige die Reiseinformationen der ersten Reise der Segelyacht "Girofle" </a>
Es soll das Logbuch der ersten Reise (ReiseNr=1) der Segelyacht "Girofle" (YachtID=30) angezeigt werden. Home soll die Seite www.trade-wind.de sein. Es sollen nur die Tasten Home, Logbook und Karte angezeigt werden.
Link: Zeige das Logbuch der ersten Reise der Segelyacht "Girofle"
HTML Text:
<a href="http://www.openlogbook.de/olb/web/e/logbook/logbook.php?YachtID=30&ReiseNr=1&Home= www.trade-wind.de "> Zeige die Reiseinformationen der ersten Reise der Segelyacht "Girofle" </a>
Es soll das Logbuch der ersten Reise (ReiseNr=1) der Segelyacht "Girofle" (YachtID=30) angezeigt werden. Home soll die Seite www.trade-wind.de sein. Es sollen drei zusätzliche nutzerdefinierte Tasten angezeigt werden.
Link: Zeige das Logbuch der ersten Reise der Segelyacht "Girofle"
HTML Text:
<a href="http:// www.openlogbook.de/olb/web/d/logbook/logbook.php?YachtID=30&ReiseNr=1&Home=www.trade-wind.de&Label1=Bildergalerie&Link1= www.trade-wind.de/P1/German/Bildergalerie.php &Label2=Yachtauswahl&Link2=www.openlogbook.de/olb/web/d/yacht_select.php&Label3=Noonsite&Link3=www.noonsite.com "> Zeige die Reiseinformationen der ersten Reise der Segelyacht "Girofle" </a>
Anzeige der Kartendarsellung
Die Kartendarstellung der ersten (ReiseNr=1) Reise der Segelyacht "Girofle" (YachtID=30) soll angezeigt werden. Home soll die Seite www.trade-wind.de sein
Link: Zeige die Kartendarstellung der ersten Reise der Segelyacht "Girofle"
HTML Text:
<a href="http://www.openlogbook.de/olb/web/d/logbook/logmap.php?YachtID=30&ReiseNr=1&Home= www.trade-wind.de "> Zeige die Reiseinformationen der ersten Reise der Segelyacht "Girofle" </a>
Viel Spaß mit OpenLogbook.