i-ticket API PLUS WordPress Plugin

Version 2.0 - Erweiterte Multi-Event-Unterstützung

🚀 Neue Features in Version 2.0

Multi-Event-Support

Das Plugin unterstützt jetzt mehrere Events von einem Organizer gleichzeitig:

• Separate Event-Konfigurationen mit eindeutigen Slugs
• Event-spezifische Einstellungen (Button-Text, Booking Lock)
• Individuelle Produktmappings pro Event
• Rückwärtskompatibilität mit Version 1.0

📋 Installation

1. Ordner i-ticket-api-plus in das WordPress Plugin-Verzeichnis kopieren
2. Plugin in der WordPress-Administration aktivieren
3. Unter "i-ticket API PLUS" die Grundkonfiguration vornehmen

⚙️ Konfiguration

Globale Einstellungen

• API Token: Ihr i-ticket.app API Token
• Organizer: Ihr Organizer-Bezeichner

Event-Verwaltung

Jedes Event benötigt:

• Event Slug: Eindeutige Kennung (z.B. oktoberfest-2024)
• Event Name: Anzeigename (z.B. Oktoberfest 2024)
• Event ID: i-ticket Event-ID
• Button Text: Individueller Text für Buchungsbuttons
• Booking Lock: Event-spezifische Buchungssperre

📄 Shortcodes

Alle Shortcodes unterstützen den optionalen event_slug Parameter:

Event-Informationen

// Standard (verwendet globale Einstellungen)
[i_ticket_events]

// Event-spezifisch
[i_ticket_events event_slug="oktoberfest-2024"]

Event-Liste / Programm

[i_ticket_subevents]
[i_ticket_subevents event_slug="weihnachtsmarkt-2024"]

Interaktiver Slider

[i_ticket_api_slider]
[i_ticket_api_slider event_slug="oktoberfest-2024"]

Event-Button (einzeln)

[i_ticket_event_button subevent_id="1844"]
[i_ticket_event_button subevent_id="1844" event_slug="oktoberfest-2024"]

Allgemeiner Button

[i_ticket_button variant="primary" link="/buchung" size="md"]

Produkt-Preis anzeigen

[i_ticket_product name="Produktname"]
[i_ticket_product name="Bier Token" event_slug="oktoberfest-2024"]

🛠️ Produktverwaltung

Event-spezifische Produkte

1. Event in der Dropdown auswählen
2. Produktname eingeben
3. Pretix-Produkt aus der Event-spezifischen Liste wählen
4. Speichern

Das System lädt automatisch die verfügbaren Produkte für das ausgewählte Event.

🔄 Migration von Version 1.0

Das Plugin ist vollständig rückwärtskompatibel:

• Bestehende Shortcodes funktionieren ohne Änderungen
• Alte Konfiguration wird als Fallback verwendet
• Produkte ohne Event-Zuordnung werden als "Legacy" markiert

💡 Verwendungsbeispiele

Szenario: Zwei Events verwalten

Event 1: Oktoberfest 2024

• Slug: oktoberfest-2024
• Event ID: 123
• Button Text: "Maß bestellen"

Event 2: Weihnachtsmarkt 2024

• Slug: weihnachtsmarkt-2024
• Event ID: 456
• Button Text: "Glühwein kaufen"

Verwendung:

<!-- Oktoberfest Programm -->
[i_ticket_subevents event_slug="oktoberfest-2024"]

<!-- Weihnachtsmarkt Slider -->
[i_ticket_api_slider event_slug="weihnachtsmarkt-2024"]

<!-- Bier-Preis für Oktoberfest -->
[i_ticket_product name="Maß Bier" event_slug="oktoberfest-2024"]

<!-- Glühwein-Preis für Weihnachtsmarkt -->
[i_ticket_product name="Glühwein" event_slug="weihnachtsmarkt-2024"]

🎨 Styling

Das Plugin verwendet die bestehenden CSS-Klassen:

• .i-ticket-program - Event-Listen-Layout
• .i-ticket-slider - Slider-Layout
• .i-ticket-btn - Buttons
• .i-ticket-button - Erweiterte Buttons

🔧 Technische Details

Datenbankstruktur

• i_ticket_api_settings: Globale Einstellungen
• i_ticket_api_events: Event-Konfigurationen (Array mit Slugs als Keys)
• i_ticket_products: Produktmappings mit Event-Zuordnung

API-Endpunkte

Das Plugin nutzt die i-ticket.app REST API v1:

• Events: /api/v1/organizers/{organizer}/events/{event_id}/
• Subevents: /api/v1/organizers/{organizer}/events/{event_id}/subevents
• Produkte: /api/v1/organizers/{organizer}/events/{event_id}/items/

📞 Support

Bei Fragen oder Problemen:

• Entwickler: millenium lab GmbH
• Website: http://millenium.de
• Plugin URI: http://i-ticket.io/api

📝 Changelog

Version 2.0 (i-ticket API PLUS)

• ✅ Multi-Event-Support mit Event Slugs
• ✅ Event-spezifische Produktmappings
• ✅ Erweiterte Admin-Oberfläche
• ✅ AJAX-basierte Event-Verwaltung
• ✅ Rückwärtskompatibilität mit v1.0
• ✅ Verbesserte Shortcode-Dokumentation

Version 1.0 (i-ticket API)

• Basis-Event-Integration
• Einzelnes Event pro Installation
• Grundlegende Shortcodes
• Pretix-Produktintegration