Ticketverkauf & Sitzplätze — Vollständiger Leitfaden

Überblick

DataFirefly Ticketverkauf & Sitzplätze verwandelt jedes PrestaShop-Produkt in ein Event-Ticket. Das Modul beherrscht zwei Event-Typen (freie Platzwahl oder feste Sitzplätze), einen visuellen Saalplan, die Erzeugung von QR-Tickets zum Download als PDF und einen Einlasskontroll-Bildschirm per Scan. Die Kernidee: Jede Platzkategorie ist eine Produktkombination, sodass PrestaShop Preise, Steuern und Rechnungsstellung nativ übernimmt.

Installation

1. Laden Sie das Archiv dfeventtickets.zip aus Ihrem DataFirefly-Konto herunter.
2. Gehen Sie im Back-Office zu Module > Modul-Manager, klicken Sie auf Modul hochladen und legen Sie die ZIP-Datei ab.
3. Das Modul installiert sich automatisch: Es erstellt seine Tabellen, seine Menü-Tabs (unter Kunden > DataFirefly Ticketing) und registriert seine Hooks.
4. Leeren Sie nach der Installation den PrestaShop-Cache (Erweiterte Einstellungen > Leistung > Cache leeren).

Kernkonzepte

Produkt = Ticket

Sie erstellen zunächst ein Standard-PrestaShop-Produkt (das „Ticket“) und verknüpfen es dann mit einem Event. Alles rund um Preis, MwSt. und Rechnungsstellung bleibt in PrestaShop.

Preiszone = Kombination

Jede Zone (Gold-Rang, Balkon, Innenraum …) verweist auf eine Produktkombination (id_product_attribute) oder auf den Basispreis. Das sorgt für korrekte Summen und Rechnungen, ohne parallele Berechnung.

Zwei Event-Typen

• Freie Platzwahl (general): Der Kunde wählt eine Kategorie und eine Menge über den nativen Kaufblock.
• Feste Sitzplätze (seated): Der Kunde wählt seinen Platz auf einem interaktiven Saalplan.

Ein Event anlegen

Gehen Sie zu Kunden > DataFirefly Ticketing > Events und klicken Sie auf Event hinzufügen. Geben Sie an:

• das verknüpfte Produkt;
• den Typ (freie Platzwahl oder feste Sitzplätze);
• die Daten für Beginn und Ende (Format JJJJ-MM-TT HH:MM:SS) und die Zeitzone;
• die Kapazität (bei freier Platzwahl);
• die Reservierungsdauer (Minuten, in denen ein gewählter Platz gesperrt bleibt, standardmäßig 15);
• den Status aktiv.

Preiszonen definieren

Sobald das Event gespeichert ist, erscheint das Panel Preiszonen unter dem Formular. Geben Sie für jede Zone einen Namen, die zugehörige Produktkombination (oder den Basispreis) und eine Anzeigefarbe an. Der tatsächliche Preis wird aus der PrestaShop-Kombination gelesen.

Den Saalplan zeichnen

Öffnen Sie bei Events mit Sitzplätzen Saalplan zeichnen. Der visuelle Editor erlaubt:

• einen Block von Sitzen erzeugen (Reihen × Spalten, mit konfigurierbarer erster Reihe und erster Nummer), einer Zone zugeordnet;
• einen Sitz per Drag-and-drop verschieben;
• einen Sitz aktivieren/deaktivieren (Klick) — ein deaktivierter Sitz wird nicht verkauft;
• einen Sitz löschen (Doppelklick);
• alles löschen, um neu zu beginnen.

Die Leiste „BÜHNE / EINGANG“ dient Ihren Kunden als Orientierungshilfe.

Im Shop: ein Ticket kaufen

Auf der Produktseite fügt das Modul automatisch das passende Widget ein:

• Feste Sitzplätze: ein interaktiver Plan, auf dem Zonen farbig, belegte Plätze ausgegraut und freie Plätze anklickbar sind. Der Kunde wählt einen oder mehrere Plätze; jede Auswahl fügt die passende Kombination dem Warenkorb hinzu und reserviert den Platz vorübergehend.
• Freie Platzwahl: ein Verfügbarkeits-Hinweis; der Kauf erfolgt über den nativen Mengenblock.

QR- & PDF-Tickets

Sobald die Bestellung validiert und bezahlt ist, erzeugt das Modul ein Ticket pro tatsächlich bezahltem Platz, jeweils mit einem eindeutigen Zufalls-Token, das als QR-Code codiert ist. Der Kunde lädt seine Tickets als PDF (ein Ticket pro Seite) aus den Bestelldetails oder seinem Kundenkonto herunter. Ist TCPDF nicht verfügbar, wird ein druckbarer HTML-Fallback angeboten.

Einlasskontrolle (Scan)

Öffnen Sie am Veranstaltungstag Kunden > DataFirefly Ticketing > Scan. Zwei Modi:

• Kamera: Starten Sie die Kamera und halten Sie den Ticket-QR davor;
• Manuelle Eingabe: Fügen Sie den Ticket-Code ein oder tippen Sie ihn.

Das Ergebnis wird farbig angezeigt (gültig, bereits verwendet, storniert, ungültig), und ein Protokoll der letzten Scans hilft dem Einlasspersonal. Ein validiertes Ticket wechselt zu verwendet und kann nicht erneut genutzt werden.

Lebenszyklus eines Tickets

• reserved: Platz gewählt, bis zum Ablauf der Reservierung gesperrt;
• valid: Bestellung bezahlt und abgeglichen (nur tatsächlich bezahlte Plätze werden gültig);
• used: Ticket am Einlass gescannt;
• cancelled: Bestellung storniert oder erstattet;
• expired: nicht bestätigte Reservierung, die abgelaufen ist.

Tickets im Back-Office verwalten

Der Tab Tickets listet alle Tickets mit Event, Platz, Kunde, Bestellung, Status und Ausgabedatum auf. Die Liste ist filterbar und unterstützt die Sammelstornierung. Ein Filter pro Event ist über das Zonen-Panel verfügbar.

Kompatibilität & technische Hinweise

• PrestaShop 8.0 bis 9.x, Multistore, mehrsprachig (FR, EN, ES, DE, IT);
• PHP 7.4 bis 8.3;
• ModuleAdminController-Controller (PS8/9-Kompatibilität, ohne Symfony-Controller);
• QR (MIT-Bibliothek) und PDF (natives TCPDF) integriert, keine Composer-Abhängigkeit.

Fehlerbehebung

Das Auswahl-Widget erscheint nicht auf der Produktseite

Prüfen Sie, ob das Event aktiv und mit dem richtigen Produkt verknüpft ist und ob das Modul korrekt an die Hooks der Produktseite angebunden ist. Leeren Sie den Cache.

Nach Installation oder Update erscheint eine leere Seite

Leeren Sie den PrestaShop-Cache, um den Klassenindex neu aufzubauen, und laden Sie den Bildschirm neu.

Die Kamera startet auf dem Scan-Bildschirm nicht

Das Kamera-Scannen erfordert einen sicheren Kontext (HTTPS) und die Erlaubnis für den Kamerazugriff. Andernfalls verwenden Sie die manuelle Code-Eingabe.

Preise oder Steuern wirken falsch

Stellen Sie sicher, dass jede Zone auf die richtige Produktkombination verweist: PrestaShop berechnet Preis und MwSt. aus dieser Kombination.