inhaus-plugin-gruppen/README.md
Friederich Loheide b29f6ada71 Gruppen 1.1.0: Schnittstelle für die App, „Gefällt mir“ mit Symbol
- /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>
2026-09-27 20:11:13 +00:00

55 lines
3.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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`.