Plugins (in der Oberfläche auch „Erweiterungen“) ergänzen QuickTribe um eigene Funktionen – etwa Fahrgemeinschaften zu Events, eine erweiterte Mitgliederverwaltung oder ein Schießbuch für Vereine. Ein Plugin ist ein Ordner mit PHP-Code, optional einer Oberfläche (Vue) und eigenen Datenbanktabellen. Es wird nicht in das Image eingebaut, sondern vom Betreiber neben die Installation gelegt und im Plattform-Admin eingeschaltet – ohne Neubau und ohne neues Image.

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

  1. Betreiber legen den Plugin-Ordner auf den Server – je nach Installationsart in den Ordner plugins/ neben der Compose-Datei, in das Volume plugins oder in ein Verzeichnis des Webservers (siehe Plugins installieren). Über den Browser lässt sich kein Plugin hochladen.
  2. 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).
  3. 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.
  4. Mitglieder nutzen, was das Plugin anbietet – neue Menüpunkte, Felder oder Hinweise erscheinen an den gewohnten Stellen.

Vertrauen und Sicherheit

Ein Plugin ist Programmcode, der im selben Prozess wie QuickTribe läuft – mit denselben Rechten wie die Plattform selbst: Zugriff auf die Datenbank, auf gespeicherte Dateien und auf die Konfiguration samt Geheimnissen. Installieren Sie nur Plugins aus einer Quelle, der Sie vertrauen, und lassen Sie fremden Code vorher prüfen.
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 root gehö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:doctor meldet das als Fehler.
  • Nur im Worker schreibbar. In den Docker-Varianten ist der Plugin-Ordner in den Diensten app und migrate nur lesbar eingehängt; schreiben kann nur der Dienst worker (als Ziel für Updates), und auch dort laufen die Prozesse als www-data, das die Dateien nicht ändern darf.
Was ein Plugin Mitgliedern anzeigt, richtet sich nach der Sichtbarkeit in QuickTribe (z. B. Name und Anschrift nur für das Team, wenn die Community das so eingestellt hat); E-Mail-Adressen, Geburtsdatum und Geburtsjahr gibt die Schnittstelle nie heraus. Plugins, die personenbezogene Daten speichern, nehmen am Datenexport und an der Kontolöschung teil und bringen einen Absatz für die Datenschutz-Vorlage der Community mit.

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 Umgebungsvariable APP_PLUGIN_LICENSE_URL ist dafür reserviert und bleibt leer.

Weiter