---
title: "Plugins – Überblick"
description: "Was Plugins (Erweiterungen) können, wer sie installiert und einschaltet, wie weit man ihnen vertrauen muss und welche Zustände es gibt"
---

**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

| Bereich | Möglichkeiten |
| --- | --- |
| Eigene Seiten und Menüpunkte | Seiten in einer Community (`/c/<slug>/plugins/<id>`) oder außerhalb (`/plugins/<id>`); Menüpunkte in der Hauptleiste, im Benutzermenü und im Plattform-Admin |
| Events | eigene Felder im Event-Editor, Angaben in der Event-Ansicht und auf den Karten der Event-Liste |
| Mitglieder | Zusatzangaben im Profil und bei Beitrittsanfragen (z. B. eine Mitgliedsnummer), eigene Bereiche im Profil und im Leaderboard |
| Feed und Kurse | eigene Felder im Beitrags-, Kurs- und Lektions-Editor, Angaben unter Beiträgen, auf der Kursseite und unter Lektionen |
| E-Mail-Serien, Landingpages, Formulare | eigene Platzhalter, Bausteine und Feldtypen in den Editoren der Einstellungen |
| Leaderboard | Einträge ausblenden oder Bonuspunkte anzeigen |
| Reaktionen auf Ereignisse | Beitritt, Freigabe, Austritt, Sperre, Rollenwechsel, Punkte, Kontolöschung; Anlegen, Ändern und Löschen von Events, Zusagen, Absagen, Check-ins; Beiträge, Kommentare, abgeschlossene Lektionen und Kurse, verschickte Serien-Mails, eingereichte und freigegebene Formulare |
| Benachrichtigungen | Glocke, Push und E-Mail (abbestellbar über „E-Mails von Erweiterungen“) |
| Gruppen-Chats | Gruppen, die das Plugin selbst verwaltet (z. B. je Fahrgemeinschaft) |
| Hintergrund | wiederkehrende Jobs und einzelne Aufgaben (z. B. große Exporte) im Worker |
| Dokumente | PDF, CSV und Excel (XLSX), verschlüsselt abgelegte Dateien, Signaturen und auf Wunsch Zeitstempel einer externen Stelle |
| Einstellungen | plattformweit (Plattform-Admin) und je Community (Owner und Admins) |

Was ein Plugin konkret tut, beschreibt sein Anbieter. Zum Ausprobieren und als Vorlage für eigene Entwicklungen gibt es das [Beispiel-Plugin](/plugins/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](/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](/handbuch/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](/handbuch/owner/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

<Warning>
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.
</Warning>

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:

| Status | Bedeutung |
| --- | --- |
| **aktiv** | plattformweit aktiviert, fehlerfrei geladen, alle Migrationen ausgeführt – das Plugin wirkt |
| **inaktiv** | erkannt, aber nicht aktiviert |
| **Migration offen** | aktiviert, aber eine Migration steht noch aus – das Plugin wird nicht geladen, bis sie gelaufen ist (siehe [Migrationen](/plugins/betrieb#migrationen)) |
| **Fehler** | Manifest, Anforderungen, Code oder eine Migration sind fehlerhaft, oder das Plugin ist beim Laden gescheitert; die Meldung steht daneben. Ein Fehler, der älter als 25 Stunden ist oder vor der letzten Änderung der Plugin-Dateien lag, erscheint nur noch als „Früherer Fehler“ |
| **unsicher** | Dateirechte, Eigentümer oder Links verletzen die Regeln oben – das Plugin wird nicht geladen |
| **nicht gefunden** | es gibt Daten oder eine Aktivierung, aber der Ordner fehlt |

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

- Betreiber: [Plugins installieren](/plugins/installieren) und [Plugins betreiben](/plugins/betrieb) (Migrationen, Updates, Worker, Zeitstempel, Fehlersuche)
- Plattform-Admins: [Plattform-Admin → Plugins](/handbuch/plattform-admin/plugins)
- Owner und Admins: [Einstellungen → Plugins](/handbuch/owner/plugins)
- Entwickler: [Plugins entwickeln](/plugins/entwickeln)
