- /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>
52 lines
3 KiB
Markdown
52 lines
3 KiB
Markdown
# 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).
|