FAQ Q173: Ich brauche mehr Kontrolle über die Kalendervorschau.

Absatz: Availability calendar
Sie können den HTML-Code für die Kalendervorschau (die auf Ihrer Website eingebettet werden soll) unter Einstellungen / Integration mit meiner Website / Widgets / Kalendervorschau erhalten. Fast alle Optionen können mit diesem Builder eingestellt werden.

Nur wenn die Standardoptionen nicht ausreichen, lesen Sie bitte dieses Dokument weiter, um alle Optionen herauszufinden, die Sie verwenden können, indem Sie die URL-Parameter des IFRAME des Kalenders ändern, oder Sie können auch einfach die globalen Standardwerte für alle Kalendervorschauen ändern, die für Ihre planyo-Website in Einstellungen / CSS-Style-Editor verwendet werden. Hier sind die Parameter, die hinzugefügt oder geändert werden können:

style=XXX - dieser Parameter wird immer automatisch hinzugefügt, um den Stil der Kalendervorschau zu bestimmen. Einige Stile erfordern bestimmte Parameter, so dass es am besten ist, den Stil in der Planyo-Benutzeroberfläche zu wählen und dann die unten aufgeführten optionalen Parameter hinzuzufügen. Sie können einen der folgenden Stile wählen:
default - der Stil hängt von den anderen Einstellungen und Ihren Ressourcentypen ab. Dies wird immer einer der anderen unten aufgeführten Stile sein,
standard - Standard horizontale (breite) Kalendervorschau,
variable-width - Kalendervorschau mit variabler Breite (wie oben, aber Sie können die Anzahl der sichtbaren Tage einstellen),
multi-month-responsive - kleine Monatsvorschau, die Anzahl der Monate hängt vom verfügbaren horizontalen Platz ab,
multi-month - kleine Monatsvorschau, Sie können die Anzahl der angezeigten Monate auf einmal bestimmen,
week-grid - Stundenraster (breit),
week-grid-2 - Stundenraster (schmal),
upcoming-av - bevorstehender Verfügbarkeitskalender,
big - große Kalenderansicht, eignet sich besonders gut für Event-Ressourcen, sie listet die Ressourcen auf, die an einem bestimmten Tag oder einer bestimmten Stunde vermietet werden können, einschließlich der verfügbaren Menge.

resource_id=XXX - setzt die ID der einzelnen Ressource, die angezeigt werden soll. Tage - wenn Sie die Kalendervorschau mit variabler Breite oder das Stundenraster verwenden, wählen Sie die Anzahl der Tage, die in der Vorschau angezeigt werden. Monatszählung - für die kleine Monatsvorschau wählen Sie, wie viele Monate angezeigt werden sollen.

nox=1 - für den kleinen Monatsvorschau-Kalenderstil werden Farben anstelle des roten X verwendet, um nicht verfügbare Tage zu markieren.

fullh=1 - für 24-Stunden-Zeiten an manchen Stellen wird standardmäßig die Stunde gefolgt von h angezeigt, z.B. 10h. Mit dem Parameter fullh=1 wird dieser durch die volle Stunde 10:00 ersetzt. Wenn Sie dies auf fullh=force setzen, werden Stunden nie von Minuten getrennt (standardmäßig können sie in 2 Zeilen aufgeteilt werden), wodurch die Spalten breiter werden.

custom-language=DE - stellt die Sprache der Kalendervorschau ein (falls abweichend von der Voreinstellung) -- Sprache ist in Form des zweistelligen ISO-Codes (EN, DE, FR, ES, IT etc.).

Stylesheet - URL des CSS-Stylesheets, das verwendet werden soll, um das Design des Kalenders (Farben/Schriften etc.) vollständig zu steuern. Dieser Parameter bleibt nur aus Gründen der Abwärtskompatibilität erhalten. Normalerweise sollten Sie hier das Basis-CSS bearbeiten.

background=XXX - hier können Sie die Hintergrundfarbe des Kalenders einstellen.

resfilter=X,Y,Z - Sie können entscheiden, welche Ressourcen angezeigt werden sollen (nur im horizontalen Stil) - mehr dazu hier

propfilter_name=X&propfilter_value=Y - mit diesem Parameterpaar können Sie Ihre Ressourcen nach der benutzerdefinierten Eigenschaft X filtern -- es werden nur die Ressourcen aufgelistet, deren Eigenschaftswert Y ist - siehe mehr hier. Dieser Ressourcenfilter kann nicht mit den anderen kombiniert werden.

