🎾 Tennisplatz-Reservierung Pro

🎾 Übersicht

Tennisplatz-Reservierung Pro ist ein WordPress-Plugin für die Online-Buchung von Tennisplätzen direkt auf deiner Vereins- oder Club-Website. Eingeloggte Mitglieder buchen selbst, der Administrator behält die volle Kontrolle.

Shortcodes

Shortcode	Beschreibung
[tennis_booking]	Buchungskalender (Hauptansicht)
[tennis_booking start_hour="8" end_hour="22" view="week"]	Mit eigenen Startzeiten und Wochenansicht
[tennis_my_bookings]	„Meine Buchungen" des eingeloggten Nutzers

📦 Installation & Lizenz

Plugin installieren

1. ZIP-Datei tennis-pro-8.0.0.zip über WordPress-Backend → Plugins → Installieren → ZIP hochladen hochladen
2. Auf „Jetzt installieren" klicken – WordPress entpackt das Plugin automatisch
3. Auf „Plugin aktivieren" klicken
4. Das Plugin erstellt beim ersten Aktivieren alle benötigten Datenbanktabellen automatisch

Lizenz aktivieren

1. Gehe zu Tennis Pro → Einstellungen → System
2. Trage deinen Lizenzschlüssel in das Feld „Lizenzschlüssel" ein
3. Klicke auf „Lizenz aktivieren"
4. Der Status wechselt auf ✅ Aktiv

Updates einspielen

1. Gehe zu Tennis Pro → Einstellungen → System → Update-Prüfung
2. Klicke auf „Auf Updates prüfen" – der Server wird direkt abgefragt
3. Falls ein Update verfügbar ist, erscheint eine Meldung mit Versionsnummer
4. Das Update kann dann über WordPress → Plugins → Verfügbare Updates eingespielt werden

🚀 Erste Schritte

Empfohlene Reihenfolge für die Einrichtung eines neuen Systems:

1. Plätze anlegen – mindestens einen Platz unter Tennis Pro → Plätze erstellen
2. Kategorien anlegen – z.B. „Freies Training", „Vereinstraining", „Turnier" unter Tennis Pro → Kategorien
3. Buchungsregeln festlegen – Öffnungszeiten, Buchungslimit, Stornierungsfrist unter Tennis Pro → Einstellungen
4. E-Mail konfigurieren – Absender-Adresse und ggf. SMTP einstellen
5. Shortcode einfügen – [tennis_booking] auf einer Seite platzieren
6. Testbuchung – als Nutzer einloggen und eine Buchung vornehmen

🎾 Plätze verwalten

Unter Tennis Pro → Plätze werden alle buchbaren Plätze angelegt und verwaltet.

Platz anlegen

Feld	Beschreibung
Name	Anzeigename, z.B. „Platz 1", „Außenplatz Nord"
Farbe (Text)	Textfarbe für die Zellendarstellung im Grid (HEX)
Hintergrundfarbe	Hintergrundfarbe für die gebuchten Zellen (HEX)
Reihenfolge	Sortierung im Frontend – niedrigere Zahl = weiter links

Platz bearbeiten / löschen

Bestehende Plätze können jederzeit umbenannt, umgefärbt oder gelöscht werden. Achtung: Beim Löschen eines Platzes werden alle zugehörigen Buchungen ebenfalls gelöscht.

🏷 Kategorien

Kategorien gruppieren Buchungsarten und steuern die Farbanzeige im Kalender. Erreichbar unter Tennis Pro → Kategorien.

