Subticket Manager

osTicket-Plugin für Parent/Child-Tickets: Panel in der Ticket-Ansicht, Verknüpfen und Trennen per Ticketnummer, Subtickets mit Auto-Verknüpfung, Queue-Indikator, Übersichtsseite und AJAX-Schnittstelle.

English Version

Zurück zu osTicket Plugins

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.

graph LR
    A["Ticket-Ansicht im Staff-Bereich"] --> B["Panel per Signal object.view"]
    B --> C["scp/ajax-subticket.php"]
    D["Ticket-Warteschlange"] --> E["queue-indicator.js"]
    E --> C
    C --> F["HierarchyService"]
    F --> G["ost_ticket.ticket_pid"]

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.