Diskussionsgruppen-Plugin für Inhaus: offen, geschlossen, privat – mit Beiträgen, Umfragen, Kommentaren
|
|
||
|---|---|---|
| bin | ||
| database/migrations | ||
| dist | ||
| inhaus-sdk | ||
| resources | ||
| routes | ||
| src | ||
| tests | ||
| .gitignore | ||
| package-lock.json | ||
| package.json | ||
| plugin.json | ||
| README.md | ||
| vite.config.js | ||
Gruppen – Diskussionsgruppen für Inhaus
Austausch zu Themen, Hobbys und Projekten – wie Gruppen bei Facebook, im eigenen Mitarbeiterportal.
- Alle können Gruppen gründen, in drei Arten:
- Offen – alle sehen die Beiträge und treten mit einem Klick bei.
- Geschlossen – alle finden die Gruppe, Beiträge sehen nur Mitglieder; Beitritt auf Anfrage.
- Privat – nur Mitglieder finden die Gruppe; Beitritt nur auf Einladung.
- Beiträge mit Text (Links werden erkannt), bis zu 10 Fotos und Dateien, Umfragen (eine oder mehrere Antworten), Reaktionen (👍 ❤️ 😂 😮 😢 👏), Kommentare mit Antworten; eigene Beiträge bearbeiten.
- Rollen je Gruppe: Admin, Moderation, Mitglied. Admins bearbeiten die Gruppe (Name, Beschreibung, Art, Titelbild), vergeben Rollen und löschen die Gruppe; Moderation nimmt Anfragen an, pinnt Beiträge (bis zu 3), löscht Beiträge und Kommentare und bearbeitet Meldungen der Mitglieder.
- Benachrichtigungen: neuer Beitrag (je Gruppe einmal, bis man wieder vorbeischaut; pro Gruppe abschaltbar), Kommentare zu eigenen Beiträgen, Antworten, Einladungen, Beitrittsanfragen.
- Feed „Neues aus Ihren Gruppen“, Gruppen entdecken, Treffer in der globalen Suche, Startseiten-Kachel, Abschnitt im Wochenüberblick.
- Fotos, Dateien und Titelbilder liegen nicht im öffentlichen Ordner und werden nur an Berechtigte ausgeliefert.
Das Recht „Alle Gruppen verwalten“ (Rollen) erlaubt, auch private Gruppen zu sehen und bei Meldungen einzugreifen – bitte nur an die Personen vergeben, die das wirklich brauchen.
Voraussetzung: Inhaus 0.39.0 oder neuer.
Installation
gruppen-<version>.zipunter https://git.loheide.cloud/friloo/inhaus-plugin-gruppen/releases laden.- Backend → Plugins → hochladen → aktivieren. Updates erscheinen danach automatisch.
Schnittstelle für die App
Unter /api/v1/gruppen/… (Token nötig), dieselben Regeln wie im Portal:
| Methode | Pfad | Zweck |
|---|---|---|
| GET | /?vor= |
eigene Gruppen, Einladungen, Beiträge aus allen eigenen Gruppen (15 je Seite) |
| GET | entdecken?q=&page= |
sichtbare Gruppen mit eigenem Status |
| GET | {slug}?vor= |
Gruppe, Mitgliedschaft, Rechte (can), Mitglieder, Beiträge (angepinnte zuerst) |
| POST | {slug}/beitreten, {slug}/verlassen |
beitreten bzw. Anfrage stellen, Einladung annehmen / verlassen |
| PUT | {slug}/benachrichtigungen {notify: all|off} |
Benachrichtigungen zu neuen Beiträgen |
| POST | {slug}/beitraege {body, files[], poll[], multiple} |
Beitrag schreiben (multipart mit Dateien) |
| GET | beitraege/{id} |
Beitrag mit allen Kommentaren |
| POST | beitraege/{id}/reaktion {emoji}, /abstimmen {options[]}, /kommentare {body, parent_id}, /melden {reason} |
reagieren, abstimmen, kommentieren, melden |
| DELETE | beitraege/{id}, kommentare/{id} |
löschen (eigene bzw. als Moderation) |
| GET | dateien/{id}/{thumb|full}, {slug}/titelbild |
Fotos, Dateien, Titelbild (Adressen in API-Antworten zeigen hierher) |
Entwicklung
npm install && npm run build # dist/ wird eingecheckt
npm run package # gruppen-<version>.zip
Tests laufen in einer Inhaus-Installation mit dem Plugin unter plugins/gruppen:
vendor-dev/bin/phpunit plugins/gruppen/tests.