Kleinanzeigen-Plugin für Inhaus: von Kollegen für Kollegen
- /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> |
||
|---|---|---|
| bin | ||
| database/migrations | ||
| dist | ||
| inhaus-sdk | ||
| resources | ||
| routes | ||
| src | ||
| tests | ||
| .gitignore | ||
| package-lock.json | ||
| package.json | ||
| plugin.json | ||
| README.md | ||
| vite.config.js | ||
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
kleinanzeigen-<version>.zipunter https://git.loheide.cloud/friloo/inhaus-plugin-kleinanzeigen/releases laden.- Backend → Plugins → hochladen → aktivieren. Updates erscheinen danach automatisch.
- 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
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).