Classic Bike Store

Demo des Plugins Digitalysator Booking Slots

Benutzerhandbuch

DIGITALYSATOR BOOKING SLOTS · DOKUMENTATION

Stabile Buchungsblöcke, verlässliche Verfügbarkeit und getrennte Miet- und Pufferzeiten für WooCommerce und PH Bookings.

Dieses Benutzerhandbuch beschreibt Version 0.1.14 (Vorabversion) für PH Bookings Premium 6.1.0. Grundlage ist die README des Plugins. Stand: 19. November 2026.

Funktion und Buchungsablauf

Digitalysator Booking Slots ist eine eigenständige Must-Use-Erweiterung für PH Bookings. Sie erhält das feste Raster der stunden- oder minutenbasierten Buchungsblöcke. Reservierte und durch Regeln gesperrte Blöcke bleiben im Raster sichtbar. Mietzeit und davor beziehungsweise danach benötigte Pufferzeit werden getrennt ausgewertet.

  1. Ein Buchungsprodukt öffnen und einen verfügbaren Tag auswählen. Ein Tag ohne möglichen Buchungsbeginn ist ausgegraut.
  2. Den Startblock und den letzten Mietblock wählen. Die Miete endet am Ende des letzten ausgewählten Blocks.
  3. Die angezeigte Dauer, den Preis und gegebenenfalls die Ressource prüfen und die Buchung in den Warenkorb legen.
  4. Beim Warenkorb und im Checkout erfolgt eine erneute serverseitige Prüfung. Eine zuvor angezeigte freie Zeit ist noch keine abgeschlossene Reservierung.

Die Erweiterung ersetzt weder WooCommerce noch PH Bookings. Preisregeln, Öffnungszeiten und grundlegende Produkteinstellungen stammen aus PH beziehungsweise WooCommerce.

Voraussetzungen und Installation

  • PHP ab 8.1, WordPress, WooCommerce und PH Bookings Premium 6.1.0.
  • Die PH-Verfügbarkeitstabelle muss bereits vorhanden sein. Das Datenbankkonto benötigt das Recht, die Archivspalte hinzuzufügen.
  • PH WooCommerce Product Addons ist optional. Fremdplugins sind nicht im Installationspaket enthalten. Andere PH-Versionen sind nicht als kompatibel bestätigt.
  1. Datenbank und vorhandene MU-Plugin-Dateien sichern; die Installation zuerst auf einer Testumgebung prüfen.
  2. Das Installationspaket digitalysator-booking-slots-0.1.14.zip aus dem Release verwenden. Das automatisch von GitHub erstellte Quellcodearchiv ist kein gleichwertiges Installationspaket.
  3. ZIP direkt nach wp-content/mu-plugins/ entpacken. Dort müssen die Datei digitalysator-booking-slots.php und daneben der Ordner digitalysator-booking-slots/ mit PHP-Dateien, JavaScript und Übersetzungen liegen.
  4. Unter Plugins → Must-Use den Eintrag „Digitalysator Booking Slots“ prüfen. WordPress lädt MU-Plugins automatisch; es gibt keinen Aktivieren-Knopf und keine Installation über den üblichen ZIP-Uploader.
  5. Die erfolgreiche Anlage der Archivspalte kontrollieren und die Einstellungen der betroffenen Buchungsprodukte prüfen.

Produkt konfigurieren

Unter Produkte → Produkt bearbeiten die PH-Buchungseinstellungen des Produkts öffnen. Die zusätzlichen Pufferfelder erscheinen direkt bei Pufferzeit / Buffer Time. Das Fragezeichen neben der Berechnung erklärt den Unterschied der Modi.

