¶ Subticket Manager
Live Demo: Teste alle Plugins für OXID eShop, Shopware und osTicket von Markus Michalski live — ohne Installation, ohne Risiko. demo.markus-michalski.net
Diese Dokumentation beschreibt immer die aktuell veröffentlichte Version.
¶ Überblick
osTicket speichert Parent/Child-Beziehungen zwischen Tickets bereits in der Spalte ticket_pid, bietet dafür aber keine Bedienoberfläche. Der Subticket Manager ergänzt sie für Agents: ein Panel in der Ticket-Ansicht zum Verknüpfen, Trennen und Anlegen von Subtickets, ein Badge und ein Icon für Parent-Tickets in der Warteschlange sowie eine Übersichtsseite aller Beziehungen.
Das Plugin verwaltet Beziehungen, aber keinen Workflow: Es schließt, verschiebt oder weist keine Tickets automatisch zu. Die Beziehungen liegen in der osTicket-Spalte
ticket_pid, nicht in eigenen Tabellen.
¶ Dokumentation
| Seite | Inhalt |
|---|---|
| Installation | Release-ZIP oder Git mit Composer, Aktivierung, Dateien in scp/, Update, Deinstallation |
| Konfiguration | Die eine wirksame Option, Felder ohne Wirkung, Debug-Modus |
| Verwendung | Panel, Subticket anlegen, verknüpfen, trennen, Queue-Indikator, Übersichtsseite, Berechtigungen |
| AJAX-API | Aktionen von ajax-subticket.php mit Parametern und Antworten |
| Erweitern und Integration | PHP-Methoden, Signale, Zusammenspiel mit API Endpoints |
| Technische Details | Ablauf, Dateistruktur, Datenbank-Änderungen, Regeln und Einschränkungen |
| Fehlerbehebung | Symptome, Ursachen und häufige Fragen |
¶ Funktionen
| Funktion | Beschreibung |
|---|---|
| Panel in der Ticket-Ansicht | Zeigt Parent und Children des Tickets über den Ticket-Tabs |
| Parent-Badge | „Parent Ticket (N Sub-Tickets)“ unter der Ticket-Überschrift |
| Verknüpfen und Trennen | Verknüpfen per Ticketnummer des Parents, Trennen vom Child oder vom Parent aus |
| Subticket anlegen | Öffnet das Formular für ein neues Ticket und verknüpft das Ergebnis automatisch |
| Queue-Indikator | Code-Fork-Icon mit Anzahl der Children in der Warteschlange |
| Übersichtsseite | Liste der bestehenden Beziehungen (höchstens 100 Child-Tickets) unter Applications → Subtickets |
| Schleifenschutz | Verhindert, dass ein Ticket sein eigener Vorfahre wird (bis zehn Ebenen geprüft) |
| AJAX-Schnittstelle | Aktionen children, link, unlink, create, batch_parent_status und version. CSRF-Schutz für link, unlink und create, Rate-Limit für children, link, unlink und create |
| Zusammenspiel mit API Endpoints | Die Subticket-Endpunkte der REST-API nutzen die PHP-Methoden dieses Plugins |
¶ Anforderungen
| Anforderung | Version | Hinweise |
|---|---|---|
| osTicket | 1.18.x | Nutzt die Spalte ticket_pid und die Signale von osTicket |
| PHP | 7.4 oder neuer | Die CI prüft 7.4 bis 8.3 |
| Datenbank | MySQL oder MariaDB | Tabellenpräfix ost_ |
| Dateirechte | Schreibzugriff auf scp/ |
Für das Kopieren der drei Plugin-Dateien |
| Composer | nur beim Git-Weg | Das Release-ZIP bringt den Autoloader mit |
¶ Lizenz
GNU General Public License v2, kompatibel mit osTicket. Siehe LICENSE.
¶ Support
Fehler und Fragen im Issue Tracker. Gib dabei osTicket-Version, PHP-Version, Plugin-Version, Fehlermeldungen aus der Browser-Konsole und die Schritte zur Reproduktion an.