prop_res_xxx=yyyy - Ein alternativer Ressourcen-Selektor zu propfilter_name, propfilter_value (basierend auf benutzerdefinierten Ressourcen-Eigenschaftswerten), aber dieses Format erlaubt es Ihnen, mehrere Ressourcen-Eigenschaftsfilter anzuwenden, z.B. prop_res_abc=1&prop_res_def=2 würde sowohl abc- als auch def-Filter anwenden). Siehe Q205 für die Auflistung der benutzerdefinierten Ressourceneigenschaften, die für Ihre planyo-Website verfügbar sind.

res_type_filter=event, res_type_filter=nonevent - Sie können einen dieser Parameter verwenden, um nur Ressourcen aufzulisten, die vom Typ Event sind oder nicht. Dieser Filter kann nicht mit den anderen kombiniert werden.

sort=prop_res_xxx - Sie können das Standardsortierkriterium von Ressourcen in eine Ihrer benutzerdefinierten Ressourceneigenschaften ändern. Sie sollten alle Kleinbuchstaben verwenden, Leerzeichen sollten durch Unterstriche ersetzt werden und mit dem Präfix prop_res_, z.B. für die Eigenschaft "Anzahl Personen", sollte dies &sort=prop_res_number_of_persons sein.

default_view=day - verwenden Sie dies mit dem horizontalen Kalender, um die Standardansicht auf Tag zu setzen; default_view=month setzt die Standardansicht auf die Monatsanzeige; im Falle des großen Kalenderstils können Sie auch default_view=week verwenden.

no_switching=1 - wenn gesetzt, kann der Benutzer nicht zwischen den Ansichten Tag/Monat (oder Tag/Woche/Monat im Falle des großen Kalenderstils) wechseln; dies wird nur bei den Kalenderstilen verwendet, die diese Auswahl unterstützen.

show_count=1 - zeigt immer die verfügbare Menge als Zahl an (im Standardmodus muss man mit der Maus über ein Quadrat fahren, um die verfügbare Menge zu sehen).

readonly=1 - dadurch werden alle Links zum Reservierungsformular aus der Kalendervorschau entfernt (ein Klick auf freie Plätze hat keine Wirkung). reset_cookie_date=1 - verwenden Sie diesen Parameter, um die Ansicht immer auf den aktuellen Monat zurückzusetzen.

no_range=1 - verwenden Sie diesen Parameter für stundenbasierte Ressourcen, wenn Sie begrenzte Startzeiten haben. In der kommenden Verfügbarkeitsvorschau zeigt dieser Parameter nur die möglichen Startzeiten anstelle von Zeitbereichen bei der bevorstehenden Verfügbarkeitsvorschau an (z.B. 16.00 Uhr, 17.00 Uhr, 18.00 Uhr statt 16.00-19.00 Uhr). Bei anderen Vorschauen sind alle Zeiten, die keine Startzeiten sind, wenn möglich unsichtbar (oder als nicht verfügbar markiert).

visible_items_per_column=X - für die bevorstehende Vorschau des Verfügbarkeitskalenders wird die maximale Anzahl der Einträge pro Spalte (Tag oder Monat) direkt eingestellt, ohne zur nächsten Seite blättern zu müssen. Standardmäßig ist dieser Wert auf 5 gesetzt.

set_date=YYYYY-MM-DD - Sie können den Tag/Monat einstellen, der standardmäßig in der Vorschau angezeigt wird (normalerweise ist es der aktuelle Tag oder das zuvor im Browser des Benutzers als Cookie gespeicherte Datum). Bitte beachten Sie, dass Sie auch Textwerte wie heute oder morgen oder nächsten Mittwoch (mit dem Leerzeichen %20 oder +, z.B. set_date=Next+Mittwoch) oder andere ähnliche Werte (mit next/previous/this/last gefolgt von Wochentagen, Monaten usw.) eingeben können.

find_first_av=1 - setzt diese Option, wenn die Kalendervorschau standardmäßig auf das erste verfügbare Datum gehen soll (nicht zusammen mit set_date verwenden).

morning_icons=1 - fügt eine diagonale Trennlinie zu den Tagen hinzu, an denen ein anderer Gast morgens auscheckt oder abends eincheckt; dies kann nur für Unterkünfte verwendet werden (wenn der Kunde Nächte und nicht Tage reserviert) und mit Standard-, variabler Breite und mehrmonatigen Kalenderstilen.

max_resources=xxx - falls Sie mehr als 30 Ressourcen haben, werden diese standardmäßig ausgelagert. Sie können die Anzahl der Ressourcen pro Seite erhöhen / verringern, indem Sie diesen Parameter ändern. Der zulässige Wert (anstelle von xxx) liegt im Bereich von (5..100)

