Beratungskalender

1. Wofuer ist diese Funktion

Der Beratungskalender ist ein spezialisiertes Modul in Octoserv, das eine externe Buchungsseite nahtlos in die Octoserv-Oberflaeche integriert. Er ist ueber den Navigationspunkt "Beratungskalender" in der Sidebar erreichbar (/octo/beratungskalender) und zeigt den Mitarbeiterbereich der Website als eingebettete Ansicht an.

Im Gegensatz zur allgemeinen Terminverwaltung (unter "Termine"), die interne Aufgaben und Faelligkeiten verwaltet, dient der Beratungskalender der Einsicht in oeffentliche Buchungstermine und deren Verfuegbarkeit. Die eingebettete Seite (/mitarbeiterbereich/) wird als iFrame dargestellt und automatisch im Octoserv-Design aufbereitet.

2. Ziel und Vorteil

• Zentrale Anlaufstelle: Mitarbeiter koennen ihre Beratungstermine und Buchungen direkt aus Octoserv heraus einsehen, ohne die Anwendung verlassen oder sich separat im Mitarbeiterbereich anmelden zu muessen.
• Nahtlose Integration: Die externe Buchungsseite wird optisch in die Octoserv-Oberflaeche eingebettet. WordPress-Elemente wie Adminbar, Header, Footer und Cookie-Banner werden automatisch ausgeblendet, sodass nur der relevante Inhalt sichtbar ist.
• Konsistente Benutzererfahrung: Der Benutzer bleibt im gewohnten Octoserv-Layout mit der vertrauten Sidebar-Navigation und muss sich nicht in einer separaten Oberflaeche orientieren.
• Berechtigungsschutz: Der Zugriff auf den Beratungskalender wird ueber eine eigene Berechtigungsfunktion gesteuert. Benutzer ohne Zugriff werden automatisch zum Dashboard weitergeleitet.
• Schneller Ladevorgang: Waehrend die eingebettete Seite geladen wird, zeigt ein Lade-Spinner an, dass der Inhalt vorbereitet wird. Der eigentliche Inhalt wird erst angezeigt, wenn die Seite vollstaendig geladen ist, was ein Aufblitzen von ungestylten WordPress-Elementen verhindert.

3. Detaillierte Funktionsbeschreibung

3.1 Seitenaufbau

Die Beratungskalender-Seite besteht aus dem Standard-Octoserv-Layout:

• Sidebar: Die gewohnte Octoserv-Navigation mit Logo, Menuepunkten und Footer.
• Hauptbereich: Ueberschrift "Beratungskalender" mit Hilfe-Button und darunter der iFrame-Container.

3.2 iFrame-Integration

Der Beratungskalender bettet die Seite /mitarbeiterbereich/ der aktuellen WordPress-Installation als iFrame ein. Die URL wird dynamisch ueber home_url('/mitarbeiterbereich/') generiert, sodass sie automatisch an die jeweilige Domain angepasst ist.

Technischer Ablauf:

