Berichte

1. Wofuer ist diese Funktion

Das Berichtsmodul in Octoserv integriert die Groundhogg-Reporting-Oberflaeche nahtlos in die Octoserv-Umgebung. Es ist ueber den Navigationspunkt "Berichte" in der Sidebar erreichbar und bietet Zugriff auf die detaillierten E-Mail-Marketing- und Automatisierungsberichte des Groundhogg-CRM-Systems.

Die Integration funktioniert nach dem iFrame-Prinzip: Die Groundhogg-Reporting-Seite wird innerhalb der Octoserv-Oberflaeche eingebettet, wobei WordPress-spezifische Elemente (Adminbar, Sidebar, Footer) automatisch ausgeblendet und das Layout an das Octoserv-Design angepasst wird. Dadurch arbeiten Benutzer vollstaendig innerhalb der Octoserv-Oberflaeche, ohne das WordPress-Backend direkt aufrufen zu muessen.

2. Ziel und Vorteil

• Einheitliche Oberflaeche: Die Groundhogg-Berichte sind direkt in Octoserv verfuegbar, ohne zwischen verschiedenen Backends wechseln zu muessen. Benutzer arbeiten in einer konsistenten Umgebung.
• E-Mail-Marketing-Analyse: Zugriff auf detaillierte Statistiken zu E-Mail-Kampagnen, Oeffnungsraten, Klickraten und Automatisierungs-Performance direkt aus Octoserv heraus.
• Optische Integration: Die Groundhogg-Oberflaeche wird optisch an das Octoserv-Design angepasst. WordPress-Elemente werden ausgeblendet und der Hintergrund passt sich dem Octoserv-Farbschema an.
• Automatische Ladeanzeige: Waehrend die Berichtsseite geladen wird, zeigt ein Lade-Spinner den Ladevorgang an. Der Inhalt wird erst eingeblendet, wenn er vollstaendig geladen und gestylt ist.

3. Detaillierte Funktionsbeschreibung

3.1 Architektur

Das Berichtsmodul folgt dem gleichen iFrame-Integrationsmuster wie das Veranstaltungsmodul:

Seitenstruktur:

• Standard-Octoserv-Layout mit Sidebar-Navigation und Hauptbereich.
• Ueberschrift "Berichte" mit Hilfe-Button.
• iFrame-Container mit Lade-Spinner.

iFrame-Integration:

1. Beim Laden der Seite wird ein weisser Lade-Spinner mit dem Text "Einen Moment bitte. Die Ansicht wird geladen." angezeigt.
2. Das iFrame laedt die Groundhogg-Reporting-Seite (admin.php?page=gh_reporting) im Hintergrund.
3. Nach dem Laden werden per CSS-Injection folgende Anpassungen vorgenommen:
   • WordPress-Adminmenue, Adminbar und Footer werden ausgeblendet.
   • WordPress-Content-Bereiche werden auf volle Breite ohne Margin gesetzt.
   • Der Hintergrund wird auf Weiss gesetzt.
   • Groundhogg-Branding-Elemente (Logo, SVG-Grafiken) werden ausgeblendet.
   • WordPress-Notices und Fehlermeldungen werden ausgeblendet.
   • Die Tab-Navigation von Groundhogg bleibt sichtbar und nutzbar.
4. Der Lade-Spinner wird mit einem Fade-Effekt ausgeblendet und das iFrame eingeblendet.

Fehlerbehandlung:

Bei einem Ladefehler wird die Fehlermeldung "Fehler beim Laden der Berichte. Bitte laden Sie die Seite neu." in roter Schrift angezeigt.

iFrame-Container:

Der Container hat eine Hoehe von calc(100vh - 4rem), abgerundete Ecken (8px) und einen leichten Schatten. Er fuellt nahezu den gesamten sichtbaren Bildschirmbereich aus.

3.2 Geladene Groundhogg-Seite

Die im iFrame eingebettete Seite ist die Groundhogg-Reporting-Uebersicht (gh_reporting). Diese bietet verschiedene Berichtsansichten zu:

• E-Mail-Versand und -Performance
• Kontakt-Aktivitaeten und -Wachstum
• Funnel-Performance und -Konversionen
• Tag-Statistiken

Detaillierte Dokumentation der Groundhogg-Berichtsfunktionen folgt in einer separaten Anleitung.

3.3 Technische Details

• Die WordPress-Adminbar wird sowohl auf der aeusseren Seite (show_admin_bar(false)) als auch innerhalb des iFrames per CSS-Injection ausgeblendet.
• Der margin-top des HTML-Elements wird auf 0 gesetzt, um den Platz der ausgeblendeten Adminbar zurueckzugewinnen.
• Die CSS-Injection erfolgt ueber contentDocument des iFrames. Bei Cross-Origin-Problemen wird eine Warnung in der Konsole ausgegeben, das iFrame aber trotzdem angezeigt.

4. Benutzerdokumentation / Anwendung

4.1 Berichte aufrufen

1. Navigieren Sie zu "Berichte" in der Sidebar.
2. Warten Sie, bis der Lade-Spinner verschwindet und die Berichtsoberflaeche angezeigt wird.
3. Nutzen Sie die Groundhogg-Tab-Navigation innerhalb des Berichtsbereichs, um zwischen verschiedenen Berichtsansichten zu wechseln.

4.2 Navigation innerhalb der Berichte

Die Groundhogg-Reporting-Oberflaeche bietet verschiedene Tabs und Filtermoeglchkeiten. Alle Interaktionen finden innerhalb des eingebetteten Bereichs statt. Die Octoserv-Sidebar bleibt dabei immer sichtbar und ermoeglicht jederzeit die Navigation zu anderen Octoserv-Bereichen.

4.3 Fehlerbehebung

Falls die Berichte nicht geladen werden:

1. Laden Sie die Seite ueber den Browser-Aktualisieren-Button neu.
2. Stellen Sie sicher, dass Sie eingeloggt sind und die entsprechende Berechtigung besitzen.
3. Pruefen Sie, ob das Groundhogg-Plugin aktiv ist.

Detaillierte Dokumentation der Groundhogg-Berichtsfunktionen folgt in einer separaten Anleitung.

5. Anwendungsbeispiele

Beispiel 1: E-Mail-Kampagnen-Performance pruefen

Ein Marketingmitarbeiter oeffnet die Berichte, um die Performance seiner letzten E-Mail-Kampagne zu ueberpruefen. Er kann direkt in Octoserv die Oeffnungsraten, Klickraten und Bounce-Raten einsehen, ohne sich ins WordPress-Backend einloggen zu muessen.

Beispiel 2: Kontakt-Wachstum analysieren

Ein Teamleiter moechte das Wachstum der Kontaktdatenbank ueber einen bestimmten Zeitraum betrachten. Ueber die Groundhogg-Berichte sieht er die Entwicklung der Kontaktzahlen und kann Trends erkennen.

Beispiel 3: Funnel-Performance ueberpruefen

Ein Manager moechte nachvollziehen, wie effektiv bestimmte Automatisierungs-Funnels arbeiten. In den Berichten kann er die Konversionsraten der einzelnen Funnel-Schritte einsehen und Engstellen identifizieren.