1. Ziel des Administrator-Handbuchs
Dieses Dokument richtet sich an Joomla-Administratoren und technische Betreiber der Erweiterung
PanoramaTour. Es beschreibt Installation, Konfiguration, Wartung, Fehlerdiagnose und den produktiven
Betrieb.
PanoramaTour. Es beschreibt Installation, Konfiguration, Wartung, Fehlerdiagnose und den produktiven
Betrieb.
2. Systemvoraussetzungen
• Joomla 5.x oder Joomla 6.x
• PHP entsprechend der Joomla-Anforderungen
• MySQL oder MariaDB
• ZipArchive für Exportfunktionen
• Optional: Imagick oder GD für Bildverarbeitung
• Optional: EXIF-Unterstützung für Metadaten
• PHP entsprechend der Joomla-Anforderungen
• MySQL oder MariaDB
• ZipArchive für Exportfunktionen
• Optional: Imagick oder GD für Bildverarbeitung
• Optional: EXIF-Unterstützung für Metadaten
3. Installationspaket
Das Paket enthält:
• com_panoramatour
• mod_panoramatour
• plg_content_panoramatour
• pkg_panoramatour als Gesamtpaketinstaller
• com_panoramatour
• mod_panoramatour
• plg_content_panoramatour
• pkg_panoramatour als Gesamtpaketinstaller
4. Installation
1. Erweiterungen → Installieren öffnen.
2. pkg_panoramatour_X.X.X.zip auswählen.
3. Installation starten.
4. Komponenten, Modul und Plugin prüfen.
5. Plugin aktivieren.
6. Berechtigungen kontrollieren.
5. Verzeichnisstruktur
Typische Verzeichnisse:
administrator/components/com_panoramatour
components/com_panoramatour
modules/mod_panoramatour
plugins/content/panoramatour
images/panoramatour
2. pkg_panoramatour_X.X.X.zip auswählen.
3. Installation starten.
4. Komponenten, Modul und Plugin prüfen.
5. Plugin aktivieren.
6. Berechtigungen kontrollieren.
5. Verzeichnisstruktur
Typische Verzeichnisse:
administrator/components/com_panoramatour
components/com_panoramatour
modules/mod_panoramatour
plugins/content/panoramatour
images/panoramatour
6. Datenbanktabellen
• #__panoramatour_projects
• #__panoramatour_scenes
• #__panoramatour_hotspots
• #__panoramatour_scenes
• #__panoramatour_hotspots
7. ACL und Berechtigungen
Unter Optionen → Berechtigungen können folgende Rechte vergeben werden:
• Verwalten
• Erstellen
• Bearbeiten
• Löschen
• Status ändern
• Exportieren
• Verwalten
• Erstellen
• Bearbeiten
• Löschen
• Status ändern
• Exportieren
8. Komponenteneinstellungen
Verfügbare Einstellungen:
• Versionsanzeige
• Uploadgrenzen
• WebP-Erzeugung
• Exportoptionen
• Standardviewer-Einstellungen
• Versionsanzeige
• Uploadgrenzen
• WebP-Erzeugung
• Exportoptionen
• Standardviewer-Einstellungen
9. Dashboard
Das Dashboard dient zur schnellen Übersicht:
• Anzahl Projekte
• Anzahl Szenen
• Anzahl Hotspots
• Diagnoseinformationen
• Vorschau
• Export
• Anzahl Projekte
• Anzahl Szenen
• Anzahl Hotspots
• Diagnoseinformationen
• Vorschau
• Export
10. Projektverwaltung
Administratoren können:
• Projekte anlegen
• Projekte veröffentlichen
• Kategorien zuweisen
• Projekte exportieren
• Projekte archivieren
• Projekte anlegen
• Projekte veröffentlichen
• Kategorien zuweisen
• Projekte exportieren
• Projekte archivieren
11. Szenenverwaltung
Für jede Szene können verwaltet werden:
• Panorama-Datei
• Reihenfolge
• Startszene
• Grundrissposition
• Status
• Panorama-Datei
• Reihenfolge
• Startszene
• Grundrissposition
• Status
12. Hotspotverwaltung
Unterstützte Hotspottypen:
• Szenenwechsel
• Link
• Bild
• Video
• Audio
• PDF
• HTML-Infobox
• Information
• Szenenwechsel
• Link
• Bild
• Video
• Audio
• HTML-Infobox
• Information
13. Medienverwaltung
Empfohlene Bildformate:
• JPG
• PNG
• WebP
Empfohlenes Format für 360°-Bilder:
equirektangulares Bild im Verhältnis 2:1.
14. Backupstrategie
Empfohlen wird:
• tägliche Datenbanksicherung
• Sicherung des Verzeichnisses images/panoramatour
• Sicherung vor Updates
• Export wichtiger Projekte
15. Updateprozess
1. Backup erstellen.
2. Neue Paketversion installieren.
3. Datenbank prüfen.
4. Joomla Cache leeren.
5. Funktionsprüfung durchführen.
16. Fehlerdiagnose
Typische Probleme:
• Viewer lädt nicht → Browserkonsole prüfen.
• Hotspots fehlen → Status prüfen.
• Vorschau leer → Frontend-URL prüfen.
• Export fehlerhaft → Schreibrechte prüfen.
17. Sicherheitsmaßnahmen
• Nur benötigte Benutzerrechte vergeben.
• SVG-Uploads nur vertrauenswürdigen Benutzern erlauben.
• Joomla aktuell halten.
• HTTPS verwenden.
• Regelmäßige Backups durchführen.
18. Monitoring und Wartung
Empfohlen:
• Logdateien kontrollieren
• Datenbank optimieren
• Nicht verwendete Medien entfernen
• Browserkompatibilität prüfen
19. Empfohlene Betriebsumgebung
Produktiv empfohlen:
• PHP OPcache
• HTTP/2 oder HTTP/3
• SSD-Speicher
• CDN bei großen Projekten
Empfohlene Bildformate:
• JPG
• PNG
• WebP
Empfohlenes Format für 360°-Bilder:
equirektangulares Bild im Verhältnis 2:1.
14. Backupstrategie
Empfohlen wird:
• tägliche Datenbanksicherung
• Sicherung des Verzeichnisses images/panoramatour
• Sicherung vor Updates
• Export wichtiger Projekte
15. Updateprozess
1. Backup erstellen.
2. Neue Paketversion installieren.
3. Datenbank prüfen.
4. Joomla Cache leeren.
5. Funktionsprüfung durchführen.
16. Fehlerdiagnose
Typische Probleme:
• Viewer lädt nicht → Browserkonsole prüfen.
• Hotspots fehlen → Status prüfen.
• Vorschau leer → Frontend-URL prüfen.
• Export fehlerhaft → Schreibrechte prüfen.
17. Sicherheitsmaßnahmen
• Nur benötigte Benutzerrechte vergeben.
• SVG-Uploads nur vertrauenswürdigen Benutzern erlauben.
• Joomla aktuell halten.
• HTTPS verwenden.
• Regelmäßige Backups durchführen.
18. Monitoring und Wartung
Empfohlen:
• Logdateien kontrollieren
• Datenbank optimieren
• Nicht verwendete Medien entfernen
• Browserkompatibilität prüfen
19. Empfohlene Betriebsumgebung
Produktiv empfohlen:
• PHP OPcache
• HTTP/2 oder HTTP/3
• SSD-Speicher
• CDN bei großen Projekten
• Server-Caching
20. Zusammenfassung
PanoramaTour integriert virtuelle Rundgänge vollständig in Joomla und erlaubt den professionellen
Betrieb ohne externe Plattformen. Das Administrator-Handbuch dient als technische Grundlage für
20. Zusammenfassung
PanoramaTour integriert virtuelle Rundgänge vollständig in Joomla und erlaubt den professionellen
Betrieb ohne externe Plattformen. Das Administrator-Handbuch dient als technische Grundlage für
