Contao · MIT-Lizenz

Terminbuchung für Contao.

Besucher wählen Tag und Uhrzeit und sind sofort gebucht, mit Bestätigung, Kalendereintrag und Absage-Link. Ohne fremdes Buchungsportal.

Version 0.1.0 vom 16.11.2026 · Contao 5.7.12 · PHP 8.3+

Installation

Aktualisiere Contao vor der Installation auf mindestens 5.7.12. Danach im Contao Manager nach nordwerk/contao-booking-bundle suchen oder composer require nordwerk/contao-booking-bundle ausführen und die Datenbank aktualisieren.

Im Contao Manager nach nordwerk/contao-booking-bundle suchen und das Paket installieren. Alternativ das Manager-ZIP aus den GitHub-Releases herunterladen und im Manager hochladen; anschließend die Datenbank aktualisieren.

Über Composer:

composer require nordwerk/contao-booking-bundle
vendor/bin/contao-console contao:migrate

Installationshinweise und Voraussetzungen stehen auch im README.

Was es kann

Besucher wählen auf deiner Website einen Tag im Monatskalender, dann eine Uhrzeit, füllen ein kurzes Formular aus und sind gebucht. Sie bekommen eine Bestätigung mit Kalendereintrag und einem Link zum Absagen, du bekommst eine Meldung. Die Buchung läuft auf deiner Seite, ohne fremdes Portal und ohne Gebühr pro Termin.

Buchbar ist nur, was wirklich frei ist: innerhalb deiner Zeitfenster je Wochentag, nach dem eingestellten Vorlauf, mit Puffer zu anderen Terminen und zu belegten Zeiten aus deinen Kalendern. Je Mailadresse sind höchstens drei künftige Termine möglich, dazu gibt es Grenzen je Tag und je IP-Adresse gegen einen zugebuchten Kalender. Kontaktdaten werden nach der Frist, die du einstellst, automatisch entfernt.

Das Bundle bringt eine schlichte Gestaltung mit, die Schrift und Farben deiner Website übernimmt. Wie die Buchung fertig gestaltet aussieht, zeigt die Live-Demo Studio Halm.

Erste Schritte im Backend

  1. Lege unter Inhalte → Terminbuchung eine Terminart an: Titel (etwa „Erstgespräch“), Name und E-Mail deines Betriebs, Dauer, Puffer, Vorlauf, Zeitraum, Zeitzone und die Zeitfenster je Wochentag (09:00–12:00, 14:00–17:00). Hake „Buchbar“ an.
  2. Füge auf der gewünschten Seite das Inhaltselement Terminbuchung ein und wähle Terminart und Datenschutzseite.
  3. Prüfe, dass Contao Mails versenden kann und unter System → Einstellungen eine Absenderadresse eingetragen ist. Antworten deiner Gäste landen bei der E-Mail des Betriebs.
  4. Optional: Trage die Abo-Adressen deiner Kalender ein, damit belegte Zeiten nicht buchbar sind, und Webhook-Adressen, wenn ein anderes System von Buchungen erfahren soll. „Testereignis senden“ prüft die Verbindung.

Anpassen

Das Template content_element/appointment_booking lässt sich im Template Studio überschreiben (Blöcke für Einleitung, Auswahl, Formular, Einwilligung und Bestätigung). Farben und Rundungen steuerst du über CSS-Variablen wie --booking-accent und --booking-radius; die Standardstile haben keine Spezifität, eigene Regeln greifen also ohne Tricks.

  • Verfügbar

    Widerrufsbutton

    Elektronische Widerrufsfunktion nach § 356a BGB, zweistufig, ohne Login und JavaScript. Läuft auch ohne unsere Pakete.

    Zum Paket

Häufige Fragen

Welche Contao-Version benötige ich?

Contao ab 5.7.12 innerhalb der 5.7-Reihe und PHP ab 8.3. Contao muss Mails versenden können, und der Contao-Cron sollte laufen: Er wiederholt gescheiterte Mails und Webhooks, liest Kalender-Abos neu und löscht Kontaktdaten nach der eingestellten Frist.

Muss ich Termine bestätigen?

Nein. Wer eine freie Zeit wählt, ist sofort gebucht und bekommt eine Bestätigung mit Kalendereintrag. Du bekommst eine Meldung per Mail. Absagen geht über den Link in der Bestätigung oder im Backend.

Wie verhindert das Paket Doppelbuchungen?

Gleichzeitige Anfragen für dieselbe Zeit werden nacheinander verarbeitet: Genau eine bekommt den Termin, die andere die Meldung, dass die Zeit gerade vergeben wurde. Dazu zählen Puffer zwischen Terminen und belegte Zeiten aus deinen Kalendern.

Berücksichtigt es meinen Outlook-, Google- oder iCloud-Kalender?

Ja, über die Abo-Adresse (ICS) des Kalenders. Belegte Zeiten daraus sind nicht buchbar. Ist ein Kalender kurz nicht erreichbar, blockiert das keine Buchung; es gelten die zuletzt gelesenen Zeiten, und der Fehler steht im Backend.

Kann ich Buchungen an ein anderes System weitergeben?

Ja. Je Terminart trägst du eine oder mehrere Webhook-Adressen ein. Bei „gebucht“ und „abgesagt“ geht eine signierte Nachricht nach dem Standard Webhooks raus, gescheiterte Zustellungen werden bis zu fünfmal wiederholt. Ob Kontaktdaten mitgehen, stellst du ein.

Welche Lizenz gilt und sind die Texte rechtlich geprüft?

Das Bundle steht unter der MIT-Lizenz und darf kommerziell eingesetzt werden. Einwilligungstext, Mailtexte und Datenschutzhinweise sind Vorschläge; prüfe sie vor dem Einsatz für deinen Betrieb.