separate-units=1 - falls Sie mehrere Einheiten einer Ressource haben, werden diese in separaten Zeilen aufgelistet (in den Kalendertypen Standard und variable Breite).

no_start_time_check=1 - falls Sie bestimmte Ankunftswochentage (oder, bei stundenbasierten Ressourcen, bestimmte Startzeiten) haben, sind diese standardmäßig gelb markiert und nur diese Tage sind anklickbar. Mit diesem Parameter können Sie diesen ausschalten.

ignore_events=1 - wenn gesetzt, werden ereignisartige Ressourcen wie normale Ressourcen angezeigt, d.h. die Verfügbarkeit wird für alle Termine angezeigt (und nicht nur für die Startdaten, wie es standardmäßig der Fall ist).

no_extra_info=1 - wenn Sie diesen Parameter mit der horizontalen Kalendervorschau verwenden, wird die Teilverfügbarkeit genauso angezeigt wie die volle Verfügbarkeit (ohne Information über die Anzahl der verfügbaren Einheiten) und sowohl reservierte als auch nicht verfügbare Zeiträume werden auf die gleiche Weise angezeigt; wenn Sie diesen Parameter mit no_start_time_check=1 kombinieren, wird die Kalendervorschau nur zwei Status anzeigen: verfügbar oder nicht verfügbar. Bitte beachten Sie, dass diese Option nur beim Kalendertyp'Kleine Monatsvorschau' voreingestellt ist. Um es auszuschalten (um den Unterschied zwischen nicht verfügbar und reserviert anzuzeigen), verwenden Sie: no_extra_info=0.

show_prep_time=1 - diese Option markiert auch die benötigte Vorbereitungszeit als nicht verfügbar. Dies zeigt Ihren Kunden deutlich, dass auch die Vorbereitungsstunden/Tage nicht verfügbar sind. Die Vorbereitungszeit wird in den Ressourceneinstellungen eingestellt (Min. Zeit zwischen aufeinander folgenden Mieten).

feedback_url - wenn Sie die erweiterte Integration verwenden, bestimmt die feedback_url die URL, wo das planyo-Plugin/Modul auf Ihrer Website eingebettet ist. Ein Klick auf die Kalendervorschau öffnet dann das Reservierungsformular auf Ihrer Website anstelle des Standardformulars (wenn dieser Parameter fehlt), das das Reservierungsformular auf planyo.com öffnet.

calclass - wenn gesetzt, wird das oberste div-Element im Kalender Iframe diesen Klassennamen enthalten. Auf diese Weise können Sie den Kalender je nach Standort unterschiedlich gestalten.

desktop=1 - verwenden Sie diesen Parameter, wenn Sie nicht möchten, dass planyo mobile Geräte erkennt und die Vorschau auf eine mobil-kompatible Version umschaltet (dies geschieht standardmäßig).

force-style=1 - verwenden Sie diesen Parameter, um den gewünschten Kalendertyp zu erzwingen, auch wenn er nicht mit dem Ressourcentyp kompatibel ist (tages- oder stundenbasiert).

min_hour=X, max_hour=Y - für stundenbasierte Ressourcen berechnet die Kalendervorschau automatisch die minimale und maximale Stunde, die in der Vorschau angezeigt wird, basierend auf Ihren Ressourceneinstellungen. Es ist möglich, sie mit diesen Parametern zu überschreiben, z.B. min_hour=8&max_hour=14 zeigt Zeiten von 8:00 bis 14:00 an.

Wenn Sie die Kalendervorschau nicht als separates Widget, sondern als Teil einer Vorlage (z.B. im Reservierungsformular oder in der Ressourcendetailansicht) anpassen möchten, können Sie den anpassbaren Tag $(calendar_preview_with_params?xxxx) verwenden, wobei xxxx eine Liste der obigen Parameter ist. Wenn Sie möchten, können Sie unter Einstellungen / Integration mit meiner Website / Widgets die Kalender-Builder-Benutzeroberfläche verwenden, um den genauen Wert des Tags zu erhalten, der dem gewählten Kalendertyp und den gewählten Einstellungen entspricht. Bitte beachten Sie, dass Sie in diesem Fall eventuell auch die Breite und Höhe der Kalendervorschau steuern müssen und somit die Parameter fixed_width und fixed_width verwenden können.

Beispiel: Im Reservierungsformular möchten Sie die 3-Monats-Kalendervorschau nur für die aktuelle Ressource anzeigen. Verwenden Sie einfach ein Tag wie:

$(calendar_preview_with_params?resource_id=$(resource_id)&style=multi-month&month-count=3&morning_icons=1)
FAQ