Personenbezogene Daten
Speichert ein Plugin Daten über Personen, setzt es im Manifest"privacy": { "personalData": true } und implementiert in der Einstiegsklasse App\Plugin\Api\PrivacyAware. Fehlt die Schnittstelle, ist das Plugin fehlerhaft und wird nicht geladen.
Liest ein Plugin volle Geburtsdaten (members()->birthDates(), ab Plugin-API 1.2), gibt es zusätzlich "birthDates": true an. Die Datenschutz-Vorlage der Community sagt dann im Absatz „Geburtstag“, dass Owner, Admins und Plattform-Administratoren mit Mitgliedschaft das vollständige Datum in der Mitgliederverwaltung sehen; der eigene Absatz des Plugins (privacyNotice) darf dem nicht widersprechen. Nach einem Update, das die Angabe neu einführt, sollte das Plugin Owner und Admins bitten, die Datenschutzerklärung aus der Vorlage zu aktualisieren.
Behält ein Plugin nach der Löschung eines Kontos eigene Unterlagen zur Person (etwa eine Mitgliedsakte, ab Plugin-API 1.5), gibt es "accountSnapshot": true an. Der Kern hält dann vor dem Anonymisieren Name, Anschrift, Geburtsdatum und Handynummer fest – je Community nur, was sie abfragt – und gibt sie dem Plugin genau einmal während deleteUserData() über members()->accountSnapshot($communityId, $userId). Die Momentaufnahme liegt verschlüsselt an der Löschaufgabe des Plugins und verschwindet mit ihr; scheitert deleteUserData(), bekommt die Wiederholung sie erneut. Das Plugin übernimmt nur, was es braucht, nennt es in seinem Absatz und darf daraus nichts an Dritte weitergeben. Die Datenschutz-Vorlage der Community nennt das Plugin dann im Absatz zur Speicherdauer.
Gleicht ein Plugin E-Mail-Adressen mit den Konten ab (members()->verifiedEmail(), matchEmails(), ab Plugin-API 1.3 – etwa um Akten aus einer Vereinsliste beim Beitritt zuzuordnen), gibt es "memberEmails": true an. Jeder Abgleich steht im Protokoll der Community; die Adressen selbst stehen dort nicht. Der eigene Absatz des Plugins sagt, wofür es die Adresse nutzt. Dieselbe Angabe braucht ein Plugin, das Adressen ohne Konto anschreibt (mailer()->sendToAddress(), ab 1.8); meldet sich jemand über den Link in einer solchen Mail ab, speichert die Plattform nur einen Prüfwert der Adresse (nicht die Adresse) und löscht ihn mit der Community.
Datenexport
exportUserData(string $userId, ExportBundle $bundle): array liefert die Daten der Person für den Datenexport unter Konto → Datenschutz. Das Ergebnis landet in export.json unter plugins.<id>.
- Nur Daten über diese Person; andere Personen erscheinen höchstens als „anderes Mitglied“.
- Dateien kommen mit
$bundle->addFile(string $path, int $size, \Closure $producer)ins ZIP unterplugins/<id>/<path>; der Producer bekommt einen Schreiberfn(string $chunk)(z. B. fürstorage()->…->streamEncrypted()). Dateien über 20 MB stehen nur in der Liste großer Dateien. - Muss das Plugin Daten aus rechtlichen Gründen aufbewahren, nennt es das mit
$bundle->noteRetention('{count} Einträge im Schießbuch werden bis {until} aufbewahrt.', [...])– der Text erscheint inplugins/LIESMICH.txtdes Exports. - Scheitert das Plugin, läuft der Export trotzdem weiter; unter
plugins.<id>steht dann ein Fehler. - Zusatzfelder exportiert der Kern selbst: Mitgliedsfelder unter
memberships[].pluginFields, ab 1.2 die Felder, die der Autor an eigenen Beiträgen setzt (Editor::Author), unterposts[].pluginFields– nur von Plugins, die in der Community eingeschaltet sind. Felder, die das Team setzt, gehören nicht zur Person und fehlen dort.
Kontolöschung
deleteUserData(string $userId): void löscht oder anonymisiert alle Daten der Person.
- Reihenfolge: Erst gehen die Hooks
member.left(Grundaccount_deleted) je Mitgliedschaft undaccount.deletedhinaus, danach ruft der KerndeleteUserData(). Wer andere benachrichtigen will (etwa Mitfahrer einer abgesagten Fahrt), tut das im Hook;deleteUserData()selbst verschickt nichts. - Idempotent: Der Kern merkt sich jede offene Löschung und wiederholt sie stündlich, bis sie gelingt; nach drei Fehlschlägen erscheint ein Hinweis unter Plattform-Admin → Plugins. Die Kontolöschung selbst wartet nie auf ein Plugin.
- Zusatzfelder an Mitgliedern (
ExtraFieldmitTarget::Member) exportiert und löscht der Kern selbst.
Gelöschte Communities
deleteCommunityData(string $communityId): void löscht alle Daten einer gelöschten Community – ebenfalls mit Wiederholung. Innerhalb dieses Aufrufs sind Zustand, Cache, Speicher und Einstellungen der gelöschten Community noch erreichbar; danach entfernt der Kern den Speicherbereich des Plugins für diese Community sowie Zustand und Einstellungen.
Aufbewahrungspflichten
Muss ein Plugin Daten gesetzlich aufbewahren (z. B. Schießbücher), löscht es sie indeleteUserData() nicht, sondern sperrt oder anonymisiert, was möglich ist, und weist darauf hin – mit noteRetention() im Export und im Absatz für die Datenschutzerklärung.
Absatz für die Datenschutzerklärung
null. Nennt der Absatz eine Frist, hält ein täglicher Job sie ein – in allen Communities mit Daten, auch dort, wo das Plugin gerade ausgeschaltet ist (siehe Abgleich und Löschfristen). Die Vorlage der Datenschutzerklärung unter Einstellungen → Rechtstexte (Vorlage einfügen) enthält für jedes Plugin, das in der Community wirkt, einen Absatz mit dessen Namen als Überschrift. Schalten Owner ein Plugin mit personalData ein, erinnert sie die Oberfläche daran, ihre Datenschutzerklärung zu prüfen.
Beispieldaten (DemoAware)
Der Befehlapp:demo:seed legt eine Beispiel-Community mit erfundenen Inhalten an (siehe Konsole → Beispiel-Community). Plugins können dort eigene Beispieldaten ergänzen, indem die Einstiegsklasse App\Plugin\Api\DemoAware implementiert:
DemoSeedliefertcommunity(CommunityInfo),refresh(Ergänzungslauf),now(UTC – „Zukunft“ heißt nachnow),randomSeedfür eine wiederholbare Auswahl undprofile: das Inhaltsprofil der Beispiel-Community (standardoderschuetzenverein, KonstantenDemoSeed::PROFILE_*;--refreshliefert das Profil der Anlage). Unbekannte Profile – auch weitere mitgelieferte wiereitverein– behandelst du wiestandard.- Im Profil
schuetzenvereingibt es die eigenen Rollen „Vorstand“, „Schießleiter“, „Standaufsicht“, „Jugendleiter“, „Kasse“, „Theke“ und „Waffenwart“ (übermembers()->customRoles()undwithCustomRole()), Trainings-Serien („Training Luftdruck 10 m“, „KK/GK-Training“, „Jugendtraining“ – nur unter 18) und Auswärtstermine mit dem TagAuswärts. Daran kann ein Plugin seine Beispieldaten ausrichten, z. B. Aufsichten aus der Rolle „Standaufsicht“ oder Fahrgemeinschaften zu Auswärtsterminen:
- Nur
app:demo:seedruft die Methode auf – nie die Demo-Daten der Entwicklungsumgebung und nie ohne diesen Befehl. Der Befehl schaltet Plugins, die je Community gelten, in seiner eigenen Beispiel-Community vorher ein; bei--refreshnur neu hinzugekommene, ein dort ausgeschaltetes Plugin bleibt aus. - Daten über die Kern-Dienste anlegen, ohne E-Mails, Glocken oder Push.
- Bei
refreshnur ergänzen (z. B. kommende Termine), nie löschen; jeder Lauf ist idempotent. - Fehler fängt der Kern je Plugin ab; die Ausgabe des Befehls nennt je Plugin
ok,skippedoderfailed, das Protokoll erhältcommunity.demo_plugins_seeded.