inhaus-plugin-kleinanzeigen/README.md
Friederich Loheide 2129e9a5c6 Kleinanzeigen 1.1.0: Schnittstelle für die App
- /api/v1/kleinanzeigen: Liste mit Filtern, meta, meine, Anzeige, Formular,
  aufgeben/speichern mit Fotos, löschen, verlängern/erledigt/reserviert,
  Merkliste, Kontakt (Chat mit conversation_id oder E-Mail), Melden, Fotos mit Token
- Foto-Adressen zeigen bei API-Aufrufen auf die API

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-09-27 20:11:15 +00:00

52 lines
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.

# Kleinanzeigen – Plugin für Inhaus
Der Kleinanzeigenmarkt im Mitarbeiterportal – von Kolleginnen und Kollegen für Kolleginnen und Kollegen.
- **Verkaufe, Verschenke, Suche, Tausche** in 13 Kategorien (Möbel, Kinder, Fahrräder, Mitfahrgelegenheit, Hilfe …),
Preis mit „VB“, Ort bzw. Abholung, optional Telefon, bis zu 8 Fotos (werden verkleinert).
- **Freigabe durch die Moderation**: Neue Anzeigen – und inhaltliche Änderungen an freigegebenen – erscheinen erst nach
Prüfung durch Personen mit dem Recht **„Kleinanzeigen freigeben und moderieren“**. Zurückgeben mit Begründung.
- **30 Tage Laufzeit**, Erinnerung drei Tage vorher, mit einem Klick verlängern; „reserviert“ und „erledigt“ markieren.
- **Kontakt**: „Im Chat schreiben“, wenn das Plugin *Nachrichten* (inhaus-plugin-chat) aktiv ist – sonst per E-Mail
(die Adresse der anbietenden Person bleibt verborgen, geantwortet wird direkt).
- **Merkliste**, **Suche** und Filter, Anzeigen **melden**, Kachel auf der Startseite, Treffer in der globalen Suche,
Abschnitt im Wochenüberblick.
- Fotos liegen nicht im öffentlichen Ordner – nur angemeldete Mitarbeitende sehen sie.
Voraussetzung: Inhaus **0.39.0** oder neuer. Optional: Plugin *Nachrichten* für den Kontakt per Chat.
## Installation
1. `kleinanzeigen-<version>.zip` unter https://git.loheide.cloud/friloo/inhaus-plugin-kleinanzeigen/releases laden.
2. Backend → **Plugins** → hochladen → aktivieren. Updates erscheinen danach automatisch.
3. Unter **Rollen** das Recht **„Kleinanzeigen freigeben und moderieren“** vergeben. Ohne solche Rolle geht die Freigabe
an die Administration.
## Schnittstelle für die App
Unter `/api/v1/kleinanzeigen/…` (Token nötig), dieselben Regeln wie im Portal (neue und geänderte Anzeigen
gehen in die Freigabe):
| Methode | Pfad | Zweck |
|---|---|---|
| GET | `/?q=&typ=&kategorie=&sortierung=&merkliste=1&page=` | sichtbare Anzeigen (24 je Seite) |
| GET | `meta` | Arten, Kategorien, `max_photos`, eigener Ort, Zahl eigener bzw. wartender Anzeigen |
| GET | `meine` | eigene Anzeigen mit Status und Hinweis der Moderation |
| GET | `{id}`, `{id}/bearbeiten` | Anzeige / Werte zum Bearbeiten |
| POST | `/`, `{id}` | aufgeben / speichern (multipart: `photos[]`, `remove_photos[]`) |
| DELETE | `{id}` | löschen |
| POST | `{id}/verlaengern`, `{id}/erledigt`, `{id}/reserviert` | eigene Anzeige verwalten |
| POST / DELETE | `{id}/merken` | Merkliste |
| POST | `{id}/kontakt {message}` | Nachricht: `via: chat` mit `conversation_id` (Chat-Plugin) oder `via: mail` |
| POST | `{id}/melden {reason}` | an die Moderation melden |
| GET | `bilder/{id}/{thumb\|full}` | Fotos (Adressen in API-Antworten zeigen hierher) |
## Entwicklung
```bash
npm install && npm run build # dist/ wird eingecheckt
npm run package # kleinanzeigen-<version>.zip
```
Tests laufen in einer Inhaus-Installation mit dem Plugin unter `plugins/kleinanzeigen`:
`vendor-dev/bin/phpunit plugins/kleinanzeigen/tests` (der Chat-Test läuft nur, wenn auch `plugins/chat` vorhanden ist).