¶ Tab Swap
¶ Inhaltsverzeichnis
¶ Überblick
Das Tab Swap Plugin tauscht die Reihenfolge der Antworten- und Interne Notiz-Tabs in der osTicket Ticket-Detailansicht, sodass Interne Notiz statt Antworten der Standard-aktive Tab wird.
Perfekt für Teams, die primär interne Notizen für die Zusammenarbeit nutzen und versehentliche kundenseitige Antworten reduzieren möchten.
Was macht dieses Plugin unverzichtbar:
- ❌ Standard osTicket zeigt Antworten-Tab zuerst → Risiko versehentlicher Kunden-Antworten
- ❌ Teams, die interne Notizen häufiger nutzen, müssen ständig Tabs wechseln
- ✅ Plugin macht Interne Notiz zum Standard-Tab → Schnellerer Workflow, weniger Fehler
¶ Hauptfunktionen
- ✅ Automatischer Tab-Tausch - Interne Notiz wird Standard-aktiver Tab
- ✅ PJAX-Kompatibel - Funktioniert nahtlos mit osTickets dynamischer Navigation
- ✅ Berechtigungs-bewusst - Behandelt Nutzer mit/ohne Antwort-Berechtigungen korrekt
- ✅ Auto-Update-Support - Versions-Tracking eingebaut
- ✅ Mobile-Freundlich - Funktioniert mit responsivem Design
- ✅ Keine Core-Modifikationen - Nutzt osTickets Signal API
¶ Anwendungsfälle
- Interne Kollaborations-Teams - Teams, die interne Notizen häufiger nutzen als Kunden-Antworten
- Versehentliche Antworten reduzieren - Verhindere, dass Agents versehentlich Antworten an Kunden senden
- Schnellerer Workflow - Agents, die primär mit internen Notizen arbeiten, sparen Zeit
¶ Systemanforderungen
| Anforderung | Version | Hinweise |
|---|---|---|
| osTicket | 1.18.x | Plugin nutzt osTickets Signal API |
| PHP | 7.4+ | Empfohlen: PHP 8.1+ für beste Performance |
| jQuery | Beliebig | In osTicket standardmäßig enthalten |
¶ Installation
¶ Schritt 1: Plugin-Dateien installieren
¶ Methode 1: ZIP-Download (Empfohlen)
- Lade das neueste Release von Releases herunter
- Entpacke die ZIP-Datei
- Lade den
tab-swap-Ordner nach/include/plugins/auf deinem osTicket-Server hoch
Finaler Pfad: /pfad/zu/osticket/include/plugins/tab-swap/
¶ Methode 2: Git Repository
cd /pfad/zu/osticket/include/plugins
git clone https://github.com/markus-michalski/osticket-tab-swap.git tab-swap
¶ Schritt 2: Plugin in osTicket aktivieren
- Melde dich im osTicket Admin Panel an
- Navigiere zu: Admin Panel → Verwalten → Plugins
- Finde "Tab Swap" in der Plugin-Liste
- Klicke auf Aktivieren
Das Plugin installiert sich automatisch und aktualisiert /include/.htaccess um JavaScript-Dateien zu erlauben.
¶ Schritt 3: Plugin konfigurieren
- Nach dem Aktivieren, klicke auf Konfigurieren (Zahnrad-Symbol)
- Aktiviere "Enable Tab Swap": AN
- Klicke auf Änderungen speichern
¶ Konfiguration
¶ Verfügbare Einstellungen
| Einstellung | Beschreibung | Standard | Nutzen wenn |
|---|---|---|---|
| Enable Tab Swap | Tab-Tausch an/aus schalten | AN | Du den Tab-Tausch temporär deaktivieren möchtest ohne zu deinstallieren |
Das Plugin benötigt minimale Konfiguration - einfach aktivieren und es funktioniert sofort.
¶ Nutzung
Sobald aktiviert, tauscht das Plugin automatisch die Tabs in der Ticket-Ansicht:
¶ Vorher (Standard osTicket)
[Antworten (aktiv)] [Interne Notiz]
¶ Nachher (Mit Plugin)
[Interne Notiz (aktiv)] [Antworten]
¶ Verhalten
- Standard-aktiver Tab: Interne Notiz
- Tab-Reihenfolge: Interne Notiz erscheint zuerst (links)
- Formular-Sichtbarkeit: Interne Notiz-Formular ist sichtbar, Antworten-Formular ist versteckt
- PJAX-Navigation: Funktioniert nahtlos beim Navigieren zwischen Tickets
¶ Behandelte Sonderfälle
| Szenario | Verhalten |
|---|---|
| Nutzer hat KEINE Antwort-Berechtigung | Nur Notiz-Tab existiert → kein Tausch durchgeführt |
| Ticket ist geschlossen | Keine Formulare vorhanden → kein Tausch durchgeführt |
| Mobile-Ansicht | Tab-Tausch funktioniert (responsives Design kompatibel) |
| PJAX-Navigation | Tab-Tausch wird beim dynamischen Laden erneut angewendet |
¶ Fehlerbehebung
¶ Problem: Tab-Tausch funktioniert nicht
Symptome:
- Tabs sind noch in Standard-Reihenfolge (Antworten zuerst)
- Interne Notiz ist nicht der aktive Tab
Prüfen:
-
Plugin aktiviert?
- Admin Panel → Verwalten → Plugins → "Tab Swap" → Status: Aktiviert
-
Plugin konfiguriert?
- Klicke auf Konfigurieren (Zahnrad) → "Enable Tab Swap": AN
-
Nutzer hat Antwort-Berechtigung?
- Falls Agent KEINE Antwort-Berechtigung hat, existiert nur Notiz-Tab (nichts zu tauschen)
- Admin Panel → Agents → Mitarbeiter → [Agent Name] → Berechtigungen → "Auf Tickets antworten" prüfen
-
JavaScript-Fehler?
- Öffne Browser-Konsole (F12)
- Prüfe auf Fehler bezüglich
tab-swap.js
-
Browser-Cache?
- Hard Refresh:
Strg+F5(Windows) oderCmd+Shift+R(Mac)
- Hard Refresh:
¶ Problem: Funktioniert beim ersten Laden, aber bricht nach PJAX-Navigation
Symptome:
- Tab-Tausch funktioniert beim direkten Laden eines Tickets
- Stoppt beim Navigieren zu einem anderen Ticket
Lösung:
- Browser-Konsole prüfen nach
[Tab-Swap] PJAX reload detectedNachricht - Plugin aktualisieren auf neueste Version (ältere Versionen behandeln PJAX möglicherweise nicht korrekt)
- osTicket-Version verifizieren ist 1.18.x (ältere Versionen unterstützen PJAX möglicherweise nicht)
¶ Problem: JavaScript/CSS lädt nicht (404-Fehler)
Symptome:
- Plugin ist aktiviert aber JavaScript lädt nicht
- Browser zeigt 404-Fehler für
tab-swap.js
Ursache: /include/.htaccess wurde nicht aktualisiert um statische Assets zu erlauben
Manuelle Lösung (Apache):
Bearbeite /include/.htaccess und füge dies vor der Deny from all Zeile ein:
# Allow static assets for plugins (JavaScript, CSS, images, fonts)
<FilesMatch "\.(js|css|map|json|png|jpg|jpeg|gif|svg|ico|woff|woff2|ttf|eot|otf)$">
<IfModule mod_authz_core.c>
Require all granted
</IfModule>
<IfModule !mod_authz_core.c>
Order allow,deny
Allow from all
</IfModule>
</FilesMatch>
Für NGINX:
location ~ ^/include/plugins/.+\.(js|css|png|jpg|jpeg|gif|svg|ico|woff|woff2|ttf|eot)$ {
allow all;
access_log off;
expires 7d;
}
location ~ ^/include/ {
deny all;
}
¶ Technische Details
¶ Architektur
Plugin-Struktur:
tab-swap/
├── plugin.php # Plugin-Metadaten
├── class.TabSwapPlugin.php # Haupt-Plugin-Klasse
├── config.php # Plugin-Konfiguration
└── js/
└── tab-swap.js # Frontend-JavaScript
¶ Signal Hooks
Das Plugin verbindet sich mit osTickets Signal API:
| Signal | Handler | Zweck |
|---|---|---|
object.view |
onTicketView() |
Erkennt, wenn ein Ticket angezeigt wird |
Implementierung:
Signal::connect('object.view', function(Ticket $ticket) {
if ($user->hasPerm(PERM_REPLY)) {
// JavaScript zum Tab-Tausch injizieren
}
});
¶ Frontend-Implementierung
JavaScript-Workflow:
- Warte auf DOM-Ready
- Finde Antworten (
#post-reply-tab) und Interne Notiz (#post-note-tab) Tabs - Tausche DOM-Reihenfolge (verschiebe Notiz-Tab vor Antworten-Tab)
- Wechsle aktiven Status (deaktiviere Antworten, aktiviere Notiz)
- Wechsle Formular-Sichtbarkeit (verstecke Antworten-Formular, zeige Notiz-Formular)
PJAX-Unterstützung:
$(document).on('pjax:success', function() {
TabSwapPlugin.reset();
TabSwapPlugin.init();
});
¶ Berechtigungs-Behandlung
| Nutzer-Berechtigung | Verhalten |
|---|---|
Hat PERM_REPLY |
✅ JavaScript injiziert, Tabs getauscht |
Kein PERM_REPLY |
❌ Keine Injektion (Nutzer sieht nur Notiz-Tab) |
¶ FAQ
¶ Allgemeine Fragen
F: Modifiziert dieses Plugin osTicket Core-Dateien?
A: Nein! Das Plugin nutzt osTickets offizielle Signal API (object.view). Keine Core-Dateien werden modifiziert.
F: Kann ich das Plugin temporär deaktivieren ohne Konfiguration zu verlieren?
A: Ja! Einfach das Plugin im Admin Panel Deaktivieren. Deine Konfiguration wird in der Datenbank gespeichert.
F: Funktioniert das mit osTicket 1.17 oder älter?
A: Nein. Das Plugin ist für osTicket 1.18.x konzipiert. Ältere Versionen haben möglicherweise eine andere DOM-Struktur.
¶ Kompatibilität
F: Ist es kompatibel mit PHP 8.x?
A: Ja! Das Plugin ist getestet mit PHP 7.4, 8.0, 8.1, 8.2 und 8.3.
F: Funktioniert das mit benutzerdefinierten osTicket-Themes?
A: Meistens ja, aber benutzerdefinierte Themes haben möglicherweise eine andere DOM-Struktur. Das Plugin basiert auf Standard-Element-IDs (#post-reply-tab, #post-note-tab).
F: Kann ich das mit anderen Plugins nutzen?
A: Ja, aber teste auf Konflikte. Plugins, die dieselben DOM-Elemente modifizieren, können sich gegenseitig stören.
¶ Verhalten
F: Was passiert, wenn ein Nutzer keine Antwort-Berechtigung hat?
A: Das Plugin erkennt dies und injiziert kein JavaScript. Nutzer ohne Antwort-Berechtigung sehen nur den Notiz-Tab (nichts zu tauschen).
F: Beeinflusst das die API-Ticket-Erstellung?
A: Nein, dies ist ein reines Frontend-Plugin. API-Operationen sind nicht betroffen.
F: Warum werden vorgefertigte Antworten immer noch ins Antworten-Formular eingefügt?
A: Dies ist osTicket Core-Verhalten, nicht durch Plugins kontrollierbar. Nach Auswahl einer vorgefertigten Antwort, manuell zum Antworten-Tab wechseln oder Inhalt ins Notiz-Formular kopieren.
¶ 📄 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-tab-swap/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.