- /api/v1/gruppen: Übersicht, entdecken, Gruppe, beitreten/verlassen, Benachrichtigungen, Beiträge, Reaktionen, Abstimmung, Kommentare, Melden, Fotos/Dateien/Titelbild mit Token - Datei- und Titelbild-Adressen zeigen bei API-Aufrufen auf die API - „Gefällt mir“ zeigt im Ruhezustand ein Daumen-Symbol statt eines Emojis (sieht auch ohne Emoji-Schrift richtig aus) Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
55 lines
3.3 KiB
Markdown
55 lines
3.3 KiB
Markdown
# 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
|
||
|
||
1. `gruppen-<version>.zip` unter https://git.loheide.cloud/friloo/inhaus-plugin-gruppen/releases laden.
|
||
2. 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
|
||
|
||
```bash
|
||
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`.
|