Einstellungen und Zuständigkeit
Einstellung Wirkung und Bedienung
Intervall und Zeiteinheit (PH) Stunden oder Minuten und die Länge eines Blocks festlegen, etwa vier Stunden. Das Raster übernimmt die von PH vorgegebenen Startpositionen.
Öffnungszeiten und Verfügbarkeitsregeln (PH) Erlaubte Startzeiten, Wochentage, Datumsregeln und gesperrte Zeiten definieren. Ein sichtbarer Randblock kann wegen seiner Endzeit oder einer Regel trotzdem gesperrt sein.
Mindestdauer, Buchungsvorlauf und Buchungsfenster (PH) Festlegen, wie lange und wie weit im Voraus gebucht werden darf. Diese Vorgaben wirken zusammen mit der Verfügbarkeitsprüfung.
Produktkapazität und Ressourcen (PH) Verfügbare Einheiten und gegebenenfalls gemeinsam genutzte Assets festlegen. Die Erweiterung berücksichtigt diese bei der Belegungsprüfung.
Pufferzeit / Buffer Time Aktivieren, wenn vor oder nach der Miete Zeit freigehalten werden soll. Ohne Pufferzeit wird kein zusätzlicher Puffer benötigt.
Pufferberechnung / Buffer calculation „Dauer (absolut) / Duration (absolute)“ oder „Anzahl Blöcke / Number of blocks“. Ohne gespeicherten Modus gilt absolute Dauer.
Dauer vor/nach der Miete (PH) Im absoluten Modus die bestehenden PH-Werte und deren Zeiteinheit verwenden. Beide Seiten getrennt einstellen.
Blöcke vor/nach der Miete Im Blockmodus die beiden zusätzlichen Ganzzahlfelder verwenden. Null bedeutet kein Puffer auf dieser Seite. Negative, gebrochene oder außerhalb des unterstützten Ganzzahlbereichs liegende Werte werden abgewiesen.
Überlappende Puffer erlauben / Allow overlapping buffers In beiden Modi verfügbar. Standardmäßig aktiviert. Bestimmt, ob reine Pufferzeiten zwischen Buchungen gemeinsam genutzt werden dürfen.

Das Produkt nach Änderungen speichern. Die Einstellung ist produktbezogen. Bestehende Buchungen behalten ihre gespeicherten Zeitgrenzen; neue Einstellungen berechnen alte Buchungen nicht rückwirkend um.

Praktischer Start: zuerst Intervall, Regeln und Kapazität festlegen; anschließend Puffer aktivieren, Modus und Werte wählen und die gemeinsame Nutzung festlegen. Danach einen freien Tag, einen belegten Tag und eine Buchung nahe der Schließzeit prüfen.

Puffer berechnen

Dauer (absolut)

Der Puffer läuft als verstrichene Zeit weiter – auch nachts, an Schließtagen und am Wochenende. Ein Puffertag bedeutet exakt 24 Stunden, auch bei einer Zeitumstellung. Die Werte stammen aus den vorhandenen PH-Feldern für Puffer vor und nach der Miete.

Anzahl Blöcke

Gezählt werden tatsächliche Positionen im Produktzeitplan. Durch Verfügbarkeitsregeln geschlossene Zeiten werden übersprungen. Bereits reservierte Blöcke zählen dagegen mit; sie werden nicht übersprungen. Die anschließende Konfliktprüfung entscheidet, ob die Belegung erlaubt ist.

Die Suche reicht höchstens 366 Kalendertage in jede Richtung. Das ist ein Suchhorizont, keine maximale Blockanzahl. Kann die gewünschte Anzahl darin nicht gefunden werden, ist der betroffene Buchungsbeginn nicht verfügbar.

Beispiel: acht Stunden oder zwei Blöcke?

Angenommen, nur die Blöcke 08–12, 12–16 und 16–20 Uhr sind buchbar. Die Miete dauert 16–20 Uhr, ohne Vorpuffer.

Nachpuffer Belegung bis Am Folgetag
8 Stunden absolut 04:00 Uhr 08–12 Uhr ist grundsätzlich wieder frei.
2 buchbare Blöcke 16:00 Uhr am Folgetag 08–12 und 12–16 Uhr sind Puffer; 16–20 Uhr ist grundsätzlich frei.

Ein Vorpuffer der nächsten Miete wird zusätzlich geprüft. Weitere Buchungen, Kapazitäten und Regeln können die Verfügbarkeit einschränken. Dieses Beispiel legt keine PH-Öffnungs- oder Randzeiten fest.

Die Logik dahinter

Acht Stunden sind nicht immer zwei Blöcke.

Dieses vereinfachte Beispiel hat drei buchbare Vierstundenblöcke pro Tag: 08–12, 12–16 und 16–20 Uhr. Eine Miete endet um 20 Uhr. Ein Puffer vor der Miete ist hier nicht eingestellt.

Puffer als absolute Dauer

Acht Stunden Nachlauf enden am Folgetag um 04 Uhr. Nächte, Schließzeiten und Wochenenden zählen mit. Um 08 Uhr kann die nächste Miete beginnen, sofern keine weiteren Regeln oder Belegungen entgegenstehen.

Tag 1 und die folgende Nacht

16–20 Uhr

Miete

20–04 Uhr

8 Stunden Puffer

04–08 Uhr

Geschlossen

Tag 2 · 08–12 Uhr

Wieder verfügbar

Puffer als Anzahl von Blöcken

