Was Plugins können
Was ein Plugin konkret tut, beschreibt sein Anbieter. Zum Ausprobieren und als Vorlage für eigene Entwicklungen gibt es das Beispiel-Plugin.
Wer macht was
- Betreiber legen den Plugin-Ordner auf den Server – je nach Installationsart in den Ordner
plugins/neben der Compose-Datei, in das Volumepluginsoder in ein Verzeichnis des Webservers (siehe Plugins installieren). Über den Browser lässt sich kein Plugin hochladen. - Plattform-Admins aktivieren das Plugin unter Plattform-Admin → Plugins. Dabei legt QuickTribe die Tabellen des Plugins an (Migrationen). Plattformweite Einstellungen des Plugins stehen auf seiner Detailseite (siehe Plattform-Admin → Plugins).
- Owner und Admins schalten Plugins, die je Community gelten, unter Einstellungen → Plugins für ihre Community ein und pflegen dort deren Einstellungen (siehe Einstellungen → Plugins). Nach der Aktivierung durch den Plattform-Admin sind solche Plugins in jeder Community zunächst aus. Plugins, die nicht je Community gelten, wirken sofort in allen Communities.
- Mitglieder nutzen, was das Plugin anbietet – neue Menüpunkte, Felder oder Hinweise erscheinen an den gewohnten Stellen.
Vertrauen und Sicherheit
Die Schnittstelle für Plugins prüft Community-Zugehörigkeit, Rechte, Größen und Pfade. Das schützt vor Programmierfehlern und davor, dass Besucher die Endpunkte eines Plugins missbrauchen – nicht vor absichtlich schädlichem Code eines Plugins. Deshalb gilt:- Nur der Betreiber installiert. Plugins kommen ausschließlich als Dateien auf den Server; die Oberfläche kann keine Plugins hochladen oder verändern.
- Schreibgeschützt. Alle Dateien und Ordner eines Plugins müssen
rootgehören und dürfen für den PHP-Prozess nicht schreibbar sein (keine Schreibrechte für Gruppe und andere). Symbolische Links und Hardlinks sind nicht erlaubt. So kann selbst eine Lücke in der Anwendung den Code eines Plugins nicht verändern. - Sonst „unsicher“. Verletzt ein Plugin diese Regeln, zeigt der Plattform-Admin den Status unsicher mit dem Grund, und QuickTribe lädt das Plugin nicht.
app:doctormeldet das als Fehler. - Nur im Worker schreibbar. In den Docker-Varianten ist der Plugin-Ordner in den Diensten
appundmigratenur lesbar eingehängt; schreiben kann nur der Dienstworker(als Ziel für Updates), und auch dort laufen die Prozesse alswww-data, das die Dateien nicht ändern darf.
Zustände
Plattform-Admin → Plugins,app:plugin:list und app:doctor zeigen je Plugin einen Status:
Ist ein Plugin nicht aktiv, entfallen seine Seiten, Menüpunkte, Felder und Reaktionen; seine Daten bleiben in der Datenbank. Datenexport und Löschung personenbezogener Daten laufen auch für deaktivierte Plugins weiter, solange ihr Ordner vorhanden ist.
Lizenzen
Manche Plugins nennen im Manifest eine Lizenz. QuickTribe zeigt sie im Plattform-Admin mit dem Hinweis „Lizenzprüfung folgt“ an, prüft sie in dieser Version aber nicht. Die UmgebungsvariableAPP_PLUGIN_LICENSE_URL ist dafür reserviert und bleibt leer.
Weiter
- Betreiber: Plugins installieren und Plugins betreiben (Migrationen, Updates, Worker, Zeitstempel, Fehlersuche)
- Plattform-Admins: Plattform-Admin → Plugins
- Owner und Admins: Einstellungen → Plugins
- Entwickler: Plugins entwickeln