279 lines
5.7 KiB
Markdown
279 lines
5.7 KiB
Markdown
# 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
|