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

3 KiB
Raw Blame History

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

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).