¶ 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
¶ Inhaltsverzeichnis
- Systemanforderungen
- Installation
- Konfiguration
- Nutzung
- Admin-Interface
- API-Integration
- Fehlerbehebung
- Technische Details
- FAQ
¶ Überblick
Das Subticket Manager Plugin verwandelt osTickets versteckte Parent/Child-Ticket-Infrastruktur in ein voll funktionsfähiges, benutzerfreundliches Feature. Während osTicket die Datenbankstruktur (ticket_pid-Feld) und API-Methoden (isChild(), getPid()) bereitstellt, fehlt jegliche Benutzeroberfläche oder Workflow-Automatisierung.
Dieses Plugin bietet eine komplette Lösung für die Verwaltung hierarchischer Ticket-Beziehungen mit visuellen Indikatoren, Workflow-Automatisierung und einer intuitiven Oberfläche zum Erstellen und Verwalten von Subtickets.
Warum dieses Plugin unverzichtbar ist:
osTicket hat bereits die technische Grundlage für Parent/Child-Tickets im Kernsystem eingebaut, bietet aber:
- ❌ Keine Benutzeroberfläche zur Verwaltung von Beziehungen
- ❌ Keine visuellen Indikatoren in Ticket-Listen
- ❌ Keine Workflow-Automatisierung
- ❌ Keine einfache Möglichkeit, Subtickets zu erstellen oder zu verknüpfen
Dieses Plugin macht osTickets versteckte Parent/Child-Infrastruktur tatsächlich nutzbar für den täglichen Support-Betrieb.
¶ Hauptfunktionen
- ✅ Visuelle Parent-Indikatoren - Code-Fork-Icons in Queue-Listen zeigen Parent-Tickets auf einen Blick
- ✅ Parent-Badge - Prominentes Badge unter der Ticketnummer zeigt "Parent Ticket (X Sub-Tickets)"
- ✅ Integriertes Panel - Verwalte Parent/Child-Beziehungen direkt in der Ticket-Ansicht (erscheint über den Ticket-Tabs)
- ✅ Tickets verknüpfen/trennen - Verbinde bestehende Tickets oder erstelle neue Subtickets mit einem Klick
- ✅ Auto-Close-Workflow - Parent-Tickets schließen automatisch, wenn alle Children geschlossen sind (Phase 4 Feature)
- ✅ AJAX-basiert - Echtzeit-Updates ohne Seitenneuladungen, flüssige Benutzererfahrung
- ✅ Keine Core-Modifikationen - Nutzt osTickets native Infrastruktur (
ticket_pid), keine Änderungen an Core-Dateien - ✅ Queue Decoration - Automatische SQL-Query-Erweiterung für Parent-Ticket-Indikatoren in allen Queue-Ansichten
- ✅ Zirkuläre Abhängigkeiten verhindern - Verhindert, dass Tickets ihre eigenen Vorfahren werden
- ✅ Auto-Linking - Neue Tickets, die über "Subticket erstellen" erstellt wurden, werden automatisch mit dem Parent verknüpft
¶ Anwendungsfälle
- Komplexe Support-Anfragen - Große Probleme in handhabbare Teilaufgaben aufteilen (z.B. Server-Migration in DNS, Datentransfer, Testing)
- Mehrstufige Workflows - Fortschritt über zusammenhängende Tickets verfolgen (z.B. Onboarding: Account-Erstellung, Schulung, Equipment-Setup)
- Team-Zusammenarbeit - Arbeit auf mehrere Agents mit klarer Hierarchie verteilen (Parent-Ticket für Projektmanager, Subtickets für Team-Mitglieder)
- Projekt-Management - Parent-Tickets als Projekt-Container verwenden (z.B. "Website-Relaunch" mit Subtickets für Design, Entwicklung, Testing)
- Feature-Requests - Implementierung in verfolgbare Teilaufgaben aufteilen (z.B. Backend-API, Frontend-UI, Dokumentation)
- Bug-Tracking - Separate Tickets für Testing, Fixing und Dokumentation erstellen, dabei klare Beziehungen beibehalten
¶ Systemanforderungen
| Anforderung | Version | Hinweise |
|---|---|---|
| osTicket | 1.18.x | Plugin nutzt osTickets native ticket_pid-Infrastruktur |
| PHP | 7.4+ | Empfohlen: PHP 8.1+ für beste Performance |
| jQuery | Beliebig | In osTicket standardmäßig enthalten |
| Datenbank | MariaDB 10.3+ oder MySQL 5.7+ | Plugin erstellt zusätzliche Metadaten-Tabellen |
¶ Installation
¶ Schritt 1: Plugin-Dateien installieren
¶ Methode 1: ZIP-Download (Empfohlen)
- Lade das neueste Release von Releases herunter
- Entpacke die ZIP-Datei
- Lade den
subticket-manager-Ordner nach/include/plugins/auf deinem osTicket-Server hoch
Finaler Pfad: /pfad/zu/osticket/include/plugins/subticket-manager/
¶ Methode 2: Git Repository
cd /pfad/zu/osticket/include/plugins
git clone https://github.com/markus-michalski/osticket-subticket-manager.git
¶ Schritt 2: Plugin in osTicket aktivieren
- Melde dich im osTicket Admin Panel an
- Navigiere zu: Admin Panel → Verwalten → Plugins
- Finde "Subticket Manager" in der Plugin-Liste
- Klicke auf Aktivieren (oder Installieren bei Erstinstallation)
- Das Plugin wird automatisch:
- Eine Singleton-Instanz erstellen
- Admin-Seiten deployen (
scp/subtickets.php,scp/apps.php) - AJAX-Handler deployen (
scp/ajax-subticket.php) - Datenbank-Tabellen und Indizes erstellen
¶ Schritt 3: Installation überprüfen
-
Admin-Interface prüfen:
- Navigiere zum Anwendungen-Tab im Staff-Panel
- Du solltest den Eintrag "Subticket Hierarchies" sehen
-
Ticket-Ansicht prüfen:
- Öffne ein beliebiges Ticket
- Scrolle nach unten - du solltest das Panel "Parent Ticket / Child Tickets" über den Ticket-Tabs sehen
-
Queue-Indikatoren prüfen:
- Erstelle ein Parent-Ticket mit mindestens einem Child
- Gehe zur Ticket-Queue (Tickets → Offen)
- Parent-Tickets sollten ein Code-Fork-Icon mit Child-Count anzeigen
¶ Konfiguration
Das Plugin benötigt keine Konfiguration - es funktioniert sofort nach Aktivierung mit osTickets nativer Parent/Child-Infrastruktur.
Alle Features werden automatisch beim Plugin-Start aktiviert:
- ✅ Visuelle Indikatoren in Queue-Listen
- ✅ Parent-Badge in Ticket-Ansicht
- ✅ Verknüpfen/Trennen-Funktionalität
- ✅ Subticket-Erstellungs-Workflow
- ✅ Auto-Linking für neue Subtickets
Optionale Einstellungen:
- Debug-Modus: Setze
SUBTICKET_DEBUG = trueinclass.SubticketPlugin.php(Zeile 8) für detailliertes Logging nach/tmp/subticket-debug.log - Auto-Close: Konfigurierbar in zukünftigen Versionen (aktuell Phase 4 Feature)
¶ Nutzung
¶ Ein Subticket erstellen
Vom Parent-Ticket aus:
- Öffne das Parent-Ticket im Staff-Interface
- Scrolle zum Bereich "Child Tickets"
- Klicke auf "Subticket erstellen"
- Du wirst zum "Neues Ticket"-Formular weitergeleitet (
tickets.php?a=open&subticket_parent=15) - Fülle die Ticket-Details aus und erstelle das Ticket
- Das neue Ticket wird automatisch mit dem Parent verknüpft (via
model.createdSignal-Handler)
¶ Ein bestehendes Ticket verknüpfen
Option 1: Vom Child-Ticket aus
- Öffne das Ticket, das du zum Child machen möchtest
- Klicke auf "Mit Parent verknüpfen" im Bereich "Parent Ticket"
- Gib die Parent-Ticketnummer oder -ID ein (z.B. "181752")
- Klicke auf "Verknüpfen" zum Bestätigen
- Panel aktualisiert sich und zeigt die Parent-Beziehung an
Option 2: Vom Parent-Ticket aus
- Öffne das Parent-Ticket
- Im Bereich "Child Tickets" kannst du über das Admin-Interface bestehende Tickets verknüpfen
- Navigiere zu Anwendungen → Subticket Hierarchies für Batch-Operationen
¶ Tickets trennen
Vom Child-Ticket aus:
- Öffne das Child-Ticket
- Klicke im Bereich "Parent Ticket" auf "Von Parent trennen"
- Bestätige die Aktion
- Beziehung wird entfernt (
ticket_pidauf NULL gesetzt)
Vom Parent-Ticket aus:
- Öffne das Parent-Ticket
- Klicke in der "Child Tickets"-Liste auf "Trennen" neben einem Child
- Bestätige die Aktion
¶ Visuelle Indikatoren
Queue-Listen:
- Parent-Tickets zeigen ein Code-Fork-Icon mit Child-Count
- Bewege die Maus über das Icon für den Tooltip: "X Sub-Ticket(s)"
- Indikator wird per JavaScript (
queue-indicator.js) über AJAX-Endpoint hinzugefügt - Funktioniert in allen Queue-Ansichten (Offen, Geschlossen, Meine Tickets, etc.)
Ticket-Ansicht:
- Parent-Tickets zeigen ein prominentes blaues Badge unter der Ticketnummer:
Parent Ticket (3 Sub-Tickets) - Badge ist mit blauem Hintergrund und Rand gestylt (
background: #e8f4f8; border-left: 4px solid #1e90ff) - Badge erscheint im Panel "Parent Ticket / Child Tickets"
¶ Admin-Interface
¶ Subticket Hierarchies Seite
Navigiere zu: Anwendungen → Subticket Hierarchies (scp/subtickets.php)
Features:
- Übersichts-Dashboard - Zeigt alle Parent-Tickets mit Child-Counts
- Hierarchie-Baum-Ansicht - Visuelle Darstellung von Ticket-Beziehungen
- Batch-Operationen - Mehrere Tickets auf einmal verknüpfen/trennen
- Suchen & Filtern - Parent-Tickets nach Nummer, Betreff oder Status finden
¶ API-Integration
¶ AJAX-Endpunkte
Das Plugin bietet eigenständige AJAX-Endpunkte für Frontend-Operationen:
Basis-URL: /scp/ajax-subticket.php
¶ 1. Ticket mit Parent verknüpfen
POST /scp/ajax-subticket.php?action=link
Content-Type: application/x-www-form-urlencoded
child_id=123&parent_number=181752&__CSRFToken__=abc123
Antwort:
{
"success": true,
"message": "Ticket linked successfully"
}
¶ 2. Ticket von Parent trennen
POST /scp/ajax-subticket.php?action=unlink
Content-Type: application/x-www-form-urlencoded
child_id=123&__CSRFToken__=abc123
Antwort:
{
"success": true,
"message": "Ticket unlinked successfully"
}
¶ 3. Parent-Ticket-Status abrufen (Batch)
GET /scp/ajax-subticket.php?action=batch_parent_status&ticket_ids=15,16,17
Antwort:
{
"15": {"isParent": true, "childCount": 3},
"16": {"isParent": false, "childCount": 0},
"17": {"isParent": true, "childCount": 1}
}
¶ Fehlerbehebung
¶ Problem: Parent-Indikatoren werden nicht in Queue-Listen angezeigt
Symptome:
- Queue-Listen zeigen Tickets, aber keine Code-Fork-Icons
- Konsole zeigt keine Fehler
Prüfen:
- Browser-Cache leeren (Strg+Umschalt+R)
- Browser-Konsole auf JavaScript-Fehler prüfen:
// DevTools öffnen (F12) → Console-Tab // Nach Fehlern von queue-indicator.js suchen - jQuery-Verfügbarkeit prüfen:
// In Browser-Konsole: typeof jQuery // Sollte "function" zurückgeben - Debug-Modus aktivieren:
// In Browser-Konsole: SubticketPanel.debug = true - AJAX-Endpunkt prüfen:
curl "http://osticket.local/scp/ajax-subticket.php?action=batch_parent_status&ticket_ids=15"
¶ Problem: "Kein Parent-Ticket" angezeigt, aber Beziehung existiert in Datenbank
Symptome:
- Panel zeigt "Kein Parent-Ticket"
- Datenbank-Abfrage zeigt, dass
ticket_pidNICHT NULL ist
Prüfen:
-
Datenbank-Beziehung verifizieren:
SELECT ticket_id, number, ticket_pid, status_id FROM ost_ticket WHERE ticket_id = 123; -
Prüfen, ob Parent-Ticket existiert:
SELECT * FROM ost_ticket WHERE ticket_id = ( SELECT ticket_pid FROM ost_ticket WHERE ticket_id = 123 ); -
Trennen und erneut verknüpfen:
- Auf "Von Parent trennen" klicken
- Seite neu laden
- Auf "Mit Parent verknüpfen" klicken und Parent-Nummer erneut eingeben
-
Join-Query im Plugin-Code prüfen:
/tmp/subticket-debug.logöffnen (wenn Debug-Modus aktiviert)- Nach SQL-Query-Fehlern suchen
¶ Problem: Panel nicht sichtbar in Ticket-Ansicht
Symptome:
- Ticket öffnet sich normal, aber kein "Parent Ticket / Child Tickets"-Bereich
Prüfen:
-
Plugin ist aktiviert:
- Admin Panel → Verwalten → Plugins
- "Subticket Manager" sollte "Aktiviert" anzeigen
-
Browser-Cache leeren (könnte durch altes CSS verborgen sein)
-
Prüfen, ob Panel collapsed ist:
- Im Seitenquelltext nach
<div class="subticket-panel section-break">suchen (F12 → Elements)
- Im Seitenquelltext nach
-
Verifizieren, dass du im Staff-Interface bist:
- Panel erscheint nur für Staff-Mitglieder, nicht im Client-Portal
-
Signal-Registrierung prüfen:
- Debug-Modus aktivieren:
define('SUBTICKET_DEBUG', true); /tmp/subticket-debug.logprüfen auf:Signal registered: object.view for ticket view integration onTicketView() called: Object: Ticket
- Debug-Modus aktivieren:
¶ Problem: Kann kein Subticket erstellen
Symptome:
- Klick auf "Subticket erstellen" passiert nichts
- Weiterleitung zum neuen Ticket-Formular, aber Ticket wird nicht mit Parent verknüpft
Prüfen:
-
Du hast Berechtigung, Tickets zu erstellen:
- Admin Panel → Agents → Dein Agent → Berechtigungen
- "Tickets erstellen" sollte aktiviert sein
-
Parent-Ticket ist nicht geschlossen:
- Geschlossene Tickets sollten keine Subticket-Erstellung erlauben (prüfe
tickets.php?a=open&subticket_parent=X)
- Geschlossene Tickets sollten keine Subticket-Erstellung erlauben (prüfe
-
Apache Error Log prüfen:
tail -f /var/log/apache2/error.log -
Session-Storage-Problem:
- Prüfen, ob
$_SESSION['subticket_parent']nach Button-Klick gesetzt ist - Debug-Logging aktivieren und
/tmp/subticket-debug.logprüfen:Stored subticket_parent in session: 15 Auto-linking ticket: Child: 456, Parent: 15
- Prüfen, ob
¶ Problem: Badge erscheint mehrfach
Symptome:
- Mehrere "Parent Ticket (X Sub-Tickets)"-Badges in Ticket-Ansicht
Lösung:
- Auf v1.5.1 oder höher updaten - Dieses Problem wurde durch Verhinderung doppelter Panel-Instanzen behoben
- Nach Update Browser-Cache leeren (Strg+Umschalt+R)
Falls Problem weiterhin besteht:
- JavaScript-Fehler in Konsole prüfen (könnte Panel mehrfach einfügen)
- Verifizieren, dass Plugin nicht doppelt geladen wird (prüfe
include/plugins/auf Duplikate)
¶ Problem: Zirkuläre Abhängigkeit-Fehler beim Verknüpfen
Symptome:
- Fehler: "Circular dependency detected"
- Kann Ticket A nicht mit Ticket B verknüpfen
Erklärung:
Das Plugin verhindert zirkuläre Abhängigkeiten, um die Baumintegrität zu wahren. Beispiel:
- Ticket A ist Parent von B
- Ticket B ist Parent von C
- Du kannst Ticket C NICHT zum Parent von A machen (würde eine Schleife erstellen)
Lösung:
- Überprüfe deine Ticket-Hierarchie
- Trenne bei Bedarf Zwischen-Beziehungen
- Strukturiere Tickets als Baum (nicht als Graph)
¶ Problem: Datenbank-Fehler beim Aktivieren
Symptome:
- Plugin-Aktivierung schlägt fehl
- Fehler: "Table already exists" oder "Column already exists"
Prüfen:
-
Bestehende Tabellen prüfen:
SHOW TABLES LIKE 'ost_ticket_hierarchy_metadata'; SHOW TABLES LIKE 'ost_ticket_progress'; -
Bestehende Spalten prüfen:
SHOW COLUMNS FROM ost_ticket LIKE 'version'; -
Plugin behandelt Duplikate bereits - Bei fehlgeschlagener Aktivierung Apache Error Log auf spezifische SQL-Fehler prüfen
-
Manuelles Cleanup (falls nötig):
-- VORSICHT: Nur bei Neuinstallation ausführen! DROP TABLE IF EXISTS ost_ticket_hierarchy_metadata; DROP TABLE IF EXISTS ost_ticket_progress; ALTER TABLE ost_ticket DROP COLUMN IF EXISTS version;
¶ Technische Details
¶ Architektur
Plugin-Struktur:
subticket-manager/
├── plugin.php # Plugin-Metadaten
├── class.SubticketPlugin.php # Haupt-Plugin-Klasse
├── config.php # Plugin-Konfigurationsklasse
├── queue-decoration.php # Queue-SQL-Erweiterung (ParentTicketDecoration)
├── ajax/
│ └── SubticketAjaxAPI.php # AJAX-Endpunkt-Handler (Legacy)
├── scp-files/
│ ├── subtickets.php # Admin-Interface-Seite (deployed nach scp/)
│ ├── apps.php # Anwendungs-Übersichtsseite
│ └── ajax-subticket.php # Eigenständiger AJAX-Handler
├── js/
│ ├── subticket-panel.js # Frontend-Panel-Interaktionen
│ └── queue-indicator.js # Queue-Listen Parent-Indikatoren
├── services/
│ ├── SubticketService.php # Business-Logic-Layer
│ └── SubticketCreator.php # Ticket-Erstellungs-Service
├── repositories/
│ └── SubticketRelationRepository.php # Datenbank-Zugriffs-Layer
├── validation/
│ └── SubticketValidator.php # Input-Validierung
├── cache/
│ └── SubticketCacheManager.php # Performance-Optimierung
├── events/
│ └── SubticketEventHandler.php # Signal-Handler (Auto-Close, etc.)
└── tests/
└── Unit/ # PHPUnit-Tests
Signal-Hooks:
| Signal | Handler | Zweck |
|---|---|---|
object.view |
onTicketView() |
Panel-HTML in Ticket-Ansicht einfügen |
model.created |
onTicketCreated() |
Neu erstellte Subtickets automatisch verknüpfen |
model.updated |
onTicketStatusChanged() |
Auto-Close-Workflow auslösen (Phase 4) |
ajax.scp |
registerAjaxRoutes() |
AJAX-Endpunkte registrieren (Legacy, ungenutzt) |
Datenbank-Schema:
-- Zusätzliche vom Plugin erstellte Tabellen
CREATE TABLE ost_ticket_hierarchy_metadata (
ticket_id int(11) unsigned PRIMARY KEY,
auto_close_enabled tinyint(1) DEFAULT 1,
inherit_settings text,
dependency_type enum('blocks','depends_on','relates_to') DEFAULT 'relates_to',
max_children int(11) DEFAULT 50,
created timestamp DEFAULT CURRENT_TIMESTAMP,
updated timestamp DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
FOREIGN KEY (ticket_id) REFERENCES ost_ticket(ticket_id) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
CREATE TABLE ost_ticket_progress (
parent_id int(11) unsigned PRIMARY KEY,
total_children int(11) DEFAULT 0,
completed_children int(11) DEFAULT 0,
in_progress_children int(11) DEFAULT 0,
pending_children int(11) DEFAULT 0,
last_calculated timestamp DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
FOREIGN KEY (parent_id) REFERENCES ost_ticket(ticket_id) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
-- Zu ost_ticket hinzugefügte Indizes
CREATE INDEX idx_ticket_pid ON ost_ticket(ticket_pid);
CREATE INDEX idx_ticket_hierarchy ON ost_ticket(ticket_id, ticket_pid, status_id);
-- Zu ost_ticket hinzugefügte Spalte
ALTER TABLE ost_ticket ADD COLUMN version int(11) DEFAULT 0;
¶ Sicherheits-Features
-
Input-Validierung:
- Alle Ticket-IDs werden als positive Ganzzahlen validiert
db_input()für SQL-Escaping verwendet (osTicket-Standard)- CSRF-Token erforderlich für alle AJAX-Requests
-
Verhinderung zirkulärer Abhängigkeiten:
isDescendant()-Methode prüft Abstammung bis 10 Ebenen- Verhindert, dass Tickets ihre eigenen Vorfahren werden
-
Verhinderung von Self-Linking:
- Tickets können nicht mit sich selbst verknüpft werden
- Vor Datenbank-Abfragen geprüft
-
Berechtigungs-Prüfungen:
- Nur Staff-Mitglieder können auf Subticket-Panel zugreifen
- AJAX-Endpunkte prüfen Staff-Authentifizierung
¶ Performance-Optimierungen
-
Single Query für Children:
getChildren()nutzt JOIN, um Subject und Status in einer Abfrage zu holen- Vermeidet N+1-Query-Problem
-
Queue-Indikator-Caching:
queue-indicator.jsbündelt Parent-Status-Checks- Einzelner AJAX-Request für mehrere Tickets
-
Auto-Deploy-Versions-Prüfung:
- Dateien werden nur bei Versions-Änderung deployed
- Versions-Tracking via
.subticket-deployed-version-Datei
-
Datenbank-Indizes:
idx_ticket_pidbeschleunigt Child-Lookupsidx_ticket_hierarchyoptimiert Parent-Child-Queries
¶ FAQ
¶ Allgemeine Fragen
F: Muss ich osTicket Core-Dateien modifizieren?
A: Nein! Das Plugin nutzt osTickets native ticket_pid-Infrastruktur und Signal-System. Alle Features funktionieren ohne Berührung von Core-Dateien.
F: Funktioniert das mit meinem benutzerdefinierten osTicket-Theme?
A: Ja, das Plugin nutzt osTickets Standard-CSS-Klassen und -Struktur. Visuelle Indikatoren und Panels passen sich automatisch an dein Theme an.
F: Kann ich osTicket upgraden, ohne das Plugin zu brechen?
A: Ja, solange osTicket das ticket_pid-Feld und Signal-System beibehält (diese sind Core-Features). Das Plugin ist gegen osTicket 1.18.x getestet.
F: Wie deinstalliere ich das Plugin?
A: Admin Panel → Plugins → Subticket Manager → Löschen. Das Plugin wird:
- Deployed Dateien entfernen (
scp/subtickets.php,scp/ajax-subticket.php,scp/apps.php) - Optional Datenbank-Tabellen entfernen (konfigurierbar)
- Ticket-Beziehungen beibehalten (Daten bleiben in
ticket_pid)
¶ Features & Funktionalität
F: Was ist die maximale Hierarchie-Tiefe?
A: Das Plugin unterstützt bis zu 10 Verschachtelungsebenen (konfigurierbar in isDescendant()-Methode). Dies verhindert Endlosschleifen und wahrt die Performance.
F: Kann ein Ticket mehrere Parents haben?
A: Nein. osTickets ticket_pid-Feld unterstützt nur einen Parent pro Ticket. Dies entspricht dem Baum-Struktur-Design.
F: Kann ich Tickets in Bulk verknüpfen?
A: Ja, nutze die Subticket Hierarchies Admin-Seite (Anwendungen → Subticket Hierarchies) für Batch-Operationen.
F: Was passiert, wenn ich ein Parent-Ticket lösche?
A: Standardmäßig bleiben Child-Tickets erhalten, aber ihr ticket_pid wird auf NULL gesetzt (getrennt). Falls du Foreign-Key-Constraints mit ON DELETE CASCADE hast, würden auch Children gelöscht.
F: Funktioniert Auto-Close sofort?
A: Auto-Close ist ein Phase 4 Feature (aktuell in Entwicklung). Wenn alle Child-Tickets geschlossen sind, wird der Parent automatisch via model.updated Signal-Handler geschlossen.
¶ Technische Fragen
F: Wie werden Parent-Indikatoren zu Queue-Listen hinzugefügt?
A: Das Plugin nutzt zwei Mechanismen:
- Queue Decoration:
ParentTicketDecoration-Klasse erweitert osTicketsQueueColumnAnnotation, um ein SQL-JOIN zum Zählen von Child-Tickets hinzuzufügen - JavaScript-Injection:
queue-indicator.jsholt Parent-Status via AJAX und fügt Icons dynamisch ein
F: Warum eigenständiger AJAX-Handler statt Signal-Routing?
A: Der eigenständige Handler (ajax-subticket.php) ist einfacher und wartbarer als Signal-basiertes Routing. Er bietet direkte, vorhersagbare Endpunkte ohne komplexe Dispatcher-Logik.
F: Wie funktioniert Auto-Linking für neue Subtickets?
A: Wenn du auf "Subticket erstellen" klickst, wird die Parent-ID in $_SESSION['subticket_parent'] gespeichert. Nach Ticket-Erstellung setzt der model.created Signal-Handler (onTicketCreated()) automatisch ticket_pid in der Datenbank.
F: Kann ich das Panel-Aussehen anpassen?
A: Ja, modifiziere die getPanelCSS()-Methode in class.SubticketPlugin.php. Alle Styles sind Inline-CSS für einfache Anpassung.
F: Wie aktiviere ich Debug-Logging?
A: Bearbeite class.SubticketPlugin.php und ändere Zeile 8:
define('SUBTICKET_DEBUG', true);
Debug-Logs werden nach /tmp/subticket-debug.log geschrieben.
F: Welche SQL-Queries werden ausgeführt?
A: Debug-Modus aktivieren und /tmp/subticket-debug.log prüfen. Beispiel-Queries:
-- Children abrufen
SELECT t.ticket_id, t.number, cdata.subject, s.name as status
FROM ost_ticket t
LEFT JOIN ost_ticket__cdata cdata ON t.ticket_id = cdata.ticket_id
LEFT JOIN ost_ticket_status s ON t.status_id = s.id
WHERE t.ticket_pid = 15;
-- Ticket verknüpfen
UPDATE ost_ticket SET ticket_pid = 15 WHERE ticket_id = 123;
¶ Kompatibilität
F: Funktioniert das mit osTicket 1.17 oder älter?
A: Nein. Das Plugin benötigt osTicket 1.18.x für ordentliche Signal-Unterstützung und Datenbankstruktur. osTicket 1.17 und älter können unterschiedliche ticket_pid-Implementierungen haben.
F: Ist es kompatibel mit PHP 8.x?
A: Ja! Das Plugin ist mit PHP 7.4, 8.0, 8.1, 8.2 und 8.3 getestet. CI-Pipeline führt Tests auf allen Versionen aus.
F: Kann ich das mit PostgreSQL statt MySQL verwenden?
A: Das Plugin ist für MySQL/MariaDB ausgelegt. PostgreSQL-Unterstützung würde Modifikation der SQL-Queries erfordern (osTicket selbst unterstützt primär MySQL).
F: Funktioniert es mit Elasticsearch Queue Plugin?
A: Sollte funktionieren, aber nicht explizit getestet. Die Queue-Decoration hakt in osTickets Standard-Queue-System ein, also könnten Elasticsearch-Plugins es überschreiben.
¶ Lizenz
Dieses Plugin wird unter der GNU General Public License v2 veröffentlicht, kompatibel mit osTicket Core.
Details siehe LICENSE.
¶ Support
Für Fragen oder Probleme erstelle bitte ein Issue auf GitHub:
Issue Tracker: https://github.com/markus-michalski/osticket-subticket-manager/issues
Beim Melden von Problemen bitte angeben:
- osTicket-Version (Admin Panel → Einstellungen → Über)
- PHP-Version (
php -v) - Plugin-Version
- Browser-Konsolen-Fehler (F12 → Console)
- Schritte zur Reproduktion
¶ Mitwirken
Entwickelt von Markus Michalski
Beiträge willkommen!
- Repository forken
- Feature-Branch erstellen
- Pull Request einreichen
¶ Changelog
Siehe CHANGELOG.md für Versionshistorie.