schachbulle / contao-showfromto-bundle

1.1.0 2026-09-17 09:37 UTC

Requires

• php: ^7.4 || ^8.0
• contao/core-bundle: ^4.13 || ^5.0

Requires (Dev)

• contao/manager-plugin: ^2.0

Suggests

• contao/news-bundle: Der Hinweis erscheint dann auch in der Liste der Nachrichten.

Conflicts

• contao/core: *
• contao/manager-plugin: <2.0 || >=3.0

LGPL-3.0-or-later

• Frank Hoppe

• backend
• contao
• nachrichten
• inhaltselement
• anzeigen ab
• anzeigen bis
• veröffentlichung
• zeitraum

Published on Packagist.org on 2026-09-17 09:37 UTC

README

Hilfe für Redakteure in Contao: Die Backend-Listen der Inhaltselemente und Nachrichten zeigen in dunkelgelber Schrift, wie es um den Anzeigezeitraum („Anzeigen ab" / „Anzeigen bis") steht. So fällt sofort auf, warum ein veröffentlichtes Element im Frontend nicht erscheint — oder wann es wieder verschwindet.

Zustand	Hinweis
vor „Anzeigen ab", ohne „Anzeigen bis"	(noch nicht sichtbar, erst ab 23.09.2026 00:00)
vor „Anzeigen ab", mit „Anzeigen bis"	(noch nicht sichtbar, erst ab 23.09.2026 00:00 bis 30.09.2026 23:59)
sichtbar, mit „Anzeigen bis"	(sichtbar bis 30.09.2026 23:59)
„Anzeigen bis" ist erreicht	(nicht mehr sichtbar, seit 30.09.2026 23:59)
sichtbar ohne Ende, oder kein Zeitraum gesetzt	kein Hinweis

Datum und Uhrzeit folgen dem Format aus den Contao-Einstellungen (Datum- und Zeitformat).

Wo der Hinweis erscheint

• Inhaltselemente: in der Überschrift des Elements, also in <div class="cte_type published">. Unsichtbar geschaltete Elemente bekommen keinen Hinweis, weil Contao sie ohnehin rot hervorhebt.
• Nachrichten: hinter Überschrift und Datum der Nachricht, in <div class="tl_content_left">. Hier auch bei nicht veröffentlichten Nachrichten, weil die Liste deren Zustand nicht farblich zeigt.

Ob ein Element sichtbar ist, wird genauso entschieden wie im Frontend: sichtbar ist, was start <= jetzt und stop > jetzt erfüllt, mit der aktuellen Zeit auf die volle Minute abgerundet.

Voraussetzungen

• Contao 4.13 oder Contao 5 (geprüft mit 4.13.58 und 5.7.7)
• PHP 7.4 oder neuer (geprüft mit PHP 8.4)
• Für den Hinweis bei Nachrichten: contao/news-bundle

Installation

Über den Contao Manager nach „showfromto" suchen, oder auf der Konsole:

composer require schachbulle/contao-showfromto-bundle

Das Bundle legt keine Datenbankfelder an und hat keine Einstellungen.

Aussehen anpassen

Der Hinweis ist ein span mit der Klasse showfromto und je nach Zustand showfromto--bald, showfromto--sichtbar oder showfromto--abgelaufen. Die Farbe steht in bundles/contaoshowfromto/showfromto.css (hell #8a6a00, im Dunkelmodus von Contao 5 #e0b400) und lässt sich in einem eigenen Backend-Stylesheet überschreiben.

Funktionsweise

Contao 4.13 und Contao 5 bauen die Listen unterschiedlich auf: 4.13 erzeugt die Zeile eines Inhaltselements im child_record_callback (tl_content::addCteType()) als fertiges HTML, Contao 5 im label_callback des ContentElementViewListener als Feld aus Überschrift, Vorschau und Zustand. Nachrichten haben in beiden Fassungen keinen eigenen Rückruf.

Das Bundle legt deshalb im onload_callback von tl_content und tl_news einen Mantel um den jeweils gesetzten Rückruf: Es merkt sich das Original, ruft es beim Aufbau der Liste auf und ergänzt dessen Ergebnis um den Hinweis. So bleibt die Darstellung des Kerns — und die eines anderen Bundles, das hier einen eigenen Rückruf setzt — erhalten.

Prüfstand

tests/pruefstand.php bootet eine Contao-Installation, in der das Bundle eingebunden ist, und prüft Anmeldung, Zeitlogik, beide Listenformen und die echten Kernrückrufe mit einem Inhaltselement aus der Datenbank (der Zeitraum wird nur im Speicher gesetzt):

php tests/pruefstand.php /pfad/zur/contao-installation

Lizenz

LGPL-3.0-or-later