Zwei Pufferblöcke zählen tatsächliche Positionen im Zeitplan. Regelbedingt geschlossene Zeiten werden übersprungen; bereits reservierte Blöcke werden mitgezählt. Im Beispiel sind deshalb die ersten beiden Blöcke am Folgetag Pufferzeit.

Vom letzten Mietblock bis zum nächsten buchbaren Start

Tag 1 · 16–20 Uhr

Miete

Tag 2 · 08–12 Uhr

Pufferblock 1

Tag 2 · 12–16 Uhr

Pufferblock 2

Tag 2 · 16–20 Uhr

Wieder verfügbar

Dürfen sich Puffer überschneiden?

Die Option „Puffer gemeinsam nutzen“ gibt es für beide Berechnungsarten. Hier benötigt jede Miete einen Block vor und nach der Mietzeit. Bei einer exklusiven Ressource mit Kapazität 1 ergibt sich:

Gemeinsame Puffer erlaubt: ein Zwischenblock genügt

08–12 Uhr

Miete A

12–16 Uhr

Nachlauf A + Vorlauf B

16–20 Uhr

Miete B

Getrennte Puffer: zwei Zwischenblöcke nötig

08–12 Uhr

Miete A

12–16 Uhr

Nachlauf A

16–20 Uhr

Vorlauf B

20–24 Uhr

Miete B

Schematische Beispiele, unabhängig von den Öffnungszeiten der Demo. Alle dargestellten Mietblöcke müssen im jeweiligen Zeitplan zulässig sein. Geteilte Puffer erlauben keine Überschneidung der Mietzeiten mit geschützter Belegung. Bei gemeinsam genutzten Ressourcen müssen beide Produkte die Pufferfreigabe erlauben.

Überlappende Puffer

Aktiviert: Reine Pufferzeiten aufeinanderfolgender Mieten dürfen gemeinsam genutzt werden. Bei je einem Vierstundenblock vor und nach jeder Miete kann ein freier Vierstundenblock zwischen zwei Mieten beide Pufferanforderungen erfüllen.

Deaktiviert: Die vollständigen Belegungsfenster einschließlich Puffer werden gegen die Kapazität geprüft. Bei je einem Vor- und Nachpufferblock werden zwischen den Mieten zwei getrennte freie Blöcke benötigt.

Für eine Ressource, die mehrere Produkte gemeinsam verwenden, müssen beide Produkte die gemeinsame Nutzung erlauben. Sonst gilt die strengere Einstellung. Die aktuellen Einstellungen aller beteiligten Produkte werden bei der Prüfung gelesen.

Die Option erhöht keine Kapazität. Bei einer exklusiven Ressource mit Kapazität eins darf die eigentliche Mietzeit weder eine andere Miete noch deren geschützte Pufferzeit überlappen. Beispiel: Miete 12–16 Uhr mit Puffer 08–12 und 16–20 Uhr; bei erlaubter Teilung können Mieten 04–08 und 20–24 Uhr diese reinen Puffer teilen, soweit der Zeitplan und andere Regeln das zulassen.

Kalender, Kapazität und Warenkorb

  • Kalender: Teilweise verfügbare Tage bleiben auswählbar. Tage ohne möglichen Start sind deaktiviert. Tooltips unterscheiden Mietbelegung von Pufferkonflikten; Statuswörter stehen nicht im Block selbst.
  • Kapazität: Aktive Warenkorbreservierungen zählen mit. Abgelaufene, freigegebene oder archivierte Reservierungen zählen nicht. Bei ausdrücklicher Ressourcenauswahl wird genau diese Ressource geprüft; die automatische Zuweisung kann eine andere geeignete freie Ressource nutzen.
  • Serverprüfung: Monatsverfügbarkeit, Hinzufügen zum Warenkorb und Checkout verwenden denselben Buchungsvalidator. Dieser berücksichtigt Regeln, aktuelle Zeit, Mindestdauer, Kapazitäten, Puffer und gemeinsame Ressourcen.
  • Warenkorb: Veraltete Konfigurationen, abgelaufene Reservierungen oder ungültige Ressourcenzuordnungen führen zur Entfernung der betroffenen Position. Die Reservierung wird archiviert und die Zeit muss neu gewählt werden. Rückgängig kann keine inkompatible Reservierung wiederbeleben.
  • Checkout: Klassischer Checkout und Store API prüfen unabhängig vor dem Speichern der Bestellung. Eigene Reservierungen werden nur für ihre eigene Prüfung ausgenommen; andere Warenkorbpositionen werden gemeinsam berücksichtigt. PH-Teilnehmerprüfungen und weitere WooCommerce-/Addons-Prüfungen bleiben beteiligt.

