# 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-.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-.zip ``` Tests laufen in einer Inhaus-Installation mit dem Plugin unter `plugins/gruppen`: `vendor-dev/bin/phpunit plugins/gruppen/tests`.