PHPackages erdmannfreunde/contao-status-update-bundle - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Admin Panels](/categories/admin) 4. / 5. erdmannfreunde/contao-status-update-bundle ActiveContao-bundle[Admin Panels](/categories/admin) erdmannfreunde/contao-status-update-bundle ========================================== Status-Updates Bundle for Contao - Display important status updates in the backend dashboard 1.3.0(2mo ago)4215LGPL-3.0-or-laterPHPPHP ^8.2 Since Jan 22Pushed 2mo agoCompare [ Source](https://github.com/erdmannfreunde/contao-status-update-bundle)[ Packagist](https://packagist.org/packages/erdmannfreunde/contao-status-update-bundle)[ Docs](https://github.com/erdmannfreunde/contao-status-update-bundle)[ RSS](/packages/erdmannfreunde-contao-status-update-bundle/feed)WikiDiscussions main Synced 1w ago READMEChangelogDependencies (20)Versions (9)Used By (0) Contao Status-Updates Bundle ============================ [](#contao-status-updates-bundle) Zeige wichtige Status-Updates wie anstehende Contao Updates im Contao Backend-Dashboard an. Funktionen ---------- [](#funktionen) - **Backend-Modul**: Verwalte Status-Updates über das Menü "Status-Updates" im Backend - **Datumsbasierte Sichtbarkeit**: Steuere, wann Updates erscheinen (X Tage vor/nach einem Ereignis) - **Rich-Text-Editor**: TinyMCE-Integration für detaillierte Beschreibungen - **Dashboard-Widget**: Automatische Anzeige im Backend basierend auf Sichtbarkeitsregeln - **Flexible Anzeigeregeln**: Konfiguriere, wie lange Updates sichtbar bleiben - **Farbcodierte Anzeige**: Visuelle Indikatoren für bevorstehende, aktuelle und vergangene Ereignisse - **Abgeschlossen-Status**: Markiere Updates als erledigt – das Dashboard zeigt sie dann grün mit einem Häkchen-Hintergrund-Icon - **E-Mail-Benachrichtigung**: Sende beim Abschließen eines Updates automatisch eine Mail an ausgewählte Backend-Benutzer (siehe Abschnitt "Benachrichtigungen") - **Frontend-Anzeige**: Zeige Status-Updates auch im Frontend an – z.B. Urlaubshinweise mit Zeitraum, Wartungsfenster oder Marketing-Aktionen mit Rabattcode (siehe Abschnitt "Frontend-Anzeige") Installation ------------ [](#installation) Installation über Composer: ``` composer require erdmannfreunde/contao-status-update-bundle ``` Verwendung ---------- [](#verwendung) ### Status-Updates erstellen [](#status-updates-erstellen) 1. Navigiere zu **Backend → System → Status-Updates** 2. Klicke auf "Neu", um ein Status-Update zu erstellen 3. Fülle die Felder aus: - **Titel**: Kurzer beschreibender Titel - **Beschreibung**: Detaillierte Informationen (unterstützt HTML über TinyMCE) - **Ereignisdatum**: Das Datum des Ereignisses - **Benachrichtigung vor Ereignis anzeigen**: Wie viele Tage vor dem Ereignis das Update angezeigt werden soll - 7 Tage vorher (Standard) - 10 Tage vorher - 30 Tage vorher - Nur am Ereignistag - **Benachrichtigung nach Ereignis anzeigen**: Wie viele Tage nach dem Ereignis das Update weiterhin angezeigt werden soll - Nur am Ereignistag (Standard) - 1 Tag danach - 7 Tage danach - **Veröffentlicht**: Aktivieren, um im Dashboard sichtbar zu machen - **Abgeschlossen**: Markiert das Update als erledigt. Im Dashboard wird es dann grün dargestellt und erhält ein dezentes Häkchen-Icon im Hintergrund. Lässt sich auch direkt aus der Übersicht über das Checkbox-Icon umschalten. 4. Speichere das Status-Update ### Dashboard-Anzeige [](#dashboard-anzeige) [![Contao Status-Updates Dashboard](docs/status-update-backend.png)](docs/status-update-backend.png) Status-Updates erscheinen automatisch im Backend-Dashboard basierend auf den Sichtbarkeitsregeln: - **Rot/Wichtig**: Ereignisse, die heute stattfinden - **Gelb/Warnung**: Ereignisse innerhalb der nächsten 3 Tage - **Blau/Info**: Zukünftige Ereignisse - **Grün/Erfolg**: Vergangene Ereignisse (innerhalb der "Danach"-Anzeigedauer) sowie als **abgeschlossen** markierte Updates (zusätzlich mit Häkchen-Hintergrund-Icon) Sichtbarkeitslogik ------------------ [](#sichtbarkeitslogik) Das Bundle berechnet, welche Status-Updates angezeigt werden, basierend auf: 1. **Aktuelles Datum** vs. **Ereignisdatum** 2. **Vorher anzeigen**-Einstellung (wie viele Tage im Voraus) 3. **Danach anzeigen**-Einstellung (wie viele Tage nach dem Ereignis) Beispiel: Wenn du "7 Tage vorher" und "1 Tag danach" für ein Ereignis am 15. Januar einstellst: - Das Status-Update wird ab dem 8. Januar angezeigt - Das Status-Update wird nach dem 16. Januar nicht mehr angezeigt Benachrichtigungen ------------------ [](#benachrichtigungen) Beim Markieren eines Status-Updates als **abgeschlossen** kann das Bundle automatisch eine E-Mail an ausgewählte Backend-Benutzer versenden. ### Einrichtung [](#einrichtung) Die Einstellungen sind über das Zahnrad-Icon oben rechts in der Status-Updates-Übersicht erreichbar (keine eigener Sidebar-Menüpunkt). Verfügbare Felder: - **E-Mail-Benachrichtigung aktivieren**: Master-Schalter. Wenn aus, wird nichts versendet. - **Betreff**: Betreff der Mail. Unterstützt die Platzhalter `##title##`, `##date##`, `##description##`. - **Nachricht**: HTML-Body der Mail (TinyMCE). Unterstützt dieselben Platzhalter sowie Contao-Insert-Tags. - **Empfänger**: Mehrfach-Auswahl aller Backend-Benutzer. Der aktuell angemeldete Benutzer wird **immer automatisch** ergänzt – auch wenn niemand sonst angehakt ist. ### Verhalten [](#verhalten) - Der Versand läuft pro Status-Update **genau einmal** (Flag `notification_sent`). Auch wenn der Status zwischendurch wieder geöffnet und erneut abgeschlossen wird, geht keine zweite Mail raus. - Der Versand erfolgt über die in Contao konfigurierte Standard-Versandart (Symfony `MailerInterface`, gesteuert über `MAILER_DSN`). - Als Absenderadresse wird die unter „System → Einstellungen → Administrator-E-Mail-Adresse" hinterlegte Adresse verwendet. - Backend-Benutzer ohne hinterlegte E-Mail-Adresse oder mit ungültiger Adresse werden übersprungen. - Insert-Tags in den Settings (z.B. `{{date}}`) werden ausgewertet; Insert-Tags in nutzergenerierten Status-Update-Feldern (Titel/Beschreibung) werden bewusst **nicht** ausgewertet, um eine Insert-Tag-Injection durch Editoren mit eingeschränkten Rechten zu verhindern. Frontend-Anzeige ---------------- [](#frontend-anzeige) Status-Updates können auch im Frontend ausgegeben werden – z.B. für: - Urlaubs- oder Abwesenheitshinweise mit konkretem Zeitraum - Wartungsfenster oder Störungsinfos - Marketing-Aktionen wie zeitlich begrenzte Rabattcodes ### Einrichtung [](#einrichtung-1) 1. Beim Status-Update das Feld **Anzeigebereich** auf "Nur im Frontend" oder "Backend und Frontend" stellen 2. Optional: **Anzeigen bis** setzen – das Update läuft automatisch aus, sobald dieses Datum überschritten ist. Leer lassen für ein dauerhaftes Update 3. **Typ** wählen (Neutral, Info, Erfolg, Warnung, Kritisch, Aktion) – steuert die Standard-Farben 4. Optional: **Kann geschlossen werden** aktivieren, damit Besucher:innen den Hinweis schließen können (Auswahl wird per `localStorage` gemerkt, bis das Update erneut bearbeitet wird) 5. Optional: **Auf Seiten einschränken** – leer lassen, um den Hinweis auf allen Seiten anzuzeigen. Bei Auswahl einer Seite wird das Update auf dieser Seite **und allen Unterseiten** angezeigt 6. Im Seitenlayout das **Frontend-Modul „Status-Updates"** platzieren (z.B. im Header oder als Banner-Slot) ### Auswahllogik [](#auswahllogik) Im Frontend wird ein Update angezeigt, wenn: - veröffentlicht und nicht als abgeschlossen markiert - Scope ist "Frontend" oder "Backend und Frontend" - Heute liegt im Zeitraum **Datum** – **Anzeigen bis** (jeweils inkl.) bzw. ab **Datum**, falls kein Anzeigen-bis gesetzt ist - Aktuelle Seite (oder eine ihrer Elternseiten) gehört zur Auswahl – oder die Auswahl ist leer Mehrere aktive Updates werden nach Typ-Priorität sortiert: Kritisch > Warnung > Info > Erfolg > Aktion > Neutral. ### Styling [](#styling) Die Default-Styles liegen in `public/css/frontend_status_updates.css`. CSS und Dismiss-JS werden **nur dann geladen, wenn das Modul auf der Seite tatsächlich aktive Updates rendert** – verwaltet über `{% block style %}` / `{% block script %}` im Twig-Template (`add 'key' to stylesheets/body`-Pattern wie beim Contao-Swiper). Das JS lädt zusätzlich nur, wenn mindestens ein Update als „schließbar" markiert ist. Override im Theme-SCSS in einer separaten Override-Datei (LASR/SOLO-Konvention) – nicht direkt im Theme-SCSS. Die Twig-Templates lassen sich überschreiben: - `frontend_module/status_updates.html.twig` (Modul-Wrapper inkl. Asset-Blöcke) Das Template stellt benannte Override-Blöcke bereit, sodass ein Theme nur den relevanten Teil austauschen muss, ohne das gesamte Template zu kopieren: BlockZweck`status_updates_styles`Stylesheet-Einbindung — Bundle-CSS unterdrücken oder eigenes laden`status_updates_scripts`Script-Einbindung — Dismiss-JS ersetzen oder weglassen`status_updates_noscript```-Fallback für dismissible Items`status_updates_items`Wrapper-Div + Items-Schleife — komplettes Markup ersetzen`status_updates_item`Markup eines einzelnen ```status_updates_close`Schließen-ButtonBeispiel: Bundle-CSS unterdrücken und eigenes Stylesheet aus dem Theme laden: ``` {% extends "@Contao/frontend_module/status_updates.html.twig" %} {% block status_updates_styles %} {% add 'theme_status_updates_css' to stylesheets %} {% endadd %} {% endblock %} ``` Anforderungen ------------- [](#anforderungen) - PHP 8.2 oder höher - Contao 5.3 oder höher - Symfony 6.4 oder 7.0 Lizenz ------ [](#lizenz) Dieses Bundle ist unter LGPL-3.0-or-later lizenziert. ### Health Score 44 — FairBetter than 90% of packages Maintenance87 Actively maintained with recent releases Popularity18 Limited adoption so far Community6 Small or concentrated contributor base Maturity53 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~29 days Recently: every ~35 days Total 6 Last Release 64d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/d0c18094f552ca25ac29a9ef3763092f24b2be3158b2d047e644eef8a8a10282?d=identicon)[erdmannfreunde](/maintainers/erdmannfreunde) --- Top Contributors [![denniserdmann](https://avatars.githubusercontent.com/u/3773697?v=4)](https://github.com/denniserdmann "denniserdmann (8 commits)") --- Tags notificationsupdatescontaodashboardbackendstatus ### Embed Badge ![Health badge](/badges/erdmannfreunde-contao-status-update-bundle/health.svg) ``` [![Health](https://phpackages.com/badges/erdmannfreunde-contao-status-update-bundle/health.svg)](https://phpackages.com/packages/erdmannfreunde-contao-status-update-bundle) ``` ### Alternatives [easycorp/easyadmin-bundle Admin generator for Symfony applications 4.3k18.3M430](/packages/easycorp-easyadmin-bundle) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)