---
title: "Plugins"
description: "Plugins im Plattform-Admin: Übersicht und Status, aktivieren, deaktivieren, Migrationen ausführen, Details, plattformweite Einstellungen und Signaturschlüssel"
---

Unter **Plattform-Admin → Plugins** (`/admin/plugins`) verwaltest du die Erweiterungen der Plattform. Installieren kann sie nur der Betreiber, indem er die Dateien auf den Server legt (siehe [Plugins installieren](/plugins/installieren)); hier entscheidest du, welche davon wirken. Was Plugins sind und wie weit man ihnen vertrauen muss, steht im [Überblick](/plugins/ueberblick).

## Übersicht

Oben stehen das Plugin-Verzeichnis sowie die Versionen der Plugin-Schnittstelle und von QuickTribe. Darunter ein Hinweis, falls die Prüfung der Dateirechte ausgeschaltet ist (`APP_PLUGINS_ALLOW_WRITABLE`, nur für die Entwicklung gedacht) oder das Verzeichnis selbst unsicher ist – dann lädt QuickTribe gar kein Plugin.

Je Plugin zeigt eine Karte:

| Angabe | Bedeutung |
| --- | --- |
| Name, ID, Version, Anbieter, Beschreibung | aus dem Manifest des Plugins (`plugin.json`) |
| Status | **aktiv**, **inaktiv**, **Migration offen**, **Fehler**, **unsicher** oder **nicht gefunden** (siehe [Zustände](/plugins/ueberblick#zustände)) |
| Stile nicht geladen – neu bauen | Warnzeichen neben dem Status: Die Oberfläche des Plugins wurde mit einem älteren Stand gebaut, ihr CSS ist nicht auf das Plugin beschränkt und könnte die Darstellung der Plattform verändern. QuickTribe lädt es deshalb nicht; das Plugin funktioniert, sieht aber ungestaltet aus. Abhilfe: Plugin neu bauen lassen (siehe [Nach einem Update](#nach-einem-update)) |
| Anforderungen | mit welchen Versionen von QuickTribe und der Plugin-Schnittstelle das Plugin läuft |
| Gilt für | **alle Communities** oder **einzelne Communities (Opt-in)** – dann mit der Zahl der Communities, in denen es eingeschaltet ist |
| Lizenz | Produktname mit „Lizenzprüfung folgt“ – geprüft wird in dieser Version nicht |
| Datenschutz | „verarbeitet personenbezogene Daten“, wenn das Plugin das angibt |
| Offene Löschungen | Kontolöschungen bzw. gelöschte Communities, deren Daten das Plugin noch nicht entfernt hat; QuickTribe versucht es stündlich erneut, nach drei Fehlschlägen steht ein Hinweis dabei |
| Fehler | Fehler im Manifest, im Code oder in Migrationen, Gründe für „unsicher“ sowie der **Letzte Fehler** zur Laufzeit mit Zeitpunkt. Ist er älter als 25 Stunden oder älter als die letzte Änderung der Plugin-Dateien, heißt er **Früherer Fehler** und zählt nicht mehr als Fehler |

### Nach einem Update

Ab Version 2.24 wirken die Stile eines Plugins nur noch in dessen eigener Oberfläche. Plugin-Oberflächen, die vorher gebaut wurden, lädt QuickTribe ohne ihre Stile und zeigt **Stile nicht geladen – neu bauen**. Der Betreiber baut das Plugin mit dem aktuellen Stand neu (`npm run build:plugins <id>` in der Entwicklungsumgebung) und spielt es zusammen mit dem Update der Plattform ein (siehe [Updates](/updates)). Das Beispiel-Plugin aus dem neuen Paket ist bereits neu gebaut – übernehmen Sie es von dort (bzw. bauen Sie es neu), eine ältere Kopie im Ordner `plugins` zeigt sonst **Stile nicht geladen**.

## E-Mails von Plugins

Unter der Liste stellst du ein, wie viele E-Mails ein Plugin je Stunde in einer Community verschicken darf – getrennt für E-Mails des Plugins an Mitglieder (Standard 300) und für Einladungen an Adressen ohne Konto (Standard 50); erlaubt sind jeweils 1 bis 1000. Rundschreiben und andere E-Mails eines Plugins an Adressen ohne Konto zählen zum ersten Wert, nur Einladungen zum zweiten. Darüber verschickt das Plugin in dieser Stunde keine weiteren; Plugins wie die Mitgliedsverwaltung Plus reihen Rundschreiben und Einladungen ein und verschicken den Rest in der nächsten Stunde. Die Änderung steht im Protokoll.

## Aktionen

| Knopf | Wirkung |
| --- | --- |
| **Aktivieren** | Führt die Migrationen des Plugins aus und schaltet es plattformweit ein. Plugins „je Community“ sind danach in allen Communities **aus**, bis Owner oder Admins sie unter Einstellungen → Plugins einschalten. Erscheint nur bei fehlerfreien, sicheren Plugins |
| **Migrationen ausführen** | Holt offene Migrationen eines aktivierten Plugins nach (Status „Migration offen“, z. B. nach einer neuen Fassung) |
| **Deaktivieren** | Schaltet das Plugin nach einer Rückfrage plattformweit aus. Seine Daten bleiben erhalten; Datenexport und Kontolöschung berücksichtigen sie weiter |
| **Fehlermeldung zurücksetzen** | Blendet die letzte Laufzeit-Fehlermeldung aus, z. B. nachdem die Ursache behoben ist |
| **Details** | öffnet die Detailseite |

**Aktivieren** und **Migrationen ausführen** führen Code des Plugins in der Datenbank aus und verlangen deshalb, dass du dich in den **letzten 10 Minuten angemeldet** hast („angemeldet bleiben“ zählt nicht). Sonst erscheint der Hinweis, dich ab- und wieder anzumelden und es innerhalb von 10 Minuten erneut zu versuchen.

Schlägt eine Migration fehl, nennt die Meldung Datei, Nummer der Anweisung und die Meldung der Datenbank. Das Plugin bleibt dann auf **Fehler** bzw. **Migration offen** und wirkt nicht, bis eine korrigierte Fassung eingespielt und migriert ist (siehe [Migrationen](/plugins/betrieb#migrationen)).

<Note>
Verarbeitet ein Plugin personenbezogene Daten, sollten Owner ihre Datenschutzerklärung prüfen: Die Vorlage unter Einstellungen → Rechtstexte enthält dann einen Absatz des Plugins. Gilt das Plugin für alle Communities, betrifft das jede Community – informiere die Owner vor dem Aktivieren.
</Note>

## Detailseite

Die Detailseite (`/admin/plugins/<id>`) zeigt:

- **Details:** Verzeichnis, Namespace, Anforderungen, Geltungsbereich, Website, Lizenz, Datenschutz, aktivierte Version mit Zeitpunkt, Inhalts-Hash der Dateien (ändert sich mit jeder neuen Fassung) und offene Löschungen. Darüber die Aktionen wie in der Übersicht.
- **Fehler und Hinweise:** letzter Fehler im Volltext, Fehler und Warnungen der Prüfung, Gründe für „unsicher“.
- **Migrationen:** jede Migrationsdatei mit Zahl der Anweisungen und Stand – *ausgeführt* (mit Zeitpunkt), *offen*, *unterbrochen nach … von … Anweisungen*, *nach dem Ausführen geändert* oder *ausgeführt, Datei fehlt*.
- **Communities mit eingeschaltetem Plugin** (nur bei Plugins je Community), gesperrte mit Kennzeichen.
- **Plattform-Einstellungen:** das Formular für die plattformweiten Einstellungen des Plugins, sobald es wirksam aktiv ist. Geheime Werte werden verschlüsselt gespeichert und nicht wieder angezeigt („Gespeichert – leer lassen, um den Wert zu behalten“, **Gespeicherten Wert entfernen**).
- **Öffentliche Signaturschlüssel:** Stellt ein Plugin Signaturen aus (z. B. auf PDF-Dokumenten), stehen hier seine öffentlichen Schlüssel mit Kennung und Status (*erzeugt*, *stillgelegt*). Damit lässt sich prüfen, ob ein Dokument von dieser Installation signiert wurde.

## Menüpunkte von Plugins

Plugins können eigene Seiten für Plattform-Admins mitbringen. Ihre Menüpunkte stehen im Admin-Menü und in der Seitenleiste von `/admin`; die Seiten selbst liegen unter `/plugins/<id>/…`.

## Protokoll und Konsole

Aktivieren, Deaktivieren, Migrationen und Änderungen an Plattform-Einstellungen stehen im [Protokoll](/handbuch/plattform-admin/protokoll) (Community-Spalte „Plattform“, Aktionen `platform.plugin.enabled`, `platform.plugin.disabled`, `platform.plugin.migrated`, `platform.plugin.settings_updated` – Einstellungen nur mit den Namen der Felder). Dasselbe geht auf der Konsole mit `app:plugin:list`, `app:plugin:enable`, `app:plugin:disable`, `app:plugin:validate` und `app:plugin:migrate` (siehe [Konsole → Plugins](/handbuch/plattform-admin/konsole#plugins)).
