QR-Kasse

🎯 Überblick

QR-Kasse ist ein WordPress-Plugin, das ein vollständiges, QR-Code-basiertes Kassensystem für Veranstaltungen, Konzerte und Festivals bereitstellt. Mit einer integrierten Mobile App können Ihre Gäste schnell und sicher bargeldlos bezahlen.

⚙️ Installation für Administratoren

Systemvoraussetzungen

Schritt-für-Schritt Installation

1. Plugin herunterladen
   Laden Sie die aktuelle Version herunter: qr-kasse-v4.0.0-CLEAN.zip
2. In WordPress installieren
   Navigieren Sie zu Plugins → Installieren → Plugin hochladen
   Wählen Sie die ZIP-Datei aus und klicken Sie auf "Installieren"
   [Screenshot: WordPress Plugin-Installation]
3. Plugin aktivieren
   Nach der Installation klicken Sie auf "Plugin aktivieren"
   Im Admin-Menü erscheint der neue Punkt "QR-Kasse"
4. Kategorien anlegen
   Gehen Sie zu QR-Kasse → Kategorien
   Erstellen Sie Ihre Produktkategorien (z.B. Getränke, Speisen)
   [Screenshot: Kategorien-Verwaltung mit Drag & Drop]
5. Produkte hinzufügen
   Navigieren Sie zu QR-Kasse → Produkte
   Fügen Sie Ihre Produkte mit Namen, Preis und Kategorie hinzu
   [Screenshot: Produkt-Verwaltung mit Beispielprodukten]

Mobile App konfigurieren

1. Öffnen Sie QR-Kasse → Einstellungen → Mobile App
2. Konfigurieren Sie:
   • Venue Name: Name Ihrer Veranstaltung
   • App Titel: Titel der Mobile App
   • Theme-Farbe: Ihre Markenfarbe (Hex-Code)
   • Währung: CHF, EUR, USD etc.
3. Aktivieren Sie "App regenerieren" ✅
4. Klicken Sie auf "Einstellungen speichern"

QR-Codes generieren und drucken

Batch-Generierung

1. Gehen Sie zu QR-Kasse → QR-Codes
2. Geben Sie ein:
   • Anzahl Karten: z.B. 100
   • Startnummer: z.B. 1
   • Event-Name: Optional
   • Datum: Event-Datum
3. Klicken Sie auf "Karten generieren"

Drucken der QR-Codes

Nach der Generierung erscheint automatisch der Button "🖨️ QR-Codes drucken (neues Fenster)"

• Öffnet ein sauberes Druckfenster ohne WordPress-Navigation
• 4 QR-Codes pro Reihe im A4-Format
• Drucken mit Strg+P (Windows) oder Cmd+P (Mac)

📱 Bedienungsanleitung für Verkaufspersonal

Bar-Verkauf über Webinterface

Zugang zum System

1. Öffnen Sie im Browser: https://ihre-domain.de/vwt-verkauf/
2. Falls PIN-Schutz aktiviert: 4-stelligen PIN eingeben

Bestellung aufnehmen - Schritt für Schritt

1. Produkte auswählen
   Klicken Sie auf + bei jedem gewünschten Produkt
   Die Menge können Sie mit + und - anpassen
2. Gesamtpreis prüfen
   Der Gesamtbetrag wird automatisch berechnet und angezeigt
3. QR-Code scannen
   
   • Klicken Sie auf "📷 Scanner starten"
   • Erlauben Sie Kamera-Zugriff (einmalig)
   • Halten Sie den QR-Code des Gastes vor die Kamera
   [Screenshot: Aktiver QR-Scanner mit Kamera-Ansicht]
4. Alternative: Manuelle Eingabe
   Falls der Scanner nicht funktioniert, geben Sie den Code manuell ein
5. Bestellung speichern
   Klicken Sie auf "Speichern" - Die Bestellung wird automatisch verbucht