Die Navigation fasst identische Anfragen zusammen, verwirft veraltete Antworten und lädt höchstens eine Anfrage im Hintergrund voraus. Tages- und Monatsantworten werden im Browser höchstens drei Sekunden zwischengespeichert. Warenkorbänderungen und Rückkehr zum Tab leeren diesen Cache. Eine angezeigte Tagesantwort verwirft den betreffenden Monatscache. Der Browsercache autorisiert keine Buchung.

Es gibt keine Garantie für eine maximale Ladezeit von 1,5 Sekunden. Rechenzeit der Monatsprüfung und vollständige HTTP-Ladezeit sind unterschiedliche Messwerte.

Daten, Updates und Archivierung

Beim ersten Laden ergänzt das Plugin die bestehende PH-Tabelle {prefix}ph_bookings_availability_calculation_data um dbs_archived_at DATETIME NULL DEFAULT NULL. Das WordPress-Präfix bleibt unverändert. Ein leerer NULL-Wert bedeutet „nicht archiviert“, ein UTC-Zeitstempel kennzeichnet die Archivierung und schließt den Datensatz von aktiven Verfügbarkeitsprüfungen aus.

Die Initialisierung ist wiederholbar und schützt vorhandene Werte. Scheitert die Anlage, wird die Anfrage angehalten. Das Plugin legt die PH-Tabelle nicht selbst an, rekonstruiert keine historischen Bestände und löscht bei der Initialisierung keine Zeilen.

Erkannte PH-Löschvorgänge werden in Archiv- beziehungsweise Statusänderungen umgewandelt. Zugehörige Reservierungsposten und Metadaten bleiben erhalten; destruktive Komplettresets der Tabelle werden blockiert. Direkte Datenbankwartung außerhalb von WordPress ist davon nicht erfasst. Beim Wiederherstellen einer geeigneten Warenkorbposition entsteht eine neue Reservierung.

Bestehende Miet- und Puffergrenzen bleiben gespeichert. Sind historische Mietgrenzen nicht mehr rekonstruierbar, wird vorsichtshalber die gesamte gespeicherte Belegung berücksichtigt. Eine manuelle Massenmigration ist nicht erforderlich.

Versionswechsel

  • Von 0.1.10 auf 0.1.11 bleibt die neue Option für gemeinsame Puffer standardmäßig aktiv; für diesen Versionsschritt ist keine zusätzliche Schemaänderung erforderlich. Alte offene Adminformulare ohne das neue Feld überschreiben die Option nicht.
  • Von 0.1.9 oder älter: den neuen Standard prüfen. Für die frühere getrennte Pufferpolitik die Überlappung an den betreffenden Produkten ausschalten.
  • Änderungen der Pufferteilung fließen in die Konfigurationsprüfung vorhandener Warenkorbpositionen ein. Kunden müssen gegebenenfalls neu wählen.

Reservierungsschreibvorgänge und relevante Konfigurationsänderungen werden durch eine benannte Datenbanksperre serialisiert. Trotzdem sollten Updates zunächst mit den eigenen Produkten und Checkout-Abläufen getestet werden.

Besonderheiten dieser Demo

Der Classic Bike Store zeigt fiktive Fahrradprodukte. Seine Preis- und Abholregeln sind eine zusätzliche, standortspezifische Integration und werden vom allgemeinen MU-Plugin nicht automatisch installiert.

  • Vierstundenblöcke, maximal 84 Blöcke beziehungsweise 14 verstrichene Tage; Nächte zählen zur Mietdauer.
  • Grundgebühr 2 € und produktspezifische Blockpreise von 2 €, 3 €, 4 € beziehungsweise 6 €.
  • Native PH-Preisregel: von 7 bis 84 Blöcken werden Grund- und Blockpreis mit 0,8 multipliziert. Genau 24 Stunden haben keinen Rabatt; ab 28 Stunden greift diese Regel.
  • Abholung Mo–Sa 08–18 Uhr und Sonntag 08–16 Uhr; Rückgabeboxen ermöglichen Rückgaben außerhalb der Öffnungszeiten.
  • Konfiguriertes Buchungsfenster: 90 Tage im Voraus, acht Stunden Vorlauf.
  • Puffer sind produktbezogen. Für Classic Noir ist zuletzt ein Block vorher und zwei Blöcke danach mit erlaubter Pufferteilung dokumentiert. Andere Produkte behalten eigene Einstellungen.

