Admin · Konfiguration

Telegram-Templates

Hier (/admin/telegram-templates.php) gestaltest Du die Texte der Telegram-Nachrichten. Du brauchst das Recht admin.config; die Seite ist nur bei aktivem Telegram im Admin-Menü. Wie Du Bot, Chats und Webhook einrichtest, steht unter Telegram.

Die sechs Templates

Oben wählst Du über die Reiter das Template, das Du bearbeiten willst:

Reiter Wofür
Hauptnachricht (main) Standard-Einsatz-Push
Alarmierungsliste (alarmierung) IuK-Sondernachricht mit LG-Alarmierungs-Block
Fehlernachricht (error) Meldung bei Mail-Parser-Problemen
Heartbeat (heartbeat) Täglicher Status-Ping
Reset-Meldung (reset) Meldung nach einem ETB-Reset
Selbsttest (selftest) Bestätigung des Telegram-Selbsttests

Ein Template bearbeiten

Links steht der Editor (Freitext), rechts ein klickbares Cheat-Sheet: ein Klick auf einen Platzhalter, einen bedingten Block oder ein Telegram-HTML-Tag (<b>, <i>, Link) fügt ihn an der Cursor-Position ein. Welche Platzhalter und Blöcke es gibt, hängt vom gewählten Template ab.

Unter dem Editor:

  • Template aktiv — Haken an: Deine Fassung wird verwendet. Haken aus: das ETB nimmt den hartkodierten Standard-Text dieses Templates.
  • Speichern — übernimmt Text + Haken.
  • Auf Default zurücksetzen — holt nach Rückfrage den Original-Text zurück in den Editor.
  • Test-Versand — schickt das aktuelle Template mit Beispiel-Daten an den Debug-Chat, damit Du das Layout ohne echten Einsatz prüfen kannst.

ℹ️ Der Test-Versand speichert das Template vorher — auch wenn der Versand selbst fehlschlägt (z. B. kein Debug-Chat hinterlegt).

Live-Vorschau

Unter dem Editor zeigt die Karte „Vorschau (Beispiel-Daten)" das gerenderte Ergebnis. Sie aktualisiert sich automatisch, während Du tippst. Heartbeat-, Reset- und Selbsttest-Vorschauen laufen mit eigenen Beispiel-Daten, weil diese Nachrichten nicht aus einer Alarm-Mail entstehen.

Bedingte Blöcke & Iteration

Ein bedingter Block rendert nur, wenn sein Feld gefüllt ist:

{#objekt}
Objekt: {objekt}
{/objekt}

Die Reset-Meldung hat zwei sich gegenseitig ausschließende Blöcke: {#ok}…{/ok} für den erfolgreichen Reset (grüner Haken) und {#fail}…{/fail}, wenn mindestens eine Operation fehlschlug (rotes Kreuz). {#prefix}…{/prefix} rendert nur beim manuellen Reset und nennt den auslösenden Benutzer.

⚠️ Der grüne Haken erscheint nur, wenn der Reset wirklich erfolgreich war: Eine fehlende Tabelle gilt als unkritisch (übersprungen), ein echter Datenbank-Fehler setzt dagegen die Fehler-Variante. So meldet Telegram nie „erfolgreich", obwohl Daten gar nicht gelöscht wurden.

Was als nächstes?