NOTICE
Dokumentation
NOTICE
Wofür ist das?
Mit NOTICE zeigen Sie Hinweise / Banner für die Nutzer Ihres Mandanten an.
Typische Beispiele:
- „Wartungsarbeiten am 20.05. von 18:00–22:00“
- „Neue Funktion: Ticket-Plugin verfügbar“
- Pflicht-Hinweis, den jeder einmal bestätigen muss
Pro Notice können Sie u.a. festlegen:
- Titel und Text
- Sichtbarkeitszeitraum
- ob der Hinweis bestätigt werden muss („dismiss“) oder als Banner stehen bleibt
- für welche Rolle(n) er angezeigt wird
Es gibt auch eine Übersicht, wer den Hinweis schon gelesen hat.
Typische Aufgaben (Alltag)
- Hinweis anlegen
- Hinweis aktivieren / deaktivieren
- Sehen, wer ihn schon weggeklickt hat
- Hinweis löschen
Schritt-für-Schritt
1) Hinweise verwalten
1. Admin → Hinweise (/settings/admin/notices).
2. Sie sehen die Liste mit Status (aktiv / inaktiv) und Zeitraum.
2) Neuer Hinweis
1. „Neu“ (/settings/admin/notices/new).
2. Felder ausfüllen:
- Titel, Text (HTML/Markdown je nach Editor)
- Zeitraum (von / bis)
- Sichtbarkeit (Rolle / alle)
- Verhalten (dauerhaft sichtbar oder einmalig wegklickbar)
3. Speichern (POST /settings/admin/notices/save).
3) Aktivieren / Deaktivieren
POST /settings/admin/notices/{id}/activate– sofort sichtbar.POST /settings/admin/notices/{id}/deactivate– ausblenden.
4) Lese-/Bestätigungsstatus
GET /settings/admin/notices/{id}/reads– zeigt, welche Benutzer den Hinweis gesehen / weggeklickt haben.
5) Hinweis löschen
POST /settings/admin/notices/{id}/delete.
6) Endnutzer: Hinweis wegklicken
- Wenn der Hinweis als „dismiss-bar“ markiert ist, kann jeder Nutzer ihn einmalig schließen:
POST /notices/{id}/dismiss.- Danach ist er für diesen Nutzer nicht mehr sichtbar (für andere weiterhin, bis sie selbst dismissen).
Häufige Fragen / Probleme
„Mein Hinweis wird niemandem angezeigt“
- Aktiv geschaltet?
- Datum „von/bis“ passt zum aktuellen Datum?
- Rolle korrekt?
„Ein Nutzer behauptet, den Hinweis nie gesehen zu haben“
- Read-Status (
{id}/reads) prüfen. - Eventuell wurde der Hinweis erst nach seinem Login aktiviert.
„Der Hinweis nervt jeden Tag aufs Neue“
- Verhalten auf „einmal wegklickbar“ stellen statt „immer anzeigen“.
Technische URLs (Kurzreferenz)
Admin (/settings/admin/notices):
GET /settings/admin/notices– ListeGET /settings/admin/notices/new– NeuGET /settings/admin/notices/{id}/edit– BearbeitenPOST /settings/admin/notices/save– SpeichernPOST /settings/admin/notices/{id}/activatePOST /settings/admin/notices/{id}/deactivatePOST /settings/admin/notices/{id}/deleteGET /settings/admin/notices/{id}/reads– Lesestatus
Endnutzer:
POST /notices/{id}/dismiss– Hinweis wegklicken
Hinweise
- Setzen Sie Hinweise sparsam ein – sonst werden sie ignoriert.
- Sensible Informationen lieber per MAIL senden, statt im Banner anzuzeigen.