Migrationen
Plugins legen ihre Tabellen (Präfixplg_<id>__) mit eigenen SQL-Migrationen an. QuickTribe führt sie aus
- beim Aktivieren im Plattform-Admin bzw. mit
app:plugin:enable, - im Dienst
migratebei jedem Start bzw. Update des Stacks – nach den Migrationen der Plattform, für alle aktivierten Plugins, - mit Migrationen ausführen im Plattform-Admin oder
app:plugin:migrateauf der Konsole.
migrate fehl, startet die Plattform trotzdem. Das Log von migrate zeigt dann je betroffenem Plugin eine Zeile ✘ <id>: … mit Datei, Nummer der Anweisung und Meldung der Datenbank und darunter die Warnung „… Plugins nicht migriert – der Kern startet trotzdem; Details unter /admin/plugins.“ Nur wenn der Befehl selbst abbricht (etwa ohne Verbindung zur Datenbank), steht dort stattdessen eine Zeile WARNUNG: Plugin-Migrationen fehlgeschlagen …. Alle drei Fälle findet docker compose logs migrate | grep -E '✘|nicht migriert|WARNUNG'. Das Plugin zeigt im Plattform-Admin Fehler bzw. Migration offen. Nach dem Beheben (meist eine korrigierte Fassung des Plugins vom Anbieter):
--enabled oder --all (alle erkannten Plugins).
Gut zu wissen:
- Eine unterbrochene Migration setzt beim nächsten Lauf nach der letzten erfolgreichen Anweisung fort.
- Ausgeführte Migrationsdateien dürfen sich nicht mehr ändern. Ändert eine neue Fassung eine schon gelaufene Datei, zeigt das Plugin Fehler („nach dem Ausführen geändert“) – das muss der Anbieter beheben.
- Ein Zurück auf eine ältere Fassung eines Plugins macht Migrationen nicht rückgängig. Wie bei der Plattform selbst hilft dann nur eine Datensicherung von vorher.
app:plugin:migrate --freshlöscht vorher Plugin-Tabellen samt Daten – mit--allalle, mit einer Plugin-ID oder--enableddie Tabellen und den Migrationsstand dieser Plugins. Das ist nur für Entwicklung und Tests gedacht; in Produktion verweigert der Befehl es ohne--force. Nie auf einer Installation mit echten Daten verwenden.
Ein Plugin aktualisieren
Eine neue Fassung ersetzt den Plugin-Ordner. Weil PHP den Code im Betrieb zwischenspeichert (OPcache), müssenapp und worker danach neu starten; offene Migrationen laufen anschließend. Wer Besucher während des Tauschs aussperren will, schaltet vorher den Wartungsmodus ein.
Docker Compose (Ordner plugins/ neben der Compose-Datei):
.alt-… löschen Sie, sobald die neue Fassung läuft. Zurück auf die vorige Fassung geht nur, solange die neue keine Migration ausgeführt hat.
Update der Plattform
Plugins liegen außerhalb des Images bzw. der Versionsordner und bleiben bei einem Update von QuickTribe erhalten; ihre Migrationen laufen im Dienstmigrate mit. Jedes Plugin nennt im Manifest, mit welchen Versionen von QuickTribe und der Plugin-Schnittstelle es läuft (Plattform-Admin → Plugins, „Anforderungen“). Passt die neue Version nicht dazu, steht das Plugin nach dem Update auf Fehler und wird nicht geladen. Prüfen Sie die Anforderungen Ihrer Plugins deshalb vor einem Update und holen Sie bei Bedarf eine passende Fassung beim Anbieter. Ändern sich mit einem Update die Regeln für Plugin-Oberflächen (etwa beim Geltungsbereich der Stile), bauen Sie die Plugins mit dem neuen Stand neu und spielen sie zusammen mit dem Update ein; ältere Builds zeigt die Plugin-Verwaltung mit Stile nicht geladen – neu bauen.
Deaktivieren und entfernen
- Deaktivieren (Plattform-Admin oder
app:plugin:disable <id>) schaltet das Plugin plattformweit aus. Seine Seiten, Menüpunkte, Felder und Reaktionen entfallen; Tabellen, Einstellungen und Dateien bleiben erhalten. Wieder aktivieren stellt alles her. - Entfernen: Erst deaktivieren, dann den Ordner löschen und
appundworkerneu starten. Die Daten des Plugins bleiben in der Datenbank und im Speicher; im Plattform-Admin erscheint es weiter als nicht gefunden, solange es dort Daten oder eine Aktivierung gibt. Einen Befehl, der die Daten eines einzelnen Plugins löscht, gibt es in dieser Version nicht.
Worker
Aufträge von Plugins – wiederkehrende Jobs, einzelne Aufgaben und die Reaktionen auf Ereignisse – arbeitet der Worker in einer eigenen Warteschlange (async_plugins) ab. Im Container worker laufen dafür zwei Prozesse nebeneinander: einer für die Plattform (E-Mails, Push, Videos, Zeitpläne …) und einer für Plugins. Ein langer Plugin-Auftrag hält so keine E-Mails oder Erinnerungen auf. Endet einer der beiden Prozesse (planmäßig nach einer Stunde, bei 512 MB Speicher oder durch einen Absturz), startet der Container nur diesen neu – nach schnellen Abstürzen mit wachsender Wartezeit bis 60 Sekunden; der andere arbeitet weiter.
Beim Anhalten (Update, Neustart) beendet jeder Prozess erst seinen laufenden Auftrag. Die Stack-Dateien geben dem Worker dafür bis zu fünf Minuten, bei der Installation ohne Docker gilt dasselbe für beide systemd-Dienste (TimeoutStopSec=300). Ein Neustart des Workers kann deshalb einige Minuten dauern. Wird ein Auftrag trotzdem hart abgebrochen, wiederholt QuickTribe ihn nicht: Eine abgebrochene Aufgabe gilt als gescheitert (Fehler beim Plugin), ein Job läuft beim nächsten Takt wieder. Jobs prüft der Worker alle fünf Minuten auf Fälligkeit.
Bei der Installation ohne Docker übernimmt der zweite Dienst quicktribe-plugin-worker die Plugin-Aufträge (siehe Webserver → Worker). Läuft er nicht, bleiben Jobs, Aufgaben und Reaktionen von Plugins liegen.
Wartungsmodus
Im Wartungsmodus verhalten sich Plugins wie die Plattform: Plugin-Seiten (/plugins/…, /c/<slug>/plugins/…) zeigen die Zugangsseite, die Plugin-Schnittstelle unter /api/plugins/… antwortet mit 503. Offen bleiben nur die gebauten Dateien unter /plugin-assets/… (Skripte, Stile, Bilder), damit freigeschaltete Geräte die Seiten vollständig sehen. Jobs und Aufgaben laufen im Hintergrund weiter.
Zeitstempeldienst
Manche Plugins lassen Dokumente von einer externen Zeitstempelstelle nach RFC 3161 bestätigen – etwa für revisionssichere Tagesabschlüsse. Das ist optional und nur nötig, wenn ein Plugin es verlangt; ohne Konfiguration bieten Plugins diese Funktion nicht an.
Die CA-Datei ist die Grundlage jeder Prüfung. Sie gehört deshalb wie die Plugins
root und darf für den PHP-Prozess nicht schreibbar sein – sonst ließe sich über eine Lücke in der Anwendung ein fremdes Zertifikat unterschieben, und gefälschte Zeitstempel gälten als gültig. Ein guter Platz in den Docker-Varianten ist ein Ordner .tsa im Plugin-Verzeichnis: Den sehen app und worker, in app ist er nur lesbar eingehängt, und Ordner mit Punkt lädt QuickTribe nicht als Plugin. Beispiel mit dem kostenlosen Dienst FreeTSA:
Docker Compose (im Verzeichnis mit der docker-compose.yml):
APP_TSA_URL=https://freetsa.org/tsr und APP_TSA_CA_FILE=/var/www/plugins/.tsa/freetsa-cacert.pem eintragen – bei Docker Compose in der .env, bei Portainer und Coolify in den Variablen des Stacks bzw. der Ressource – und den Stack neu ausrollen (docker compose up -d). Ohne Docker liegt die Datei z. B. unter /var/www/quicktribe/shared/tsa/ (Ordner und Datei gehören root, Modus 755 bzw. 644), die Variablen stehen in shared/.env.local. Für Dienste mit Rechtswirkung (qualifizierte Zeitstempel nach eIDAS) nennt der Anbieter Adresse, Zertifikatskette und Zugang.
- Der Server braucht ausgehenden HTTPS-Zugang zum Dienst. QuickTribe folgt keinen Weiterleitungen und wartet höchstens 10 Sekunden.
- Je Community sind 30 Zeitstempel pro Stunde möglich.
- Behalten Sie die CA-Datei. Mit ihr prüft QuickTribe auch ältere Zeitstempel – zum Zeitpunkt ihrer Ausstellung, also auch nach Ablauf des Zertifikats der Zeitstempelstelle. Wechselt der Dienst oder seine Zertifikatskette, hängen Sie die neuen Zertifikate an die bestehende Datei an, statt sie zu ersetzen; sonst lassen sich ältere Zeitstempel nicht mehr prüfen.
Umgebungsvariablen
Alle Variablen der Installation stehen unter Konfiguration.
Logs und Prüfung
- Plattform-Admin → Plugins zeigt je Plugin Status, Fehler, letzte Fehlermeldung und offene Löschungen; die Detailseite den Stand jeder Migration.
app:plugin:listzeigt dieselbe Übersicht auf der Konsole,app:plugin:validate [<pfad>]prüft Manifest, Code, Dateirechte, Migrationen und gebaute Dateien und endet bei Fehlern mit Exit-Code 1 – gut vor dem Einspielen einer neuen Fassung.app:doctorenthält einen Abschnitt „Plugins“ und meldet unsichere Plugins, aktivierte Plugins mit Fehler oder offener Migration und fehlende Ordner als Fehler.- Logs: Fehler von Plugins (in Endpunkten, Reaktionen auf Ereignisse, Jobs und Aufgaben) stehen im Log von
appbzw.workermit"channel":"plugins"und dem Namenplugin.<id>.…, z. B.docker compose logs worker | grep '"channel":"plugins"'; ohne Docker in/var/log/php8.5-fpm.logund im Journal vonquicktribe-plugin-worker. Warnungen (etwa langsame Aufrufe oder Fehler, die ein Plugin im Browser meldet) schreibt die Plattform in Produktion nur zusammen mit einem Fehler desselben Aufrufs ins Log.