English Version

Zurück zur Übersicht

Plugin Update Checker: Installation

Voraussetzungen

• osTicket 1.18.x
• PHP 8.1 oder neuer (composer.json: >=8.1)
• PHP-Erweiterungen curl und json
• Zugriff auf das Dateisystem des osTicket-Servers und auf das Admin Panel
• Ausgehende HTTPS-Verbindung des Servers zu api.github.com
• Composer auf dem Server, falls der Autoloader nicht schon im Paket liegt

Plugin-Dateien installieren

Das Plugin lädt seine Klassen aus src/ über den Composer-Autoloader vendor/autoload.php. Die Datei ist die einzige Abhängigkeit zur Laufzeit: Das Plugin hat keine Fremdpakete, composer install --no-dev erzeugt nur den Autoloader.

Fehlt vendor/autoload.php, lädt die Plugin-Datei zwar ohne Fehler, aber beim Öffnen der Plugin-Liste scheitert das Plugin an den nicht gefundenen Klassen. Erzeuge den Autoloader deshalb immer, bevor du das Plugin aktivierst.

Variante 1: ZIP

1. Das Release-ZIP von den GitHub Releases herunterladen und entpacken.
2. Den Ordner nach include/plugins/update-check/ im osTicket-Verzeichnis kopieren, sodass plugin.php direkt in diesem Ordner liegt.
3. Im Plugin-Ordner composer install --no-dev ausführen, falls dort kein Ordner vendor/ mit autoload.php vorhanden ist.

Variante 2: Git Clone

cd /pfad/zu/osticket/include/plugins
git clone https://github.com/markus-michalski/osticket-plugin-update-check.git update-check
cd update-check
composer install --no-dev

Plugin aktivieren

1. Im osTicket Admin Panel zu Manage > Plugins wechseln.
2. Plugin Update Checker in der Liste suchen und aktivieren.

Das Plugin ist ein Singleton: Beim Aktivieren legt es bei Bedarf selbst eine Instanz mit der Notiz Auto-created singleton instance an. Du musst keine Instanz von Hand erstellen. Die Badges erscheinen beim nächsten Laden der Plugin-Liste. Die optionalen Einstellungen findest du unter Konfiguration.

Update

Ersetze den Ordner include/plugins/update-check/ durch die neue Version und führe bei Bedarf erneut composer install --no-dev aus. Das Plugin hat keine Datenbanktabellen und keine Migrationen. Bereits gecachte Antworten bleiben bis zum Ablauf gültig, siehe Technische Details.

Deaktivieren und Entfernen

• Deaktivieren: Im Admin Panel unter Manage > Plugins das Plugin deaktivieren. Das Plugin hat keine eigene Aufräumlogik. Es legt keine Tabellen an und ändert keine osTicket-Dateien.
• Entfernen: Plugin im Admin Panel deinstallieren und danach den Ordner include/plugins/update-check/ löschen.
• Cache: Die Cache-Dateien im Temp-Verzeichnis des Servers (osticket-update-check/ unter sys_get_temp_dir()) löscht das Plugin nicht. Du kannst den Ordner nach dem Entfernen von Hand löschen.
• GitHub-Token: Hast du einen Token eingetragen, steht er in der Plugin-Konfiguration in der Datenbank. Trage ihn vor dem Entfernen aus oder widerrufe ihn bei GitHub. Mehr dazu unter Datenschutz.