Docs

NOTICE

Dokumentation
Zurück

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 – Liste
  • GET /settings/admin/notices/new – Neu
  • GET /settings/admin/notices/{id}/edit – Bearbeiten
  • POST /settings/admin/notices/save – Speichern
  • POST /settings/admin/notices/{id}/activate
  • POST /settings/admin/notices/{id}/deactivate
  • POST /settings/admin/notices/{id}/delete
  • GET /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.