Feld	Beschreibung
Name	Anzeigename, z.B. „Freies Training", „Vereinstraining"
Hintergrundfarbe	Farbe der gebuchten Zelle für diese Kategorie
Textfarbe	Schriftfarbe in der Zelle
Nur Admin Admin	Wenn aktiviert, kann diese Kategorie ausschließlich von Tennisplatz-Admins gebucht werden – auch dann, wenn zusätzlich „🎓 Trainer" aktiviert ist
🎓 Trainer	Macht die Kategorie zusätzlich für alle Mitglieder mit der Rolle „Trainer" sichtbar (zusätzlich zu Tennisplatz-Admins). Buchungen werden automatisch als „Training – <Trainername>" beschriftet (siehe Abschnitt „Trainer-Rolle & Training mit Gast")
🎾 Gastspieler	Markiert die Kategorie als Gastspieler-Kategorie → löst Gebühr, Gastname-Feld und Benachrichtigungen aus (siehe Abschnitt „Gastspieler & Gebühr")
🎓 Training mit Gast	Markiert die Kategorie als „Training mit Gast" → für Trainer erscheint ein Gastname-Feld, die Buchung wird als „Training – <Trainername> / Gast: <Name>" angezeigt und es greift die eigene Gebühr/Benachrichtigung (siehe Abschnitt „Trainer-Rolle & Training mit Gast")
🔒 Namen	Steuert, wer die Namen der Buchenden (Spieler/Gast) im Frontend sehen darf. Trainer-Namen bleiben immer sichtbar. Stufen: alle sehen (Standard) · nur eingeloggte (Gäste sehen nur „Belegt") · nur Trainer+Admin · nur Admin. Empfehlung: „Freies Training" → nur eingeloggte; Trainings-Kategorien mit öffentlichem Trainer-Namen → Stufe 0.

Gastspieler-Kategorie

Ist eine Kategorie als „🎾 Gastspieler" markiert, erscheint beim Buchen automatisch ein Feld für den Namen des Gastes, und – sofern die Gebührenfunktion aktiv ist – wird die Gastgebühr berechnet und per E-Mail mitgeteilt. Details im Abschnitt Gastspieler & Gebühr.

👤 Trainer (Zuordnung zu Buchungen)

Trainer werden unter Tennis Pro → Trainer verwaltet und können einzelnen Buchungen zugewiesen werden. Diese Zuordnung ist nur für Administratoren sichtbar und unabhängig von der Trainer-Benutzerrolle (siehe nächster Abschnitt).

Feld	Beschreibung
Name	Name des Trainers, erscheint in der Buchungszelle
Reihenfolge	Sortierung im Auswahl-Dropdown
Verknüpfter Benutzer	Optional: ein Benutzerkonto mit der Rolle „🎓 Trainer", das mit diesem Trainer-Eintrag verknüpft wird (siehe unten)

Beim Anlegen oder Bearbeiten einer Buchung kann (nur durch Admins) ein Trainer aus dieser Liste ausgewählt werden. Der Name wird dann in der Buchungszelle im Frontend angezeigt 👤 Max Mustermann.

Trainer-Eintrag mit Benutzerkonto verknüpfen

Jeder Trainer-Eintrag in dieser Liste kann optional mit einem Benutzerkonto verknüpft werden, das die Rolle „🎓 Trainer" besitzt. Dazu steht hinter jedem Trainer-Eintrag ein Auswahlfeld „– kein Benutzer verknüpft –" zur Verfügung, in dem alle Benutzer mit der Trainer-Rolle aufgelistet werden. Nach Auswahl mit „💾 Speichern" bestätigen.

Legt ein Admin anschließend eine Buchung an oder bearbeitet sie und wählt bei „Trainer (optional)" diesen Eintrag aus (z. B. Training mit Alex L.), kann der verknüpfte Benutzer diese Buchung im Frontend selbst bearbeiten und stornieren – genau wie eine eigene Buchung. Andere Trainer (z. B. „Gunther"), deren Benutzerkonto mit einem anderen Trainer-Eintrag verknüpft ist oder gar keiner Verknüpfung zugeordnet ist, sehen diese Buchung weiterhin nur, können sie aber nicht bearbeiten.

🎓 Trainer-Rolle & „Training mit Gast"

Mitglieder, die selbst Trainingseinheiten anbieten (z. B. Vereins- oder Jugendtraining), erhalten die eigene Tennis-Rolle „🎓 Trainer". Trainer sehen beim Buchen zusätzlich alle als „🎓 Trainer" markierten Kategorien – Buchungen in diesen Kategorien werden automatisch mit ihrem Namen beschriftet, ganz ohne manuelle Eingabe. Außerdem dürfen Trainer – anders als normale Mitglieder – Serien-Buchungen anlegen (siehe Abschnitt 🔁 Serien-Buchungen).

Einrichtung in 2 Schritten

1. Mitglied zum Trainer machen: In der Benutzerverwaltung (Tennis Pro → Benutzer) bei der betreffenden Person im Dropdown „Rolle ändern" „🎓 Trainer" auswählen und speichern.
2. Kategorien für Trainer freigeben: Unter Tennis Pro → Kategorien bei den gewünschten Trainingsformen (z. B. „Vereinstraining", „Jugendtraining") die Checkbox „🎓 Trainer" aktivieren. Optional zusätzlich „🎓 Training mit Gast" aktivieren und unter Tennis Pro → Einstellungen → Buchung → Training mit Gast Gebühr, Währung und verantwortliche E-Mail festlegen.

Wie eine Trainer-Buchung abläuft

Ein Mitglied mit der Rolle „Trainer" sieht im Buchungs-Popup zusätzlich alle Kategorien, bei denen „🎓 Trainer" aktiviert ist.

• Freies Training / normale Kategorie: Bucht der Trainer eine Kategorie ohne „🎓 Trainer"-Markierung (z. B. „Freies Training"), läuft die Buchung wie bei jedem anderen Mitglied – sein eigener Name wird wie gewohnt eingetragen.
• Als „🎓 Trainer" markierte Kategorie (z. B. „Vereinstraining"): Im Popup erscheint der Hinweis „Diese Buchung wird automatisch als „Training – <Name>" angezeigt." Der Anzeigename wird automatisch auf Training – Max Mustermann gesetzt. Ein zusätzlicher Eintrag im Feld „Name / Kommentar" wird in Klammern angehängt, z.B. Training – Max Mustermann (Gruppe A).
• „Training mit Gast"-Kategorie: Zusätzlich erscheint das Gastname-Feld. Der eingetragene Gastname wird angehängt: Training – Max Mustermann / Gast: Erika Musterfrau.

„Training mit Gast" – Gebühr & Benachrichtigung

Analog zur regulären Gastspieler-Gebühr lässt sich für „Training mit Gast" eine eigene Gebühr mit eigener Währung und eigenem Empfänger hinterlegen – unabhängig von den normalen Gastspieler-Einstellungen. Erreichbar unter Tennis Pro → Einstellungen → Buchung → Training mit Gast.

Einstellung	Beschreibung
Funktion aktiv	Schaltet Gebühr & Benachrichtigung für „Training mit Gast" ein/aus
Betrag pro Stunde	Eigener Stundensatz + Währung für Training mit Gast. Wird anteilig nach Dauer berechnet
Verantwortliche E-Mail	Erhält jede „Training mit Gast"-Buchung mit fälligem Betrag (kassiert) – kann von der Gastspieler-E-Mail abweichen

Was automatisch passiert

Ereignis	Trainer	Verantwortliche/r
Anlegen	Bestätigungs-Mail (mit iCal-Termin und fälligem Betrag, falls „Training mit Gast")	E-Mail mit Gastname, Termin & einzuziehendem Betrag
Ändern (Zeit/Dauer/Kategorie)	Änderungs-Mail mit aktueller Gebühr (+ aktualisiertem iCal)	E-Mail mit neuem Betrag bzw. „Gebühr entfällt"
Stornieren	Storno-Mail mit Hinweis „Gebühr wird nicht fällig"	Storno-Mail „Gebühr entfällt"

🔧 Equipment

Equipment (z.B. Ballmaschinen, Ballkörbe) kann unter Tennis Pro → Einstellungen → Equipment verwaltet und beim Buchen optional hinzugebucht werden.

Feld	Beschreibung
Name	Bezeichnung, z.B. „Ballmaschine", „Ballkorb"
Beschreibung	Optionale Zusatzinfo (intern, wird nicht im Frontend angezeigt)
Anzahl	Wie viele Einheiten davon vorhanden sind (z.B. 2 Ballmaschinen)
Reihenfolge	Sortierung im Buchungs-Popup

Wie Equipment funktioniert

• Beim Buchen erscheint eine optionale Checkbox-Liste mit verfügbarem Equipment
• Bereits gebuchtes Equipment wird ausgegraut und kann nicht doppelt gebucht werden – platzübergreifend
• Gebuchtes Equipment erscheint in der Buchungszelle als 🎾 Ballmaschine
• Bei der Buchungsbearbeitung kann Equipment hinzugefügt oder entfernt werden

📅 Buchungsregeln

Erreichbar unter Tennis Pro → Einstellungen → Buchungsregeln.

Einstellung	Beschreibung
Buchungslimit	Max. Buchungen pro Nutzer pro Tag oder Woche (0 = unbegrenzt)
Buchungshorizont	Wie viele Tage im Voraus gebucht werden darf (0 = unbegrenzt)
Stornierungsfrist	Bis wie viele Stunden vor dem Termin storniert werden darf (0 = keine Frist)
Mindest-Vorlaufzeit	Mindestzeit in Stunden vor einem Termin für neue Buchungen
Meine Buchungen: Bearbeiten	Erlaubt Nutzern das Bearbeiten und Stornieren eigener Buchungen aus „Meine Buchungen" heraus

Tages- / Wochenansicht

Einstellung	Beschreibung
Startzeit	Erste angezeigte Uhrzeit im Kalender (z.B. 08:00)
Endzeit	Letzte angezeigte Uhrzeit (z.B. 22:00)
Monatsansicht	Aktiviert eine zusätzliche Monatsübersicht im Frontend
Wochenansicht	Wechsel zwischen Tages- und Wochenansicht im Frontend

🎾 Gastspieler & Gebühr

Spielt ein Mitglied mit einem vereinsfremden Gast, kann dafür automatisch eine Gebühr berechnet und per E-Mail mitgeteilt werden – an das buchende Mitglied und an die verantwortliche Person (z. B. Kassenwart), die das Geld eintreibt.

Einrichtung in 2 Schritten

1. Kategorie markieren: Unter Tennis Pro → Plätze & Kategorien bei der gewünschten Kategorie (z. B. „Spiel mit Gast") die Checkbox „🎾 Gastspieler" aktivieren.
2. Gebühr & Empfänger festlegen: Unter Tennis Pro → Einstellungen → Buchung → Gastspieler die Werte eintragen.

Einstellung	Beschreibung
Funktion aktiv	Schaltet Gebühr & Benachrichtigung ein/aus
Betrag pro Stunde	Stundensatz + Währung. Wird anteilig nach Dauer berechnet
Verantwortliche E-Mail	Erhält jede Gastbuchung mit fälligem Betrag (kassiert)

Was automatisch passiert

Über den gesamten Lebenszyklus einer Gastbuchung werden Mitglied und verantwortliche Person per E-Mail auf dem Laufenden gehalten:

Ereignis	Mitglied	Verantwortliche/r
Anlegen	Popup-Hinweis + eine Bestätigungs-Mail (mit iCal-Termin und fälligem Betrag)	E-Mail mit Gastname, Termin & einzuziehendem Betrag
Ändern (Zeit/Dauer)	Änderungs-Mail mit aktueller Gebühr (+ aktualisiertem iCal)	E-Mail „Gastspieler-Buchung geändert" mit neuem Betrag
Kategorie → Gast	Hinweis: jetzt Gastgebühr fällig	E-Mail mit einzuziehendem Betrag
Kategorie Gast → normal	Hinweis: keine Gastgebühr mehr	E-Mail „Gebühr entfällt"
Stornieren	Storno-Mail mit Hinweis „Gebühr wird nicht fällig"	Storno-Mail „Gebühr entfällt"

👥 Passiv-Mitglieder

Passiv-Mitglieder können in der Anzahl ihrer Buchungen pro Kalenderjahr begrenzt werden – oder ganz vom Buchen ausgeschlossen werden.

Einrichtung in 2 Schritten

1. Funktion & Limit festlegen: Unter Tennis Pro → Einstellungen → Buchung → Passiv-Mitglieder die Funktion aktivieren und die erlaubten Buchungen pro Jahr eintragen.
2. Mitglieder markieren: In der Benutzerverwaltung bei den betreffenden Personen die Checkbox „Passiv" setzen (speichert sofort).

Einstellung	Beschreibung
Funktion aktiv	Extra-Schalter: ohne Aktivierung buchen Passiv-Mitglieder wie normale Mitglieder
Buchungen pro Jahr	Max. Anzahl pro Kalenderjahr. 0 = darf gar nicht buchen

✉️ E-Mail & SMTP

Erreichbar unter Tennis Pro → Einstellungen → E-Mail.

Allgemeine E-Mail-Einstellungen

Einstellung	Beschreibung
E-Mail-Benachrichtigungen	Aktiviert/deaktiviert alle automatischen E-Mails
Absendername	Name des Absenders (z.B. „TC Kirrweiler")
Absender-E-Mail	Absenderadresse (sollte zur Domain passen)
Admin-Benachrichtigung	Admin erhält bei jeder neuen Buchung eine E-Mail
Admin-E-Mail	Empfänger-Adresse für Admin-Benachrichtigungen

SMTP konfigurieren (optional)

Für zuverlässigen E-Mail-Versand empfiehlt sich ein eigener SMTP-Server statt des Standard-WordPress-Versands.

Einstellung	Beispielwert
SMTP aktivieren	Ja
SMTP-Server	mail.cco-it.de
SMTP-Port	587 (STARTTLS) oder 465 (SSL/TLS)
Verschlüsselung	STARTTLS (empfohlen) oder SSL/TLS
SMTP-Benutzer	buchung@cco-it.de
SMTP-Passwort	Wird verschlüsselt gespeichert, nie exportiert
Verbindungs-Timeout	20 Sekunden (5–60) – höher setzen, wenn der Server langsam antwortet
SSL-Zertifikat-Prüfung deaktivieren	Nur als Notlösung, wenn der Hoster veraltete CA-Zertifikate hat. Nicht für Produktivbetrieb.

Microsoft 365 / Outlook

Für ein Microsoft-365-Postfach gelten zusätzliche Voraussetzungen:

Einstellung	Wert
SMTP-Server	smtp.office365.com
Port / Verschlüsselung	587 / STARTTLS
Benutzer	Vollständige M365-E-Mail-Adresse
Passwort	Ein App-Passwort (nicht das normale Kontopasswort)

Wichtig: Geblockte Ports beim Hoster

• SMTP des eigenen Hosters nutzen – z.B. ein Postfach beim selben Anbieter (Strato → smtp.strato.de). Funktioniert immer, Absender muss eine Adresse dieses Anbieters sein.
• SMTP deaktivieren – WordPress versendet dann über den lokalen Server-Mailer (ausreichend für kleine Vereine).
• Externer Relay-Dienst – z.B. Brevo/SendGrid über Port 2525 (meist nicht geblockt).

🎨 Design & Corporate Identity

Unter Tennis Pro → Einstellungen → Design lässt sich das Frontend an das Corporate Design anpassen.

🗓 Kalender-Stil: Klassisch vs. Modern

Unter Tennis Pro → Einstellungen → Design → Kalender-Stil lässt sich das Erscheinungsbild und Verhalten des Buchungsrasters global umschalten.

Zusatzfunktionen im Modern-Stil

• Ziehen-zum-Buchen: Mit gedrückter Maustaste über mehrere freie, zusammenhängende Slots nach unten ziehen, um die Dauer direkt festzulegen. Beim Loslassen öffnet sich das Buchungs-Popup mit der vorausgewählten Dauer.
• Auswahl-Hervorhebung: Die markierten Slots werden während des Ziehens grün umrandet angezeigt; belegte/gesperrte Slots beenden die Auswahl automatisch.
• Buchungs-Bestätigung: Eine frisch gebuchte Zelle leuchtet kurz grün auf.

📱 Progressive Web App (PWA)

Die App-Ansicht verwandelt das Buchungssystem in eine vollbildfüllende Web-App – ähnlich einer nativen App auf dem Smartphone oder Tablet. Der Buchungskalender ist direkt nach dem Aufruf sichtbar, auch ohne Login. Eingeloggte Mitglieder können direkt buchen; ein Rück-Menü führt zur Kachelseite mit weiteren Funktionen.

Seite einrichten

1. Gehe zu WordPress → Seiten → Erstellen
2. Gib der Seite einen Namen, z.B. „Tennisplatz App"
3. Wähle in den Seiten-Attributen (rechte Spalte) unter „Template" den Eintrag „Tennis Pro – App-Ansicht"
4. Wähle einen Slug, z.B. webapp – die App ist dann unter /webapp/ erreichbar
5. Seite veröffentlichen
6. URL ans Vereins-Handy oder als Link auf der Website teilen

Einstellungen: PWA-Tab

Alle Anpassungen für die App-Ansicht befinden sich unter Tennis Pro → Einstellungen → Progressive Web App.

Einstellung	Beschreibung
App-Name	Name der App – wird im Kopfbereich und im Browser-Tab angezeigt (z.B. „TC Kirrweiler – Platzreservierung")
App-Hintergrundfarbe	Hintergrundfarbe der gesamten App (Standard: dunkles Grün)
Kachel-Hintergrundfarbe	Farbe der Navigations-Kacheln auf der Menüseite
Kacheltext-Farbe	Farbe für Beschriftung und Icon auf den Kacheln – wird automatisch auch auf SVG-Icons angewendet
Überschrift-/Begrüßungsfarbe	Farbe des App-Titels und Begrüßungstexts auf der Kachelseite – unabhängig von der Kacheltext-Farbe einstellbar
App-Logo	Vereinslogo für die Kachelseite – Upload über die WP-Mediathek. Empfohlene Größe: 200 × 100 px (Querformat)
Vereins-Website-URL	URL für die Kachel „Zur Website" auf der Kachelseite
Website-Beschriftung	Beschriftung der Website-Kachel (Standard: „TCK Website")
Impressum-URL	Link zum Impressum – wahlweise als eigene Kachel oder Fußzeilen-Link
Impressum als Kachel	Impressum als reguläre Navigations-Kachel anzeigen statt nur im Footer
Registrierungs-Seite	Seiten-URL für den „Registrieren"-Button im Gast-Kopfbereich
Theme-Farbe (Statusleiste)	Farbe der Browser-Statusleiste auf Mobilgeräten (Chrome/Android)

Aufbau der App

Die App besteht aus vier Bildschirmen, die animiert ineinander überblenden:

Gast-Ansicht (nicht eingeloggt)

Besucher, die nicht eingeloggt sind, sehen sofort den Buchungskalender – jedoch ohne Buchungsfunktion. Der Kalender ist lesend, belegte Slots sind sichtbar. Im Kopfbereich erscheinen die Buttons:

• Anmelden – öffnet den In-App-Login-Bildschirm
• Registrieren – führt zur konfigurierten Registrierungs-Seite (falls hinterlegt)

Eingeloggte-Ansicht

Nach dem Login erscheint der Buchungskalender mit vollem Buchungszugriff. Im Kopfbereich sind drei Elemente sichtbar:

• ≡ Menü (links) – wechselt zur Kachelseite mit allen Navigationsmöglichkeiten
• App-Name (Mitte) – zeigt den konfigurierten Namen
• Abmelden (rechts) – schneller Logout direkt aus dem Kalender, ohne Umweg über die Kachelseite

Kachelseite (Menü)

Die Kachelseite ist das zentrale Navigationsmenü für eingeloggte Nutzer. Sie ist erreichbar über den ≡ Menü-Button im Kalender-Kopfbereich. Von hier aus zurück zum Kalender über den ‹ Kalender-Button oben links.

Folgende Kacheln sind verfügbar:

Kachel	Funktion
🎾 Platz buchen	Wechselt direkt zum Buchungskalender
📋 Meine Buchungen	Öffnet die Liste der eigenen Reservierungen
👤 Profil	Link zur WordPress-Profilseite des Nutzers
🌐 Website	Öffnet die konfigurierte Vereins-Website (externer Link)
📄 Impressum	Nur wenn „Impressum als Kachel" aktiviert ist
🔓 Abmelden	Logout des aktuellen Nutzers

Als App installieren (Add to Home Screen)

Die App-Ansicht kann auf Mobilgeräten und Desktops als eigenständige App installiert werden:

Scrollverhalten des Buchungsrasters

In der PWA-Ansicht übernimmt der App-Bildschirm selbst das Scrollen – nicht eine Scroll-Box innerhalb des Rasters. Das bedeutet:

• Horizontal scrollen: Nach rechts wischen/scrollen um weitere Plätze zu sehen (auch bei 4+ Plätzen auf kleineren Bildschirmen)
• Vertikal scrollen: Nach unten wischen/scrollen für frühere oder spätere Uhrzeiten
• Die Scrollleisten befinden sich am Bildschirmrand – optimal erreichbar auf Touch-Geräten und Desktop

⚙️ System-Einstellungen

Unter Tennis Pro → Einstellungen → System befinden sich erweiterte Einstellungen.

Einstellung	Beschreibung
Login-Seite	Eigene Login-Seite statt wp-login.php nutzen
Registrierung	Selbstregistrierung für neue Mitglieder aktivieren
Datenschutz-Seite	Seiten-ID für den Datenschutz-Link beim Registrieren
Selbstlöschung	Nutzern erlauben, ihr Konto selbst zu löschen
Daten bei Deinstallation	Alle Tabellen und Optionen beim Löschen des Plugins entfernen
Update-Prüfung	Manueller Check ob eine neue Plugin-Version verfügbar ist

📌 Buchung im Frontend

Das Buchungs-Frontend wird per Shortcode [tennis_booking] auf einer Seite eingebunden. Nur eingeloggte Nutzer können buchen.

Buchungsvorgang

1. Nutzer klickt auf einen freien Zeitslot im Kalender
2. Das Buchungs-Popup öffnet sich mit vorausgefülltem Datum und Uhrzeit
3. Nutzer wählt Dauer, Kategorie und optionalen Namen/Kommentar
4. Optional: Equipment anwählen (falls vorhanden und verfügbar)
5. Klick auf „Buchen" → Buchung wird gespeichert, E-Mail wird versendet
6. Die Zelle wechselt sofort auf „Belegt" (ohne Seitenreload)

Buchung bearbeiten

Der Buchende kann seine eigenen Buchungen bearbeiten, indem er auf die gebuchte Zelle klickt:

• Platz wechseln (sofern auf dem Verein mehr als ein Platz angelegt ist)
• Startzeit und Dauer ändern
• Kategorie, Kommentar ändern
• Equipment hinzufügen oder entfernen
• Buchung löschen (sofern Stornierungsfrist nicht abgelaufen)

E-Mail-Bestätigung & Kalender

Nach dem Buchen erhält das Mitglied eine Bestätigungs-Mail mit beigefügtem Kalender-Termin (.ics). Wird die Buchung später geändert, kommt eine Änderungs-Mail mit einem aktualisierten .ics – beim Öffnen aktualisiert die Kalender-App (Google, Outlook, Apple) den bestehenden Termin automatisch, statt einen doppelten anzulegen.

Ansichten

Ansicht	Beschreibung
Tagesansicht	Standard – zeigt alle Plätze für einen Tag nebeneinander
Wochenansicht	Zeigt eine ganze Woche für einen Platz (aktivierbar in Einstellungen)
Monatsansicht	Kalenderübersicht mit gebuchten Tagen (aktivierbar in Einstellungen)

🔁 Serien-Buchungen

Administratoren und Trainer können wiederkehrende Buchungen (Serien) anlegen. Diese werden automatisch für alle ausgewählten Termine erstellt.

Serie anlegen

1. Als Admin oder Trainer auf einen freien Slot klicken → Buchungs-Popup öffnet sich
2. Checkbox „Wiederkehrende Buchung" aktivieren
3. Muster wählen: wöchentlich oder täglich
4. Wochentag wählen (bei wöchentlich)
5. Enddatum festlegen
6. Auf „Buchen" klicken – alle konfliktfreien Termine werden angelegt

Einzeltermin aus Serie bearbeiten

Auf einen Serientermin klicken (erkennbar am 🔁-Symbol) → Edit-Popup öffnet sich. Änderungen werden nur für diesen einen Termin gespeichert.

Gesamte Serie bearbeiten

Im Edit-Popup erscheint bei Serien-Terminen eine blaue Box:

Wenn die Checkbox aktiviert wird, werden alle zukünftigen Termine der Serie mit den neuen Werten aktualisiert (Uhrzeit, Dauer, Kategorie, Trainer, Equipment).

Serie löschen – drei Optionen

Beim Löschen eines Serientermins (Edit-Popup im Frontend bzw. Lösch-Dialog im Backend) stehen drei Möglichkeiten zur Wahl:

Option	Wirkung
Nur diesen Termin	Löscht ausschließlich den angeklickten Termin. Die Serie bleibt sonst bestehen.
Ab diesem Termin	Löscht den angeklickten Termin und alle folgenden der Serie → die Serie wird verkürzt (Enddatum wird vorgezogen). Frühere Termine bleiben erhalten.
Gesamte Serie	Storniert alle zukünftigen Termine der Serie.

📋 Meine Buchungen

Der Shortcode [tennis_my_bookings] zeigt dem eingeloggten Nutzer seine aktuellen und vergangenen Buchungen.

Angezeigt werden

• Datum, Uhrzeit und Platz
• Kategorie (farbig)
• Name/Kommentar
• Gebuchtes Equipment (🎾 Symbol)
• Serien-Markierung (🔁 Symbol)
• Buchungen auf der Warteliste

Bearbeiten und Stornieren

Wenn die Einstellung „Meine Buchungen: Bearbeiten" aktiviert ist, erscheinen Buttons zum Bearbeiten und Stornieren direkt bei jeder Buchung.

Vergangene Buchungen

Unterhalb der bevorstehenden Buchungen gibt es einen aufklappbaren Bereich „🕓 Vergangene Buchungen". Dieser zeigt zurückliegende Termine (neueste zuerst) – nur zur Ansicht, ohne Bearbeiten- oder Stornieren-Möglichkeit.

iCal-Export

Nutzer können ihre Buchungen als .ics-Datei exportieren und in Kalender-Apps (Google Calendar, Outlook, Apple Kalender) importieren. Der Export-Link ist in der „Meine Buchungen"-Ansicht sichtbar.

⏳ Warteliste

Wenn ein Zeitslot belegt ist, können sich Nutzer auf die Warteliste setzen.

Funktionsweise

1. Nutzer klickt auf eine belegte Zelle
2. Es erscheint eine Info: „Dieser Platz ist belegt – auf Warteliste setzen?"
3. Nutzer bestätigt → Wartelisten-Eintrag wird erstellt
4. Wenn die Buchung storniert wird, erhält der erste Wartelisten-Nutzer automatisch eine Benachrichtigungs-E-Mail

Einstellung	Beschreibung
Sequenziell	Nur der erste Wartelistenplatz wird benachrichtigt (Standard)
Alle benachrichtigen	Alle auf der Warteliste werden gleichzeitig informiert

🗂 Buchungsverwaltung (Admin)

Unter Tennis Pro → Buchungen sieht der Administrator alle Buchungen in einer tabellarischen Übersicht.

Filtermöglichkeiten

• Nach Datum (Von / Bis)
• Nach Platz
• Nach Kategorie
• Suche nach Name / E-Mail

Aktionen

• Buchung bearbeiten: Alle Felder ändern, auch Platz und Datum
• Buchung löschen: Sofortige Löschung, E-Mail wird versendet
• Neue Buchung anlegen: Admin kann direkt für beliebige Nutzer buchen

Zeiten sperren

Unter Tennis Pro → Zeiten sperren können bestimmte Zeiträume für alle Plätze blockiert werden (z.B. Turnierveranstaltungen). Gesperrte Slots können von niemandem gebucht werden.

👥 Benutzerverwaltung

Unter Tennis Pro → Benutzer befindet sich eine vereinfachte Nutzerverwaltung speziell für das Plugin.

Ansicht

• Alle WordPress-Nutzer mit ihrer E-Mail-Adresse
• Anzahl der Buchungen pro Nutzer
• Datum der letzten Buchung
• Schnellzugriff auf alle Buchungen eines Nutzers

Passiv-Mitglied markieren

In der Benutzertabelle gibt es eine Spalte „Passiv-Mitglied" mit einer Checkbox je Nutzer (speichert sofort). Markierte Nutzer unterliegen dem Jahres-Buchungslimit aus den Einstellungen – siehe Abschnitt Passiv-Mitglieder.

Rolle „🎓 Trainer" zuweisen

Im Dropdown „Rolle ändern" steht neben „Benutzer (Frontend)" und „Tennisplatz-Admin" auch „🎓 Trainer" zur Auswahl. Nach dem Speichern erhält das Mitglied Zugriff auf alle als „🎓 Trainer" markierten Kategorien (automatische Anzeigenamen-Generierung „Training – Name") und kann zusätzlich Serien-Buchungen anlegen – siehe Abschnitt 🎓 Trainer-Rolle & Training mit Gast.

Selbstregistrierung

Wenn unter Einstellungen aktiviert, können sich neue Mitglieder selbst registrieren. Die Registrierungsseite wird über die Seiten-ID in den Einstellungen verknüpft.

Login-Seite anpassen

Das Plugin kann die Standard-WordPress-Login-Seite (wp-login.php) durch eine eigene Seite ersetzen. Einstellungen unter Einstellungen → System → Login.

💾 Export & Import

Erreichbar unter Tennis Pro → Export / Import. Zwei Tabs: Export und Import.

JSON-Backup (System-Export)

Exportiert Stammdaten als JSON-Datei – ideal für Sicherungen und Migrationen:

Abschnitt	Inhalt
🎾 Plätze	Name, Farben, Reihenfolge
🏷 Kategorien	Name, Farben, Admin-Only, Trainer-Only, Gastspieler-Flag, Training-mit-Gast-Flag, Namen-Sichtbarkeit (hide_names)
👤 Trainer	Name, Reihenfolge
🔧 Equipment	Name, Beschreibung, Anzahl, Reihenfolge
👥 Passiv-Mitglieder	Optional, per E-Mail zugeordnet (beim Import werden vorhandene Benutzer markiert)
⚙️ Einstellungen	Alle Buchungsregeln und Konfigurationen (ohne SMTP-Passwort)
📅 Buchungen	Optional, mit Datumsbereich, inkl. Equipment-Zuordnungen

CSV-Export

Buchungen als Excel-kompatible CSV-Datei mit Semikolon-Trennzeichen und UTF-8 BOM. Spalten:

court_name ; date ; timeslot ; duration ; player_name ; user_email ; category_name ; trainer_name ; equipment_names ; id ; end_time ; ...

iCal-Export

Buchungen als .ics-Datei für den Import in Kalender-Apps (Google Calendar, Outlook, Apple Kalender).

JSON-Import

Stellt Stammdaten aus einem Backup wieder her. Bestehende Einträge werden per Name abgeglichen und aktualisiert (kein Löschen von Bestehendem).

CSV-Import

Buchungen aus einer CSV-Datei einlesen. Pflichtfelder: court_name, date, timeslot, duration. Zeitkonflikte werden automatisch übersprungen.

🔄 Updates

Tennisplatz-Reservierung Pro hat einen eigenen Update-Mechanismus über den CCO-IT Lizenzserver.

Automatische Update-Prüfung

WordPress prüft alle 12 Stunden automatisch ob eine neue Version verfügbar ist. Wenn ja, erscheint auf der Plugins-Seite der übliche Update-Hinweis.

Manuelle Prüfung

1. Gehe zu Tennis Pro → Einstellungen → System
2. Klicke auf „Auf Updates prüfen"
3. Das Ergebnis erscheint sofort: aktuelle Version oder Update-Hinweis

Update einspielen

1. Gehe zu WordPress → Plugins
2. Bei „Tennisplatz-Reservierung Pro" erscheint der Update-Hinweis
3. Klicke auf „Jetzt aktualisieren"
4. WordPress lädt die neue Version vom Lizenzserver und installiert sie

🔐 Rollen & Rechte

Rolle	Funktion	Kann buchen	Admin-Funktionen
Administrator	Voller Zugriff auf WordPress und Plugin	✅ unbegrenzt	✅ alle
Tennisplatz-Admin	Plugin-Admin ohne WordPress-Admin-Rechte	✅ unbegrenzt	✅ alle Plugin-Funktionen (außer Benutzerverwaltung)
🎓 Trainer	Mitglied mit Zugriff auf alle als „🎓 Trainer" markierten Kategorien (automatische Namensgebung „Training – Name")	✅ lt. Buchungsregeln + Trainer-Kategorien + Serien-Buchungen	❌ kein Tennis-Backend
Subscriber / Mitglied	Standard-Nutzerkonto	✅ lt. Buchungsregeln	❌ keine
Nicht eingeloggt	Besucher	❌	❌

Rolle „Tennisplatz-Admin" oder „🎓 Trainer" vergeben

1. Am einfachsten unter Tennis Pro → Benutzer: Im Dropdown „Rolle ändern" die gewünschte Rolle auswählen und auf „💾 Speichern" klicken (speichert sofort per AJAX)
2. Alternativ in WordPress unter Benutzer → Alle Benutzer → Benutzer bearbeiten → Rolle auf „Tennisplatz-Admin" bzw. „Tennis-Trainer" setzen → Speichern
3. „Tennisplatz-Admin" erhält damit Zugriff auf das komplette Tennis-Pro-Backend (außer Benutzerverwaltung), aber nicht auf den Rest des WordPress-Backends
4. „🎓 Trainer" erhält keinen Tennis-Backend-Zugriff, sieht aber im Frontend zusätzlich die als „🎓 Trainer" markierten Kategorien und darf Serien-Buchungen anlegen

❓ Häufige Fragen (FAQ)

Das Buchungs-Frontend zeigt nichts an

→ Überprüfe ob der Shortcode [tennis_booking] auf der Seite ist, mindestens ein Platz angelegt wurde und der Nutzer eingeloggt ist.

E-Mails kommen nicht an

→ SMTP konfigurieren (Einstellungen → E-Mail → SMTP) und über „E-Mail-Test" prüfen. Standard-WordPress-E-Mail wird oft von Spam-Filtern abgefangen.

Buchung schlägt fehl: „Zeitslot bereits belegt"

→ Ein anderer Nutzer hat denselben Slot gleichzeitig gebucht. Die Zelle automatisch aktualisiert sich – einfach einen anderen Slot wählen.

Equipment wird als belegt angezeigt, obwohl keine Buchung sichtbar

→ Equipment wird platzübergreifend geprüft. Die Buchung mit diesem Equipment könnte auf einem anderen Platz liegen. Seite neu laden um die aktuelle Verfügbarkeit zu sehen.

Update wird nach der Installation immer noch angezeigt

→ Einmal auf „Auf Updates prüfen" klicken (Einstellungen → System). Das leert den Update-Cache und die Plugins-Seite zeigt den korrekten Stand.

Buchungen im JSON-Export fehlen

→ Beim JSON-Export die Checkbox „Buchungen" aktivieren und den gewünschten Datumsbereich einstellen. Buchungen werden standardmäßig nicht exportiert.

CSV-Import: Buchungen werden übersprungen

→ Häufigste Ursachen: Platzname stimmt nicht überein (Groß-/Kleinschreibung egal, aber kein Tippfehler), Datumsformat muss YYYY-MM-DD sein, Zeitkonflikt mit bestehender Buchung.

Gastgebühr-Mail wird nicht verschickt

→ Prüfen: Ist die Funktion unter Einstellungen → Buchung → Gastspieler aktiv, ist die Kategorie als „🎾 Gastspieler" markiert, und sind E-Mail-Benachrichtigungen generell aktiviert? Die verantwortliche E-Mail muss eingetragen sein.

Trainer sieht seine Trainings-Kategorie nicht im Buchungs-Popup

→ Prüfen: Hat das Mitglied in der Benutzerverwaltung (Tennis Pro → Benutzer) die Rolle „🎓 Trainer", und ist die gewünschte Kategorie unter Tennis Pro → Kategorien mit der Checkbox „🎓 Trainer" markiert? Ist bei der Kategorie zusätzlich „Nur Admin" aktiviert, bleibt sie für Trainer trotzdem gesperrt – beide Häkchen sollten nicht gleichzeitig gesetzt sein.

„Training mit Gast"-Gebühr-Mail wird nicht verschickt

→ Prüfen: Ist die Funktion unter Einstellungen → Buchung → Training mit Gast aktiv, ist die Kategorie als „🎓 Training mit Gast" markiert, und ist die verantwortliche E-Mail eingetragen? Diese Einstellung ist unabhängig von der regulären Gastspieler-Gebühr.

Passiv-Mitglied kann trotzdem buchen / gar nicht buchen

→ Die Funktion muss unter Einstellungen → Buchung → Passiv-Mitglieder aktiviert sein und der Nutzer in der Benutzerverwaltung als „Passiv" markiert sein. Limit 0 = darf gar nicht buchen.

Wie richte ich die PWA / App-Ansicht ein?

→ Eine neue WordPress-Seite erstellen, als Template „Tennis Pro – App-Ansicht" wählen und veröffentlichen. Die URL dieser Seite ist der App-Link. Anschließend unter Tennis Pro → Einstellungen → Progressive Web App App-Name, Farben und Logo einstellen. Ausführliche Anleitung im Abschnitt 📱 Progressive Web App.

Gäste können in der PWA den Kalender sehen, aber nicht buchen

→ Das ist das gewünschte Verhalten. Nicht eingeloggte Besucher sehen den Kalender im Lesemodus – Buchungen erfordern einen Account. Über den „Anmelden"-Button im Kopfbereich gelangt man zum In-App-Login.

In der App-Ansicht kann ich nicht nach rechts scrollen (weitere Plätze sehen)

→ Den App-Bildschirm seitlich wischen oder die Scrollleiste am unteren Rand des Bildschirms nutzen (Desktop: Scroll-Leiste am unteren Fensterrand; Mobil: mit einem Finger horizontal wischen). Das Raster füllt sich nur horizontal, wenn tatsächlich mehr Plätze vorhanden sind als auf den Bildschirm passen.

Das App-Logo wird auf der Kachelseite sehr groß oder sehr klein dargestellt

→ Empfohlene Bildgröße: 200 × 100 px im Querformat. Das Logo wird auf max. 160 px Breite begrenzt und skaliert proportional. Ein quadratisches Logo oder Hochformat-Logo kann bei der Darstellung etwas anders wirken – ein leicht breiteres Format funktioniert am besten.

Der „Abmelden"-Button fehlt in der App-Ansicht

→ Der Abmelden-Button erscheint nur, wenn der Nutzer eingeloggt ist, und zwar im Kopfbereich des Buchungskalenders (rechts). Auf der Kachelseite gibt es zusätzlich eine separate Abmelden-Kachel. Stelle sicher, dass du eingeloggt bist und die App-Version mindestens 2.3.1 ist.

Kachel-Icons erscheinen in falscher Farbe

→ Die Icons in der App verwenden currentColor und übernehmen automatisch die eingestellte Kacheltext-Farbe (Einstellungen → PWA → Kacheltext-Farbe). Falls Icons hell auf hellem Hintergrund verschwinden – Kacheltext-Farbe auf einen kontrastierenden Wert (z.B. #ffffff für weißen Text auf dunklen Kacheln) setzen.

Wo finde ich weitere Hilfe?

→ cco-it.de/tennisreservierung-pro – oder direkt per E-Mail an a.diehm@cco-it.de