pointcab_webexport/USER_GUIDE.md

Benutzerhandbuch - PointCab Webexport Server

Dieses Handbuch erklärt die Verwendung des PointCab Webexport Servers.

🏠 Admin-Dashboard

Zugang

Öffnen Sie das Admin-Dashboard unter:

https://ihre-domain.de/admin/dashboard

Oder lokal:

http://localhost:3000/admin/dashboard

Übersicht

Das Dashboard zeigt:

• Liste aller Projekte
• Projekt-Status (aktiv/abgelaufen)
• Aktionen (Bearbeiten, Löschen, Link kopieren)

📤 Projekt hochladen (ZIP/RAR)

Schritt 1: Neues Projekt

1. Klicken Sie auf "Neues Projekt"
2. Wählen Sie "ZIP/RAR hochladen"

Schritt 2: Datei auswählen

1. Klicken Sie auf "Datei auswählen"
2. Wählen Sie Ihre ZIP- oder RAR-Datei
3. Unterstützte Formate: .zip, .rar
4. Maximale Größe: 500 MB (konfigurierbar)

Schritt 3: Projekt-Details

Feld	Beschreibung	Pflicht
Projektname	Eindeutiger Name	Ja
Passwort	Optionaler Schutz	Nein
Ablaufdatum	Automatisches Löschen	Nein

Schritt 4: Hochladen

1. Klicken Sie auf "Hochladen"
2. Warten Sie bis der Upload abgeschlossen ist
3. Bei mehreren HTML-Dateien: Wählen Sie die Haupt-HTML

Ergebnis

Nach erfolgreichem Upload erhalten Sie:

• Share-Link: https://ihre-domain.de/abc123/view
• Share-ID: abc123

📁 Manuelles Projekt erstellen

Wann verwenden?

• Wenn Sie Dateien später hinzufügen möchten
• Für schrittweises Befüllen
• Für RAR-Archive (erst Projekt, dann RAR entpacken)

Schritte

1. Klicken Sie auf "Neues Projekt"
2. Wählen Sie "Manuell erstellen"
3. Geben Sie den Projektnamen ein
4. Optional: Passwort und Ablaufdatum
5. Klicken Sie auf "Erstellen"

Das Projekt wird mit einer Platzhalter-HTML erstellt.

📦 RAR entpacken

Voraussetzung

• Ein manuell erstelltes Projekt
• RAR-Datei mit dem Webexport

Schritte

1. Öffnen Sie das Projekt im Dashboard
2. Klicken Sie auf "RAR entpacken"
3. Wählen Sie die RAR-Datei
4. Klicken Sie auf "Entpacken"
5. Der Server entpackt die Datei automatisch

Was passiert?

1. Die Platzhalter-HTML wird gelöscht
2. Die RAR wird entpackt
3. HTML-Dateien werden erkannt
4. Bei mehreren HTMLs: Auswahl-Seite erscheint

🔗 Projekt teilen

Share-Link kopieren

1. Im Dashboard: Klicken Sie auf das Link-Symbol 📋
2. Der Link wird in die Zwischenablage kopiert
3. Teilen Sie den Link

Link-Format

https://ihre-domain.de/{shareId}/view

Beispiel:

https://pointcab-webexport.zell-cloud.de/xmqqkfs0/view

🔐 Passwort-Schutz

Passwort setzen

Beim Erstellen:

1. Geben Sie ein Passwort im Feld "Passwort" ein
2. Das Projekt ist sofort geschützt

Nachträglich:

1. Öffnen Sie das Projekt im Dashboard
2. Klicken Sie auf "Bearbeiten"
3. Geben Sie ein neues Passwort ein
4. Speichern Sie

Passwort-Eingabe

Wenn ein Projekt geschützt ist:

1. Besucher sehen eine Passwort-Seite
2. Nach korrekter Eingabe wird das Projekt angezeigt
3. Das Passwort wird im Browser gespeichert (Cookie)

Passwort entfernen

1. Bearbeiten Sie das Projekt
2. Löschen Sie das Passwort-Feld
3. Speichern Sie

📄 Multi-HTML-Auswahl

Wann erscheint die Auswahl?

Wenn ein Projekt mehrere HTML-Dateien enthält:

• Web_0.html
• pano.html
• index.html

Auswahl-Seite

1. Besucher sehen eine Liste aller HTML-Dateien
2. Klick auf einen Eintrag öffnet diese HTML
3. Die Auswahl wird gespeichert (Cookie)

Haupt-HTML festlegen

Im Dashboard:

1. Bearbeiten Sie das Projekt
2. Wählen Sie die Haupt-HTML aus der Liste
3. Speichern Sie

⏰ Ablaufdatum

Ablaufdatum setzen

1. Beim Erstellen oder Bearbeiten
2. Wählen Sie ein Datum im Kalender
3. Nach diesem Datum ist das Projekt nicht mehr zugänglich

Was passiert bei Ablauf?

• Besucher sehen eine "Projekt abgelaufen"-Meldung
• Das Projekt bleibt im Dashboard sichtbar
• Sie können das Ablaufdatum verlängern oder entfernen

🗑️ Projekt löschen

Im Dashboard

1. Finden Sie das Projekt
2. Klicken Sie auf "Löschen" 🗑️
3. Bestätigen Sie die Löschung

Was wird gelöscht?

• Datenbank-Eintrag
• Alle hochgeladenen Dateien
• Der Share-Link wird ungültig

⚠️ Achtung: Löschen kann nicht rückgängig gemacht werden!

📊 Projektstruktur

Unterstützte Strukturen

Standard PointCab Export:

projekt.zip
├── Web_0.html (oder index.html)
├── Web_0_web/
│   ├── js/
│   ├── css/
│   ├── img/
│   └── panos/

Multi-HTML Export:

projekt.zip
├── Web_0.html
├── Web_1.html
├── pano.html
├── Web_0_web/
│   └── ...
├── Web_1_web/
│   └── ...

Automatische Erkennung

Der Server erkennt automatisch:

• Haupt-HTML-Datei
• Web-Subfolder (z.B. Web_0_web/)
• Asset-Verzeichnisse

🔧 Tipps & Tricks

Große Dateien

• ZIP ist schneller als RAR
• Bei sehr großen Projekten: Manuell + RAR

Mehrere HTML-Dateien

• Benennen Sie die Haupt-HTML eindeutig
• Oder setzen Sie sie nachträglich im Dashboard

Passwort vergessen?

• Im Dashboard können Sie das Passwort jederzeit ändern
• Es gibt keine "Passwort vergessen"-Funktion für Besucher

Projekt umbenennen

• Im Dashboard: Bearbeiten → Namen ändern
• Der Share-Link bleibt gleich!

🆘 Häufige Probleme

"404 - Datei nicht gefunden"

Ursache: Asset-Pfade sind falsch Lösung: Prüfen Sie die ZIP-Struktur

"Projekt abgelaufen"

Ursache: Ablaufdatum erreicht Lösung: Im Dashboard Ablaufdatum verlängern

"Falsches Passwort"

Ursache: Tippfehler oder Cache Lösung: Browser-Cache löschen, erneut versuchen

Leere Seite

Ursache: JavaScript-Fehler Lösung: Browser-Konsole prüfen (F12)

---

Weitere Hilfe: Kontaktieren Sie den Administrator