Integration - Belegungsübersichten
Die Integration der verschiedenen Belegungsübersichten in Ihre Homepage lässt sich am einfachsten mithilfe der OnBuSys-Javascript-Bibliothek durchführen. Die Vorgehensweise mit zahlreichen Demos wird unter dem Menüpunkt Integration/Widgets beschrieben. Unter dem Menüpunkt Integration/Bibliothek finden Sie Informationen zur OnBuSys-Javascript-Bibliothek.
Auf dieser Seite erhalten Sie ausführliche Informationen zu den zur Verfügung stehenden Belegungsübersichten und Hinweise zu einer alternativen Möglichkeit der Einbindung in Ihre Homepage mittels IFrames.
Der jeweils zugehörige html-Code steht als Kopiervorlage zur Verfügung.
Insgesamt stehen Ihnen vier verschiedene Arten von Belegungsübersichten für den Kundenbereich zur Verfügung:
- Belegungsübersicht für ein Objekt als Mini-Monatskalender, die für eine beliebige Anzahl von aufeinander folgenden Monaten in einer Tabelle zusammengefasst werden können
- Belegungsübersicht für frei wählbare Objekte, die alle zugleich angezeigt werden
- Belegungsübersicht für frei wählbare Objekte, von denen eine frei wählbare Anzahl sichtbar ist. Die restlichen können per Scrollbar sichtbar gemacht werden
- Belegungsübersicht für ein Objekt als Jahreskalender
Zusätzlich gibt es noch eine Belegungsübersicht, die in den Adminbereich fest integriert ist. Bei dieser Belegungsübersicht werden wichtige Kundendaten eingeblendet, wenn man den Mauszeiger über den Anreisetag einer Buchung/Buchungsanfrage bewegt.
Der Jahreskalender ist ebenfalls fest in den Adminbereich integriert, wobei hier noch die Vermietumsätze angezeigt werden.
Für Ihre Beauftragten vor Ort (Schlüsseldienst, Putzdienst, Hausmeister, ...) steht eine spezielle Info-Belegungsübersicht zur Verfügung, bei der Ihre Beauftragten für die Vermietungen relevante Daten abrufen können. Der Datenschutz Ihrer Kunden ist dabei selbstverständlich gewährleistet.
Im Folgenden wird erläutert, wie Sie die einzelnen Belegungsübersichten mithilfe von IFrames
in Ihre Seite integrieren können:
URL: https://Pfad_zum_Ordner_OBS/OBS/miniTAB.php
Parameter (die Reihenfolge ist einzuhalten; wird ein optionaler Parameter nicht verwendet,
gilt der default-Wert):
| id (erforderlich) | Benutzername@Objektname z.B. id=domizil@Zimmer01 (der Benutzername domizil ist nicht änderbar) |
| groesse (optional) | Vergrößerung des default-Mini-Monatskalenders z.B. groesse=10 vergrößert jede Spalte und jede Zeile um 10px - default-Wert: 0 |
| links (optional) | Darstellungsmöglichkeit des Buchungsformulars: 0: keine Darstellung 1: im sep. Fenster 2: im gleichen Fenster z.B. links=0 - default-Wert: 1 |
| x (optional) | Anzahl der Tabellenspalten mit Monatskalendern z.B. x=2 - default-Wert:4 |
| y (optional) | Anzahl der Tabellenzeilen mit Monatskalendern z.B. y=1 - default-Wert:3 |
| date (optional) | Startmonat für den ersten Mini-Monatskalender z.B. date=5-2014 - der default-Wert hängt von Ihrer Wahl im TAB 'Einstellungen' im Adminbereich ab |
| lan (optional) | Sprache, mit der die Mini-Monatskalender gestartet werden z.B. lan=en-GB - der default-Wert ist die default-Sprache (siehe TAB 'Einstellungen' im Adminbereich) |
Demoseite mit Beispielen und html-Code-Vorlagen für die Integration
URL: https://Pfad_zum_Ordner_OBS/OBS/belegung.php
Parameter (die Reihenfolge ist einzuhalten; wird ein optionaler Parameter nicht verwendet, gilt der default-Wert):
| id (erforderlich) | Benutzername z.B. id=domizil (der Benutzername domizil ist nicht änderbar) |
| ofeld (optional) | Liste der anzuzeigenden Objekte: durch Kommas getrennte Objektnamen, keine Leerzeichen z.B. ofeld=Elfer,Wald,Buttje,Berg - default-Wert: alle Objekte |
| marg (optional) | Damit erhält die Belegungsübersicht einen internen Rahmen der Breite 'marg' in der gleichen Farbe wie die Hintergrundfarbe der Belegungsübersicht z.B. marg=10px - default-Wert: 0px |
| links (optional) | Darstellungsmöglichkeit des Buchungsformulars: 0: keine Darstellung 1: im sep. Fenster 2: im gleichen Fenster z.B. links=1, default-Wert: 0 |
| date (optional) | Startmonat für die Belegungsübersicht z.B. date=5-2014, der default-Wert hängt von Ihrer Wahl im TAB 'Einstellungen' im Adminbereich ab |
| lan (optional) | Sprache, mit der die Belegungsübersicht gestartet wird z.B. lan=en-GB, der default-Wert ist die default-Sprache (siehe TAB 'Einstellungen' im Adminbereich) |
Demoseite mit Beispielen und html-Code-Vorlagen für die Integration
URL: https://Pfad_zum_Ordner_OBS/OBS/belegungdiv.php
Parameter (die Reihenfolge ist einzuhalten; wird ein optionaler Parameter nicht verwendet, gilt der default-Wert):
| id (erforderlich) | Benutzername z.B. id=domizil (der Benutzername domizil ist nicht änderbar) |
| ofeld (optional) | Liste der anzuzeigenden Objekte: durch Kommas getrennte Objektnamen, keine Leerzeichen z.B. ofeld=Elfer,Wald,Buttje,Berg - default-Wert: alle Objekte |
| anzahl (optional) | Anzahl der sichtbaren Objekte, die weiteren Objekte können per Scrollbar sichtbar gemacht werden z.B. anzahl=6 - default-Wert: 4 |
| top (optional) | Abstand der Belegungsübersicht vom oberen Rand des umfassenden internen DIV-Containers in px z.B. top=10 - default-Wert: 0 Mit top=10 und left=10 erhält die Belegungsübersicht einen 10px breiten internen Rahmen |
| left (optional) | Abstand der Belegungsübersicht vom linken Rand des umfassenden internen DIV-Containers in px z.B. left=10 - default-Wert: 0 Mit top=10 und left=10 erhält die Belegungsübersicht einen 10px breiten internen Rahmen |
| links (optional) | Darstellungsmöglichkeit des Buchungsformulars: 0: keine Darstellung 1: im sep. Fenster 2: im gleichen Fenster z.B. links=1, default-Wert: 0 |
| date (optional) | Startmonat für die Belegungsübersicht z.B. date=5-2014, der default-Wert hängt von Ihrer Wahl im TAB 'Einstellungen' im Adminbereich ab |
| lan (optional) | Sprache, mit der die Belegungsübersicht gestartet wird z.B. lan=en-GB, der default-Wert ist die default-Sprache (siehe TAB 'Einstellungen' im Adminbereich) |
Demoseite mit Beispielen und html-Code-Vorlagen für die Integration
URL: https://Pfad_zum_Ordner_OBS/OBS/monTAB.php
Parameter (die Reihenfolge ist einzuhalten; wird ein optionaler Parameter nicht verwendet, gilt der default-Wert):
| id (erforderlich) | Benutzername@Objektname z.B. id=domizil@Zimmer01 (der Benutzername domizil ist nicht änderbar) |
| anzahl (optional) | Anzahl der sichtbaren Objekte, die weiteren Objekte können per Scrollbar sichtbar gemacht werden z.B. anzahl=6 - default-Wert: 12 |
| top (optional) | Abstand der Belegungsübersicht vom oberen Rand des umfassenden internen DIV-Containers in px z.B. top=10 - default-Wert: 0 Mit top=10 und left=10 erhält die Belegungsübersicht einen 10px breiten internen Rahmen |
| left (optional) | Abstand der Belegungsübersicht vom linken Rand des umfassenden internen DIV-Containers in px z.B. left=10 - default-Wert: 0 Mit top=10 und left=10 erhält die Belegungsübersicht einen 10px breiten internen Rahmen |
| umsatzmode (optional) | Modi zur Berechnung der Monatsumsätze ums_anreise: Alle Buchungen werden berüchsichtigt, deren Anreisedatum im betreffenden Monat liegen ums_abreise: Alle Buchungen werden berüchsichtigt, deren Abreisedatum im betreffenden Monat liegen ums_taggenau: Der Umsatz einer Vermietung, die mehrere Monate tangiert, wird entsprechend der Bruchteile der Tage auf die entsprechenden Monate verteilt z.B. umsatzmode=ums_anreise - default-Wert: ums_taggenau Nur im Adminbereich relevant, im Kundenbereich nicht verfügbar Im Adminbereich können die verschiedenen Modi per Radiobutton ausgewälht werden |
| links (optional) | Darstellungsmöglichkeit des Buchungsformulars: 0: keine Darstellung 1: im sep. Fenster 2: im gleichen Fenster z.B. links=1, default-Wert: 0 |
| date (optional) | Startmonat für die Belegungsübersicht z.B. date=5-2014, der default-Wert hängt von Ihrer Wahl im TAB 'Einstellungen' im Adminbereich ab |
| lan (optional) | Sprache, mit der die Belegungsübersicht gestartet wird z.B. lan=en-GB, der default-Wert ist die default-Sprache (siehe TAB 'Einstellungen' im Adminbereich) |
Demoseite mit Beispielen und html-Code-Vorlagen für die Integration
Die Info-Belegungsübersicht für frei wählbare Objekte, die alle zugleich angezeigt werden
Die Info-Belegungsübersicht ist nicht für die Integration in Ihre Site vorgesehen, sondern sie soll den Personen, die vor Ort Ihre Feriendomizile betreuen, eine Möglichkeit bieten, zu jedem Zeitpunkt die aktuellen Informationen über die Aktivitäten in Ihren Feriendomizilen auf einfache Weise abzurufen.
Dazu müssen Sie diesen Personen lediglich einen Link übermitteln, mit dem diese via i- oder Smartphone, Tablet oder PC diese spezielle Info-Belegungsübersicht aufrufen können. Mit einem Klick (Touch) auf den Anreisetag einer Buchung erhalten sie alle für die Betreuung Ihrer Feriendomizile notwendigen Informationen für diese Buchung. Da diese Info-Belegungsübersicht nicht zugangsgeschützt ist, enthält sie keine personenbezogenen Daten.
Die Grundform dieses Links lautet:
https://Pfad_zum_Ordner_OBS/OBS/belegInfo.php?id=domizil, z.B.
https://onbusys.de/101/OBS/belegInfo.php?id=domizil
Folgende Parameter können Sie verwenden um den Link an spezielle Gegebenheiten anzupassen (die Reihenfolge ist einzuhalten; wird ein optionaler Parameter nicht verwendet, gilt der default-Wert).
Bitte beachten Sie die Beispiellinks nach der Tabelle.
| id (erforderlich) | Benutzername z.B. id=domizil (der Benutzername domizil ist nicht änderbar) |
| ofeld (optional) | Liste der anzuzeigenden Objekte: durch Kommas getrennte Objektnamen, keine Leerzeichen z.B. ofeld=Elfer,Wald,Buttje,Berg - default-Wert: alle Objekte |
| marg (optional) | Damit erhält die Belegungsübersicht einen internen Rahmen der Breite 'marg' in der gleichen Farbe wie die Hintergrundfarbe der Belegungsübersicht z.B. marg=50px - default-Wert: 10px |
| links (optional) | Darstellungsmöglichkeit des Buchungsformulars: 0: keine Darstellung 1: im sep. Fenster z.B. links=1, default-Wert: 0 |
| date (optional) | Startmonat für die Belegungsübersicht z.B. date=5-2014, der default-Wert hängt von Ihrer Wahl im TAB 'Einstellungen' im Adminbereich ab |
| lan (optional) | Sprache, mit der die Belegungsübersicht gestartet wird z.B. lan=en-GB, der default-Wert ist die default-Sprache (siehe TAB 'Einstellungen' im Adminbereich) |
Für eine Person, die nur für die Zimmer01 bis Zimmer04 zuständig ist, verwenden Sie den Paramete 'ofeld':
https://onbusys.de/101/OBS/belegInfo.php?id=domizil&ofeld=Zimmer01,Zimmer02,Zimmer03,Zimmer04
Einen größeren Abstand der Belegungsübersicht zum Rand erhalten Sie mit dem Parameter 'marg':
Wenn die Person auch Kundenbuchungen vornehmen können soll, müssen Sie den Parameter 'links' verwenden. Mit links=1 erhalten die Objektnamen in der Belegungsübersicht einen Link zum Buchungsformular:
Wenn die Belegungsübersicht mit einem bestimmten Monat und in einer bestimmten Sprache gestartet werden soll, können Sie dies mit den Parametern 'date' und 'lan' erreichen:
