Buchungen mit WebBlocks Appointments annehmen

Dienste, Ressourcen, Öffnungszeiten und Buchungsregeln gehören zur Website, nicht zum einzelnen Formularblock. Zwei Buchungsseiten derselben Website verwenden dieselben Betriebsdaten. Eine andere Formularüberschrift ändert weder die Dienstdauer noch öffnet sie einen weiteren Kalender.

Appointments dient der Terminplanung. Diese Version nimmt keine Buchungszahlung an, erstellt keinen Meeting-Link und synchronisiert keinen Google- oder Outlook-Kalender des Operators. Bestätigungsmails können einen .ics-Kalenderanhang zum Import enthalten; das ist keine fortlaufende Synchronisierung eines externen Kalenders.

Memberships ist optional. Normale Gastbuchungen benötigen kein Konto. Ein eingeschränkter Dienst kann ein verifiziertes Mitglied oder ein bestimmtes aktives Paket verlangen, wie später beschrieben. Ein bezahlter Memberships-Anspruch kann dieses Paket bereitstellen; das Terminformular erhebt jedoch keine separate Buchungsgebühr.

Entwicklerrouten und den detaillierten Vertrag beschreibt die Appointments-Referenz. Diese Anleitung folgt dem aktuellen Panel und Besucherablauf.

Nutzen Sie zum Lernen eine Testwebsite und bereiten Sie vor:

• Eine funktionierende WebBlocks-CMS-Installation und ein Super admin-Konto für Installation und Einstellungen.
• Eine kompatible Version. Appointments 0.16.1 deklariert CMS ^1.99.0 und PHP >=8.3; der Katalog nennt Laravel 13. Beachten Sie das Kompatibilitätsergebnis Ihrer tatsächlichen Installation einschließlich der eigenen CMS-Anforderungen.
• Berechtigung zur Verwaltung von Terminen, Diensten und Öffnungszeiten der gewählten Website. Anzeigen, Verwalten und Einstellungen sind getrennte Rechte. Site Admin erhält standardmäßig die Ansichts-/Verwaltungsrollen des Plugins; das umfasst nicht automatisch Einstellungen.
• Korrekte Website-Zeitzone, kanonische Domain und echten CMS-Mailversand, bevor Besucher buchen dürfen.
• Einen Hosting-Administrator für die Einrichtung des Erinnerungsbefehls, wenn Sie Erinnerungen wünschen.

Prüfen Sie vor der Terminanlage unter Sites die Timezone. Dieses Beispiel nutzt Europe/Berlin. Öffentliche und manuell eingegebene Zeiten beziehen sich auf diese Website-Uhr; sie werden nicht automatisch in die Browserzeitzone des Besuchers umgerechnet. Nennen Sie die gültige Zeitzone insbesondere bei Fernberatungen.

Das Plugin ist im WebBlocks-Plugin-Katalog kostenlos aufgeführt. Für den Gastbuchungsteil sind weder Commerce noch Memberships erforderlich.

1. Öffnen Sie als Super admin System → Plugins.
2. Wählen Sie Browse Plugin Catalog und öffnen Sie WebBlocks Appointments.
3. Prüfen Sie Version, Kompatibilität und Versionshinweise.
4. Wählen Sie Install from Catalog, wenn die kompatible Version angeboten wird.
5. Wählen Sie in den Details des installierten Plugins Enable Plugin. Neue Pakete sind zur Prüfung zunächst deaktiviert.

Liefert der Administrator eine vertrauenswürdige Release-ZIP, verwenden Sie Plugin ZIP → Upload Plugin ZIP, prüfen und aktivieren sie. Für die Panelinstallation müssen Sie keinen Quellcode bauen. Aktuelle CMS-Versionen bereiten Datenbankänderungen bei Installation, Update und Aktivierung vor; beheben Sie Einrichtungsfehler vor dem Fortfahren.

Die Seitenleiste erhält eine Gruppe Appointments mit Appointments, Services, Staff & Rooms, Opening Hours und Settings. Nutzen Sie bei mehreren Websites die vorhandenen Website-Steuerelemente und prüfen Sie den Kontext vor Änderungen. Das öffentliche Formular verwendet die Website seiner Seite.

Plugin Health prüft Tabellen, aktive Dienste und Ressourcen, Zuordnungen, Öffnungszeiten, Empfänger, Mailversand und Erinnerungsplanung. Eine Warnung hilft bei der Einrichtung und ist keine Freigabe zum Ignorieren. Unsere Bilder nutzen einen nicht zustellenden lokalen Mailtransport; deshalb besteht trotz funktionierender Buchung berechtigter Handlungsbedarf.

Öffnen Sie Appointments → Staff & Rooms → Add staff or room.

1. Geben Sie Studio adviser unter Name ein.
2. Aktivieren Sie für das Beispiel Use as the default for new bookings.
3. Lassen Sie Active aktiviert.
4. Wählen Sie Save.

Eine Ressource kann einen Termin gleichzeitig übernehmen: eine Person, ein Beratungsplatz oder ein Raum. Legen Sie für jeden unabhängig buchbaren Kalender eine eigene Ressource an. Der Name „Sechserteam“ erzeugt keine sechs gleichzeitigen Plätze.

Die zweite Beispielressource Workshop room gehört zum separaten Dienst Studio room session. Eine Beraterbuchung reserviert diesen Raum nicht automatisch. Ein Termin hat eine Ressource; mehrere Dienstzuordnungen reservieren nicht gleichzeitig Mitarbeiter und Raum.

Ordnen Sie die Beratung für den einfachen Einstieg nur Studio adviser zu. Das öffentliche Formular verwendet in dieser Version die erste aktive zugeordnete Ressource, bevorzugt den Standard und danach die Sortierung. Es gibt weder eine Besucherauswahl des Mitarbeiters noch einen Pool, der die nächste freie Ressource probiert. Bei belegter Ressource wird nicht automatisch eine andere eingesetzt.

Öffnen Sie Appointments → Services → Add service und tragen Sie ein:

Wählen Sie Save. Prüfen Sie im Katalog Name, Dauer, Puffer, Ressource und Active-Status. Ein Dienst benötigt eine aktive zugeordnete Ressource mit passenden Öffnungszeiten, damit Zeiten angeboten werden.

Dauer und Startintervall unterscheiden sich. Ein 45-Minuten-Dienst muss nicht nur alle 45 Minuten beginnen. Sie wählen unter Settings ein 15-Minuten-Intervall, sodass 09:00, 09:15, 09:30 usw. möglich sind, sofern der vollständige Termin und Konfliktprüfungen es zulassen.

Eine Beratung 10:00–10:45 mit 15 Minuten Nachpuffer belegt den Berater bis 11:00. Der nächste Termin kann nicht um 10:45 beginnen. Auch frühere Startvorschläge entfallen, wenn deren Termin und Nachbereitung den reservierten Zeitraum überlappen würden.

Der Besuchertermin muss innerhalb eines Öffnungsfensters enden. Ein Puffer darf darüber hinausreichen: Nachbereitung kann nach einem Terminende um 17:00 noch nach Geschäftsschluss stattfinden. Muss sämtliche Arbeit zu einer festen Uhrzeit enden, berücksichtigen Sie das beim letzten buchbaren Fenster.

Öffnen Sie Appointments → Opening Hours, wählen Sie bei Staff or room den Studio adviser und anschließend Apply.

Wählen Sie unter Add hours einen Tag und tragen Sie Opens und Closes ein. Fügen Sie im Beispiel für Montag bis Freitag jeweils 09:00–17:00 hinzu. Speichern Sie jede Regel mit Add hours.

Das sind lokale Uhrzeiten der Website-Zeitzone. Legen Sie Regeln pro Ressource an; die Zeiten des Beraters gelten nicht automatisch für Workshop room.

Für eine Mittagspause verwenden Sie zwei Fenster am selben Tag, etwa 09:00–12:00 und 13:00–17:00, statt eines durchgehenden Fensters. Der Dienst muss vollständig in ein Fenster passen und kann keine Pause überbrücken. Vermeiden Sie überlappende Doppelregeln, die den Plan unübersichtlich machen.

Tage ohne Regel haben keine reguläre Öffnungszeit. Ein aktiver Dienst allein macht Abende und Wochenenden nicht buchbar.

Verwenden Sie in Opening Hours Add exception für einmalige Schließungen oder andere Zeiten. Im Beispiel schließt das Studio am 4. November 2026:

1. Setzen Sie Date auf diesen Tag.
2. Wählen Sie für dieses Beispiel mit einer Website unter Staff or room die Option Whole site.
3. Lassen Sie Closed aktiviert.
4. Tragen Sie Studio planning day unter Reason ein.
5. Wählen Sie Add exception.

Wählen Sie für eine Person oder einen Raum die konkrete Ressource statt Whole site. Für abweichende Öffnungszeiten deaktivieren Sie Closed und geben die ersetzenden Opens-/ Closes-Zeiten ein. Eine offene Ausnahme ersetzt die regulären Tageszeiten, statt eine zusätzliche Schicht anzuhängen. Eine passende Schließung hat Vorrang vor offenen Fenstern.

Bevor Sie bei mehreren Websites in 0.16.1 auf Whole site vertrauen, bevorzugen Sie ressourcenspezifische Ausnahmen und testen alle betroffenen Websites. Die Zeitsuche kann eine solche datierte Gesamtschließung auch außerhalb der vorgesehenen Website anwenden. Ressourcenspezifische Ausnahmen begrenzen das Beispiel auf die gewählte Ressource.

Öffnen Sie nach dem Speichern das Besucherformular für das Datum. Ein geschlossener Tag darf keine Zeiten anbieten. Prüfen Sie auch vorhandene Buchungen: geänderte Zeiten oder neue Schließungen stornieren keine bereits gespeicherten Termine. Kontaktieren Sie betroffene Kunden und bearbeiten Sie diese separat.

Öffnen Sie Appointments → Settings und verwenden Sie:

Wählen Sie Save. Die Regeln gelten pro Website. Änderungen beeinflussen künftige Verfügbarkeit und Anfragen; sie verschieben keine vorhandenen Termine und überschreiben keine ursprünglichen Kundendaten.

Pending bedeutet nicht freier Termin. Eine ausstehende Buchung hält Ressource und Zeit bereits wie eine bestätigte. Wählen Sie manuelle Bestätigung nur bei zeitnaher Bearbeitung. Automatische Bestätigung ändert den Anfangsstatus neuer Buchungen; sie bestätigt vorhandene Pending-Einträge nicht rückwirkend.

Ohne Plugin-Empfänger fällt Notification email auf die Kontaktadresse der Website und danach den konfigurierten Absender zurück. Eine Empfängeradresse richtet den Versand nicht ein; der CMS-Mailtransport muss ebenfalls funktionieren. Setzen Sie Reminder auf 0, wenn Sie bewusst keine Erinnerungen senden.

Erstellen Sie auf derselben Website einen Entwurf wie Book a studio visit oder eine gestufte Aktualisierung der vorhandenen Buchungsseite. Erläutern Sie kurz Dienst, Zeitzone und Ablauf nach einer Anfrage.

Im Main-Slot:

1. Wählen Sie Add Block und Appointment Form.
2. Öffnen Sie Block Fields.
3. Setzen Sie Heading auf Book your consultation.
4. Setzen Sie Intro text auf Choose a service and a date. Times are shown in the studio clock (Europe/Berlin).
5. Setzen Sie für manuelle Bestätigung Submit button label auf Request appointment.
6. Wählen Sie Save Block und öffnen Sie die Preview der gespeicherten Seite.

Diese Felder steuern den Text dieser Formularplatzierung. Dienstkatalog, Ressourcen und Öffnungszeiten stehen dort nicht. Sie benötigen weder Trusted HTML noch ein eingebettetes Fremdwidget oder separates Anbieterkonto.

Für weitere aktivierte Seitensprachen bearbeiten Sie den Formulartext im Blockeditor. Das Dienstformular hat in dieser Version nur ein Name-Feld; prüfen Sie die tatsächliche Besucherdarstellung, statt eine automatische Übersetzung der Dienste durch die Seitenübersetzung anzunehmen.

Die Sofortvorschau des Blockeditors unterstützt keine Plugin-Formulare. Speichern Sie und verwenden Sie die gespeicherte Seitenvorschau. Eine Buchung aus der Seitenvorschau erstellt einen echten Termin in dieser Installation. Lernen Sie mit fiktiven Daten auf einer Testwebsite und veröffentlichen Sie erst nach Prüfung von Ablauf und Mail.

Für die Bilder verwendet eine lokale Besucherseite das gespeicherte Formular. Öffnen Sie auf Ihrer Testwebsite Vorschau oder geprüfte Buchungsseite und wählen Sie:

• Service: Portfolio consultation.
• Date: einen zukünftigen offenen Tag innerhalb des Horizonts; im Beispiel 3. November 2026.
• Time: 10:00 in Europe/Berlin.

Mit JavaScript aktualisieren Dienst- oder Datumsänderungen die angebotenen Zeiten. Ohne JavaScript dient die serverseitige Schaltfläche Show available times als Rückfall. Der Server prüft Verfügbarkeit beim Absenden erneut; eine angezeigte Zeit wird während der Formulareingabe noch nicht reserviert.

Geben Sie Name und E-Mail ein, zum Beispiel Example visitor und visitor@example.test. Phone und Anything we should know? sind optional. Lassen Sie Phone im Beispiel leer und ergänzen Sie eine kurze fiktive Notiz. Verwenden Sie für echte Zustelltests eine kontrollierte Adresse.

Wählen Sie Request appointment einmal. Wurde die Zeit inzwischen belegt, wählen Sie einen neuen Vorschlag. Lassen Sie bei einem normalen menschlichen Test Zeit zum Ausfüllen; wiederholte sofortige automatisierte Posts sind kein Zustelltest.

Die Meldung lautet Your appointment is booked. Bei manueller Bestätigung bleibt der gespeicherte Status Pending. Die Meldung verwendet außerdem einen allgemeinen Text zum Mailversand; das beweist keine Zustellung. Unser lokaler Transport versendet nicht. Prüfen Sie anschließend den gespeicherten Termin und die getrennten Nachrichtenergebnisse.

Öffnen Sie Dienst und Datum erneut. Der ausstehende 10:00-Termin samt Puffer muss kollidierende Starts entfernen. Eine Schließung darf keine Zeiten anbieten. Verwenden Sie ein zum Testtag passendes Zukunftsdatum statt die Screenshot-Daten unbegrenzt zu wiederholen.

Öffnen Sie Appointments → Appointments. Diese Version zeigt standardmäßig Buchungen über alle Tage mit späteren Terminen zuerst, nicht nur heute. Grenzen Sie über Date, Status oder Search ein und wählen Sie Apply; Reset leert Filter.

Suchen Sie Example visitor am 3. November 2026, 10:00–10:45, zugeordnet zu Studio adviser. Die Website-Zeitzone steht bei der Überschrift; die Liste zeigt Dienst, Kundendaten, Status und getrennte Benachrichtigungsergebnisse.

Wählen Sie unter Actions die Stiftschaltfläche Edit status, im Dialog Confirmed und anschließend Save status.

Die wichtigsten Statuswerte:

Statusänderungen versenden die ursprünglichen Buchungsnachrichten nicht erneut. Benötigt Ihr Ablauf eine persönliche Zusage oder Änderungsmitteilung, kontaktieren Sie den Kunden über Ihren üblichen Kanal und prüfen das Ergebnis. Confirmed löst nicht automatisch eine neue Bestätigungsmail aus.

Die Liste bietet Statusbearbeitung, kein vollständiges Umplanungsformular. Vereinbaren Sie eine andere Zeit, stornieren Sie bewusst das Original und erstellen Sie eine neue Buchung. Prüfen Sie Nachrichten separat. Löschen Sie das Original nicht nur für eine aufgeräumte Liste: Löschen ist endgültig und verschickt keine Stornomitteilung.

Öffnen Sie Appointments → Appointments → Add appointment und wählen Sie:

1. Service: Portfolio consultation.
2. Staff or room: Studio adviser.
3. Date: denselben künftigen Testtag.
4. Time: 15:00 in der Website-Zeitzone.
5. Customer: Example phone booking.
6. Email: phone@example.test.
7. Optional eine Notiz zur Telefonanfrage.

Wählen Sie Save. Die Buchung trägt entered manually. Ohne automatische Bestätigung beginnt auch sie Pending; bestätigen Sie sie bei Bedarf mit Edit status.

Manuelle Eingabe prüft weiterhin Überschneidungen und Puffer. Sie überspringt bewusst öffentliche Öffnungszeiten-, Vorlauf- und Horizontprüfungen, damit Operatoren Ausnahmen treffen können. Prüfen Sie diese Regeln selbst, wählen Sie die richtige Ressource und betrachten Sie eine manuelle Buchung nicht als Nachweis öffentlicher Verfügbarkeit.

Nach dem Speichern versucht Appointments unabhängig zwei Nachrichten: Betriebsmitteilung und Besucherbestätigung. Die Bestätigung kann einen .ics-Anhang mit dem Termin enthalten. Besucher importieren ihn ohne Verbindung eines externen Kalenderkontos zum CMS.

Prüfen Sie Business notified und Visitor notified in der Zeile. Ein Fehler bedeutet nicht zwingend, dass beide scheiterten. Die Werte umfassen sent, failed, skipped und not configured. Sent bestätigt nur die Annahme durch den Transport, weder Lesen noch sicheren Posteingang.

Das Beispiel zeigt not configured, weil lokale Log-Mail verwendet wird. Bei Mailfehlern bleibt die Buchung gespeichert. Lassen Sie vor echten Einladungen CMS-Mail und Absender konfigurieren, die kanonische Domain prüfen und beide Empfänger sowie Kalenderanhang mit kontrollierten Postfächern testen.

Lassen Sie für Erinnerungen diesen Befehl planen:

Führen Sie ihn alle paar Minuten aus, etwa als Aufgabe im minütlich laufenden Laravel-Scheduler oder per Hosting-Cron. Ein laufender Host-Scheduler plant diesen Plugin-Befehl nicht automatisch ein. Fügen Sie die Aufgabe ausdrücklich hinzu. Plugin Health kann die tatsächliche Ausführung des Erinnerungs-Crons nicht prüfen; kontrollieren Sie sie auch beim Hosting/Scheduler.

Ein Administrator kann die fällige Menge ohne Versand prüfen:

Ersetzen Sie 1 durch die tatsächliche Website-ID. Bei 24 Stunden Vorlauf ist ein weiter entfernter Termin noch nicht fällig; ein leerer Probelauf kann korrekt sein. Die Ausgabe kann Besucheradressen enthalten und gehört in den privaten Operatorkontext.

Jeder geeignete zukünftige Termin wird einmal berücksichtigt. Auch bei Fehler oder fehlender Mailkonfiguration wird das Ergebnis erfasst; wiederholte Cron-Läufe sind kein automatischer Wiederholungsdienst. Stornierungen sind ausgeschlossen; Pending kann geeignet sein, weil es die Zeit weiterhin reserviert. Stimmen Sie das auf Ihren Freigabeablauf ab und testen Sie vor dem Betrieb.

Lassen Sie Let visitors cancel from their confirmation email aktiviert. Im echten Mailtest folgt der Besucher dem privaten Link aus Bestätigung oder Erinnerung. Die Bilder verwenden den eigenen Link der lokalen Buchung ohne Mailversand.

Das Öffnen zeigt nur eine Bestätigungsseite. Erst Cancel this appointment storniert. So kann ein Mailscanner durch bloßes Besuchen des Links keine unbeabsichtigte Stornierung auslösen.

Kehren Sie zur Operatorliste zurück. Der Eintrag zeigt Cancelled. Die frühere 10:00-Zeit sollte wieder verfügbar sein, sofern Dienst, Plan, Vorlauf und Horizont passen. Die separate Telefonbuchung um 15:00 bleibt unverändert.

Der Stornierungslink ist privater Zugang zu dieser Buchung. Veröffentlichen Sie ihn nicht auf Seiten, in Analysenotizen oder geteilten Screenshots. Die Stornierung lässt sich dort nicht rückgängig machen; erneutes Buchen ist eine separate Aktion. Bereits begonnene Termine können hier nicht storniert werden. Bei deaktivierter Online-Stornierung muss der Besucher den Betrieb kontaktieren.

Nach Speicherung der Besucherstornierung wird eine Betriebsmitteilung versucht. Ein Nachrichtenfehler stellt die Buchung nicht wieder her. Operator-Statusänderungen sind ein anderer Ablauf und senden diese Besucherstornomitteilung nicht automatisch.

