diff --git a/README.md b/README.md index 23f30fe..fb38567 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,112 @@ -# wp-multi-ticket +# WP Multi Ticket Pro 🚀 +Ein leistungsstarkes und einfaches Ticket- und Support-System für WordPress. +Es ermöglicht Gästen (ohne Login), Tickets zu erstellen, und bietet Administratoren ein umfassendes Dashboard zur Verwaltung, Analyse und Kommunikation. + +--- + +## ✨ Features + +- **Gast-Tickets:** Besucher können Tickets erstellen, ohne sich registrieren zu müssen. +- **Frontend Integration:** Einfache Einbindung über Shortcodes auf beliebigen Seiten. +- **Intelligente Benachrichtigungen:** + - E-Mail-Benachrichtigungen an Admins und Kunden + - Discord & Telegram Integration für Echtzeit-Alerts +- **Analytics Dashboard:** Visuelle Auswertung (Charts) von Ticket-Statistiken, Arbeitslast und Statusverteilung direkt im Admin-Bereich +- **Ticket-Management:** + - Status- und Prioritätsverwaltung + - Zuweisung an spezifische Abteilungen oder Mitarbeiter + - Interne Notizen (für Mitarbeiter) vs. öffentliche Antworten +- **CSV-Export:** Exportieren Sie alle Tickets zur externen Analyse +- **Textbausteine:** Erstellen Sie Vorlagen für schnelle Antworten +- **Datei-Uploads:** Kunden und Admins können Dateien an Tickets anhängen +- **Auto-Updates:** Das Plugin prüft automatisch auf Updates (über Gitea) + +--- + +## 📦 Installation + +1. Laden Sie das Plugin-Verzeichnis (`wp-multi-ticket`) in den `/wp-content/plugins/` Ordner Ihrer WordPress-Installation hoch, oder installieren Sie es direkt über das WordPress Plugin-Menü ("ZIP hochladen"). +2. Aktivieren Sie das Plugin im WordPress "Plugins" Menü. +3. Gehen Sie zu **Einstellungen > Permalinks** und klicken Sie einmal auf "Änderungen speichern", um sicherzustellen, dass die Links funktionieren. + +--- + +## 🚀 Nutzung (Shortcodes) + +### Ticket erstellen +Fügen Sie diesen Shortcode auf einer Seite ein (z.B. "Support"), wo Kunden neue Tickets eröffnen sollen: + +```text +[wmt_form] +``` + +### Ticket-Status suchen +Fügen Sie diesen Shortcode ein, damit Kunden ihre offenen Tickets über ihre E-Mail-Adresse finden können: + +```text +[wmt_lookup] +``` + +### Ticket-Ansicht +Dieser Shortcode ist meist nicht nötig manuell einzufügen, da Kunden automatisch per E-Mail-Link zu ihrer Ticket-Ansicht weitergeleitet werden: + +```text +[wmt_view] +``` + +--- + +## ⚙️ Konfiguration + +Nach der Installation finden Sie im WordPress-Menü den Punkt **"Tickets Pro"**. + +### 1. Einstellungen +Hier passen Sie das System an Ihre Bedürfnisse an: + +- **Kategorien & Abteilungen:** Definieren Sie Themenbereiche und weisen Sie sie Abteilungen zu. +- **Status & Prioritäten:** Legen Sie fest, welche Stati (z.B. *Offen*, *In Bearbeitung*) und Prioritäten verfügbar sind. +- **Textbausteine:** Erstellen Sie Vorlagen für häufige Antworten (öffentlich oder intern). +- **Datei-Uploads:** Legen Sie fest, welche Dateitypen (z.B. pdf, jpg) erlaubt sind. + +### 2. Benachrichtigungen +Verbinden Sie Ihre Favoriten-Apps, um nie ein Ticket zu verpassen: + +- **Discord Webhook URL:** Fügen Sie Ihre Discord-Webhook-URL für Push-Nachrichten in einen Channel ein. +- **Telegram Bot:** Token und Chat ID eingeben für Telegram-Benachrichtigungen. +- **Zusätzliche User:** Wählen Sie spezifische WordPress-Benutzer aus, die bei jedem neuen Ticket per E-Mail benachrichtigt werden sollen. + +### 3. Analytics +Unter dem Menüpunkt **Analytics** sehen Sie Diagramme zu: + +- Gesamtanzahl der Tickets +- Offene vs. geschlossene Tickets +- Tickets der letzten 30 Tage +- Workload pro Mitarbeiter (Agent Performance) + +--- + +## 📄 Admin-Funktionen + +Im Dashboard finden Sie eine Übersicht offener Tickets. + +- **Antworten:** Nutzen Sie den WordPress Editor für formatierte Antworten. +- **Interne Notizen:** Schreiben Notizen, die nur für andere Admins sichtbar sind. +- **Drucken:** Erstellen Sie ein sauberes PDF/Print-Layout eines Tickets für Akten. +- **Export:** Nutzen Sie den *CSV Export* Button oben in der Liste, um Daten zu sichern. + +--- + +## 🔄 Updates + +Das Plugin enthält einen eingebauten **Update-Checker**. +Sollte eine neue Version auf **Gitea** veröffentlicht werden, sehen Sie oben im Admin-Bereich eine Hinweismeldung mit einem Download-Link. + +--- + +## 🆘 Support + +Bei Fragen oder Problemen kontaktieren Sie bitte: + +- **Telegram Support:** [t.me/M_Viper04](https://t.me/M_Viper04) +- **Web:** [m-viper.de](https://m-viper.de)