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