Diese Angaben beschreiben die dokumentierte Demo-Konfiguration vom 19. November 2026. Maßgeblich für eine konkrete Auswahl sind Produktseite und Warenkorb. Die Demo enthält besondere Anpassungen; insbesondere die Durchsetzung von Vorlauf und Buchungsfenster in sämtlichen Schreibpfaden benötigt noch einen eigenen Regressionstest. Die Demo ist keine echte Vermietung. Bitte nur fiktive Angaben verwenden.

Details zur Trennung vom allgemeinen Plugin stehen im Classic-Bike-Beispiel.

Sprache, technische Optionen und Rückbau

Die neuen Pufferfelder und Meldungen verwenden englische Quelltexte und die Textdomain digitalysator-booking-slots. Deutsche PO-/MO-Dateien und eine POT-Vorlage sind enthalten. WordPress-Sprache beziehungsweise Benutzersprache wählen die Übersetzung; ältere Kalender- und Warenkorbmeldungen sind noch nicht vollständig internationalisiert.

Für Entwickler steht der Filter digitalysator_booking_slots_enabled zur Verfügung, um den Blockadapter produktbezogen abzuschalten. Der Schutz zur Datenaufbewahrung bleibt dabei aktiv. Der experimentelle REST-Transport ist standardmäßig deaktiviert; er ist keine reguläre Einstellungsoption dieser Anleitung. Eine eigene globale Einstellungsseite ist für die beschriebenen Produktoptionen nicht erforderlich.

Für einen vollständigen Rückbau die oberste MU-Ladedatei aus mu-plugins/ herausnehmen. Archivspalte und aufbewahrte Datensätze erhalten. Es gibt keinen automatischen Uninstaller zur Löschung der Historie. Ohne Loader arbeitet PH wieder nativ, einschließlich seiner eigenen Bereinigungslogik. Vor einem Rückbau eine Sicherung erstellen.

Eigener Laufzeitcode, JavaScript und Übersetzungen liegen im MU-Plugin; Einstellungen und Verfügbarkeitsdaten liegen in der WordPress-Datenbank. Die allgemeine Erweiterung verändert keine Herstellerdateien von PH, WooCommerce oder Product Addons.

Fehlersuche und Einsatzgrenzen

Die zusätzlichen Felder fehlen.
MU-Loader und Ordnerstruktur prüfen, PH-Buchungsprodukt öffnen und „Pufferzeit“ aktivieren. Im absoluten Modus erscheinen PH-Dauerfelder, im Blockmodus die zusätzlichen Blockzahlen.
Ein Tag oder Startblock ist gesperrt.
Öffnungszeiten, Rand-/Endzeiten, Mindestdauer, Vorlauf, Buchungsfenster, Kapazität, Ressourcen, aktive Reservierungen und beide Pufferseiten prüfen. Im Blockmodus auch den Suchhorizont von 366 Tagen beachten.
Puffer scheinen nicht geteilt zu werden.
Bei gemeinsamen Ressourcen die Option an beiden beteiligten Produkten prüfen. Teilbar sind reine Puffer, keine Mietzeit. Kapazitäten und weitere Regeln bleiben wirksam.
Eine Warenkorbposition verschwindet.
Die Reservierung kann abgelaufen, die Ressource ungültig oder die Produktkonfiguration verändert sein. Den Zeitraum erneut auswählen.
Nach Installation bricht die Anfrage ab.
Vorhandene PH-Verfügbarkeitstabelle und Datenbankrechte zum Anlegen der Archivspalte prüfen. Vor Arbeiten an der Datenbank sichern.

Der Release richtet sich an Stunden- und Minutenintervalle. Tages-/Monatsintervalle, wiederkehrende oder getrennte Mehrfachtermine, sämtliche Admin-Bearbeitungsdialoge, externe Kalendersynchronisation und echte Zahlungen sind nicht vollständig abgenommen. Nach Änderungen von PH an PHP-Verhalten oder Datenbankschema sind neue Kompatibilitätsprüfungen erforderlich.

Die README nennt für die Buchungsbasis 226 bestandene PHP-Prüfungen aus Version 0.1.12, elf Archiv-Initialisierungsprüfungen aus 0.1.13 und 24 Übersetzungsprüfungen aus 0.1.11. Dies ist keine vollständige Browser-Checkout-Abnahme für Version 0.1.14 oder beliebige Produktkombinationen.

Digitalysator Booking Slots ist eine unabhängige Erweiterung unter GPL-2.0-or-later und kein offizielles PluginHive- oder WooCommerce-Produkt. Weiterführend: README und Änderungsprotokoll.

DEMO · Keine echte Vermietung · Keine Zahlung · Kein E-Mail-Versand