Mobile App für Smartphones

Installation auf dem Smartphone

Mit der App arbeiten

• App öffnen: Tippen Sie auf das App-Icon auf dem Homescreen
• Produkte wählen: Tippen Sie auf die Produktkarten
• Menge anpassen: Mit + und - Buttons
• QR scannen: "Scanner" Button für Kamera
• Offline-Modus:
  • 🟢 Grüner Punkt = Online
  • 🔴 Roter Punkt = Offline (Daten werden gespeichert)
  • Automatische Synchronisation bei Verbindung

📊 Tagesabschluss und Berichte

Tagesabschluss durchführen

1. Navigieren Sie zu QR-Kasse → Tagesabschluss
2. Wählen Sie das gewünschte Datum
3. Klicken Sie auf "Bericht generieren"

Verfügbare Berichte

Export-Optionen

• CSV-Export: Für Excel-Auswertungen
• PDF-Druck: Über Browser-Druckfunktion
• Archivierung: Automatische Speicherung in Datenbank

⚙️ Erweiterte Einstellungen

Event-Modus konfigurieren

Der Event-Modus schützt Ihr Kassensystem vor unbefugtem Zugriff:

Funktionen aktivieren/deaktivieren

In QR-Kasse → Einstellungen → System können Sie folgende Funktionen steuern:

• ✅ Offline-Modus: Service Worker für Offline-Betrieb
• ✅ QR-Scanner: Kamera-Scanner in der App
• ✅ Manuelle Eingabe: Backup für Scanner-Probleme
• ✅ Code-Sperrung: Verhindert Mehrfachnutzung von QR-Codes
• ✅ Kategorien: Gruppierung der Produkte
• ⬜ Digitale Quittungen: (In Entwicklung)

Mobile App personalisieren

🔧 Fehlerbehebung

Mobile App lädt keine Produkte

<IfModule mod_headers.c>
    Header set Access-Control-Allow-Origin "*"
    Header set Access-Control-Allow-Methods "GET, POST, OPTIONS"
    Header set Access-Control-Allow-Headers "Content-Type"
</IfModule>

QR-Scanner funktioniert nicht

• ✅ HTTPS-Zertifikat prüfen: Pflicht für Kamera-Zugriff
• ✅ Browser-Berechtigungen: Kamera-Zugriff erlauben
• ✅ Browser-Kompatibilität: Chrome, Safari, Firefox aktuell?
• ✅ Alternative: Manuelle QR-Code Eingabe aktivieren

Offline-Synchronisation klemmt

// Service Worker zurücksetzen (Browser-Konsole)
navigator.serviceWorker.getRegistrations()
  .then(regs => regs.forEach(reg => reg.unregister()));
  
// Cache löschen
caches.keys()
  .then(names => names.forEach(name => caches.delete(name)));

Druckprobleme bei QR-Codes

• Verwenden Sie den "🖨️ QR-Codes drucken" Button
• Nicht direkt aus der WordPress-Seite drucken
• Chrome/Edge empfohlen für beste Druckqualität
• A4-Format, 100% Skalierung einstellen

📞 Support & Kontakt

Bei Support-Anfragen bitte angeben:

Debug-Modus aktivieren

In wp-config.php hinzufügen:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Logs finden Sie dann unter: wp-content/debug.log

🔄 Changelog

Version 4.0.0 CLEAN (Oktober 2024)

• ✨ Komplettes Rebranding zu "QR-Kasse"
• 🖨️ Verbesserte Druckfunktion ohne WordPress-Navigation
• 📱 Optimierte Mobile App Performance
• 🐛 Bugfixes und Stabilität

Version 3.5.1

• 🔧 PWA-Installation korrigiert
• 📄 Einfache Druckfunktion hinzugefügt

Version 3.0.0

• 🚀 Initial Release
• 📱 Mobile App integriert
• 🔌 Offline-Support