Schließen Sie zuerst den Gastablauf ab. Installieren und aktivieren Sie für Mitgliederdienste eine kompatible Memberships-Version. Appointments 0.16.1 akzeptiert Memberships ^0.1 oder ^0.2. Bereiten Sie mit der Memberships-Anleitung verifizierte Konten, ein aktives Paket und eine aktuelle Vergabe oder bezahlte Berechtigung vor.

Im Diensteditor:

1. Erstellen oder öffnen Sie etwa Member portfolio review.
2. Ordnen Sie wie üblich aktive Ressource und Dauer zu.
3. Aktivieren Sie Verified members only für verifizierte Konten.
4. Wählen Sie bei Bedarf Workshop circle unter Required membership package.
5. Lassen Sie den Dienst aktiv und wählen Sie Save.

Auch ein Paket verlangt ein verifiziertes Mitglied; die Auswahl erlaubt keinen anonymen Zugang. Zeitsuche und Buchungsübermittlung prüfen beide die Berechtigung für die Website des Dienstes. Bei berechtigten angemeldeten Mitgliedern können Name und E-Mail vorausgefüllt werden; die Buchung behält neben dem Kundenschnappschuss die Mitgliedszuordnung.

Testen Sie abgemeldet, mit einem verifizierten Konto ohne Paket und mit aktuellem Paketinhaber. Eingeschränkte Dienste werden aus den Auswahlmöglichkeiten gefiltert; bleibt keiner übrig, meldet das Formular die erforderliche aktive Mitgliedschaft. Im Beispiel sehen Gäste normale Beratung und Raumdienste; das verifizierte Workshop-circle-Mitglied zusätzlich Member portfolio review.

Ohne verfügbares Memberships können Gastdienste weiter offen bleiben, eingeschränkte Dienste jedoch nicht. Spätere Änderungen einer Vergabe überschreiben keine historischen Kundendaten. Manuelle Operatorbuchungen bleiben möglich und sind als bewusste Operatorentscheidung statt als Besuchertest zu prüfen.

Deaktivieren Sie für eine Pause Active am Dienst oder an der Ressource. Dadurch werden vorhandene Termine nicht automatisch storniert; prüfen und bearbeiten Sie diese separat.

Das Löschen eines Dienstes oder einer Ressource mit Terminverlauf deaktiviert den Datensatz stattdessen. Dadurch bleiben Beziehungen zu früheren Buchungen erhalten. Ohne Historie ist Löschen möglich; prüfen Sie vor Bestätigung sorgfältig. Das Löschen eines Termins selbst entfernt seine Daten dauerhaft und verschickt keine Stornomitteilung.

Eine geänderte Dienstdauer verschiebt bestehende gespeicherte Start- und Endzeiten nicht. Pufferprüfungen verwenden aktuelle Dienstpuffer, sodass Änderungen benachbarte angebotene Zeiten beeinflussen können. Prüfen Sie danach den Kalender.

Halten Sie die Website-Zeitzone nach Buchungsstart stabil. Termine werden als UTC-Zeitpunkte gespeichert, Öffnungszeiten als lokale Uhrzeitregeln. Ein Zeitzonenwechsel kann Darstellung und künftige Verfügbarkeit ändern. Bei Sommerzeitwechseln entfallen nicht existierende Uhrzeiten; bei doppelten wird das frühere Auftreten gewählt. Testen Sie Übergangstage, falls Sie in diesen Stunden arbeiten.

Prüfen Sie Zeitzone, Zuordnungen, Ressourcenkapazität, Wochenstunden und Ausnahmen. Senden Sie eine normale Anfrage, finden Sie den Datensatz, kontrollieren Sie den Status und dass die belegte Zeit nicht weiter angeboten wird. Testen Sie manuelle Eingabe und Stornierung einschließlich der wieder freigegebenen Zeit.

Prüfen Sie anschließend echte Betriebs-/Besuchermails, Kalenderanhang und Erinnerungsaufgabe mit kontrollierten Konten. Testen Sie bei Memberships die passenden Mitgliedszustände. Prüfen Sie die Seite am Telefon, veröffentlichen Sie erst bei funktionierendem Ablauf und wiederholen Sie direkte Besuchertests auf der öffentlichen HTTPS-Website.

Weiter mit Appointments-Referenz, Memberships-Anleitung, Eine Seite veröffentlichen, Navigationsmenüs oder Rollen und Berechtigungen.