1. Beim Laden der Seite wird ein weisser Lade-Spinner mit dem Text "Einen Moment bitte. Die Ansicht wird geladen." angezeigt.
2. Das iFrame wird zunachst unsichtbar geladen (display: none).
3. Sobald das iFrame-Load-Event ausgeloest wird, werden per JavaScript CSS-Regeln in das iFrame injiziert:
   • WordPress-Adminbar wird ausgeblendet
   • Website-Header (#masthead) wird ausgeblendet
   • Seitenheader (.entry-header) wird ausgeblendet
   • Website-Footer (#colophon) wird ausgeblendet
   • Cookie-Banner (Borlabs Cookie Box) wird ausgeblendet
   • Oberer HTML-Margin wird entfernt
4. Der Lade-Spinner wird mit einem Fade-Effekt ausgeblendet.
5. Das iFrame wird mit einem Fade-Effekt eingeblendet.

Timeout-Sicherung:

Falls das Load-Event des iFrames nicht innerhalb von 3 Sekunden ausgeloest wird (z.B. bei langsamer Verbindung), wird der Inhalt trotzdem angezeigt. Dies verhindert, dass Benutzer endlos auf den Lade-Spinner warten.

Fehlerbehandlung:

Bei einem Ladefehler des iFrames wird der Lade-Spinner durch eine rote Fehlermeldung ersetzt: "Fehler beim Laden des Beratungskalenders. Bitte laden Sie die Seite neu."

3.3 iFrame-Container

Der iFrame-Container nimmt die volle Breite des Hauptbereichs ein und hat eine Hoehe von calc(100vh - 4rem), was nahezu den gesamten sichtbaren Bildschirmbereich ausfuellt. Der Container hat abgerundete Ecken (8px) und einen leichten Schatten fuer eine moderne Optik.

3.4 Berechtigungssystem

Der Zugriff wird ueber die Funktion octo_user_can_access_beratungskalender() gesteuert. Benutzer ohne diese Berechtigung werden beim Aufruf der Seite automatisch per wp_safe_redirect() zum Dashboard weitergeleitet. Der Navigationspunkt in der Sidebar wird fuer diese Benutzer ebenfalls nicht angezeigt.

3.5 Hilfe-Button

Neben der Seitenueberschrift "Beratungskalender" befindet sich ein Hilfe-Button, der ueber Octo_Help::get_help_button('beratungskalender') kontextbezogene Hilfeinformationen bereitstellt.

4. Benutzerdokumentation / Anwendung

4.1 Beratungskalender oeffnen

Der Beratungskalender wird ueber den Navigationspunkt "Beratungskalender" (mit dem Uhr-Icon) in der linken Sidebar erreicht. Nach einem kurzen Ladevorgang (erkennbar am orangefarbenen Lade-Spinner) wird die Buchungsansicht angezeigt.

4.2 Beratungskalender nutzen

1. Nach dem Laden wird der Inhalt des Mitarbeiterbereichs angezeigt.
2. Die Interaktion erfolgt direkt im eingebetteten Bereich. Alle Funktionen der Buchungsseite stehen zur Verfuegung.
3. Die Octoserv-Sidebar bleibt sichtbar, sodass jederzeit zu anderen Modulen navigiert werden kann.

4.3 Bei Ladeproblemen

1. Sollte die Fehlermeldung "Fehler beim Laden des Beratungskalenders" erscheinen, die Seite ueber den Browser neu laden (F5 oder Strg+R).
2. Wenn das Problem bestehen bleibt, die Internetverbindung pruefen.
3. Bei anhaltenden Problemen den Administrator kontaktieren.

5. Anwendungsbeispiele

5.1 Berater: Verfuegbarkeit pruefen

Ein Berater oeffnet morgens den Beratungskalender, um seine heutigen Buchungen einzusehen. Er sieht die Terminuebersicht des Mitarbeiterbereichs direkt in Octoserv und kann pruefen, welche Beratungstermine fuer den Tag eingeplant sind. Anschliessend navigiert er ueber die Sidebar zur Kontaktverwaltung, um die Daten seiner naechsten Kunden vor dem Termin noch einmal durchzugehen.

5.2 Teamleiter: Buchungsstatus ueberpruefen

Eine Teamleiterin moechte pruefen, wie die Buchungslage fuer die kommende Woche aussieht. Sie oeffnet den Beratungskalender und navigiert innerhalb der eingebetteten Ansicht zur Wochenansicht. So erkennt sie, welche Zeitfenster noch frei sind und ob alle Berater ausreichend ausgelastet sind.

5.3 Sachbearbeiter: Schneller Blick auf Buchungen

Ein Sachbearbeiter erhaelt einen Anruf von einem Kunden, der seinen gebuchten Termin bestaetigen moechte. Der Sachbearbeiter wechselt kurz in den Beratungskalender, prueft die Buchung und bestaetigt dem Kunden den Termin. Danach navigiert er ueber die Sidebar zurueck zu seiner vorherigen Ansicht in der Kontaktverwaltung.

5.4 Neuer Mitarbeiter: Orientierung im Beratungskalender

Ein neuer Mitarbeiter sieht den Beratungskalender zum ersten Mal in der Sidebar. Er klickt darauf und sieht nach kurzem Laden die Buchungsansicht. Ueber den Hilfe-Button neben der Ueberschrift kann er sich kontextbezogene Informationen anzeigen lassen, um die Funktionsweise der Buchungsseite besser zu verstehen.