Search by

derkosmonaut / tourtimes-contao

derkosmonaut

Regelmäßige Termine wie Führungen für Contao: Standard- und Saisonpläne, Ausnahmen, spontane Absagen, Tagesliste für Infomonitore

Package info

github.com/derkosmonaut/tourtimes_contao

Type:contao-bundle

pkg:composer/derkosmonaut/tourtimes-contao

Statistics

Installs: 7

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

v0.1.1 2026-11-20 15:08 UTC

This package is auto-updated.

Last update: 2026-11-20 15:09:34 UTC


README

Logo

tourtimes_contao

*** Release Candidate: im Einsatz getestet, aber noch nicht als stabil gekennzeichnet ***

Regelmäßig wiederkehrende Termine wie Führungen für Contao (Bundle für Contao 5.7 oder neuer, PHP 8.5). Schwester-Erweiterung von opentimes_contao, gleiche Logik für Pläne, Saisons und Ausnahmen, aber für einzelne Termine statt Öffnungsfenster.

Funktionsumfang

  • Beliebig viele Angebote (z. B. Führungen) mit Beschreibung, Bild, Treffpunkt, Dauer, Preis, Sprache und Ticketlink
  • Zeitraum je Angebot: „Termine ab“, „Termine bis“ und „Endet nach X Terminen“, z. B. eine Sommerführung an fünf Montagen; danach verschwindet das Angebot von selbst aus der Liste
  • Standard- und Saisonpläne je Angebot (Zeitraum, jährlich wiederholbar, Priorität)
  • Zeitslots je Plan, z. B. „Mo, Di, Mi 10:00–11:00“, optional mit festem Hinweis („auf Englisch“)
  • Ausnahmen für Tage oder Zeiträume, für das ganze Angebot oder einzelne Slots: Ausfall, andere Uhrzeit, Hinweis (z. B. „Treffpunkt verlegt“) und Zusatztermin
  • Spontane Absagen mit Hinweistext, für das ganze Angebot oder einzelne Slots, bis auf Weiteres oder mit Ende
  • Drei Frontend-Module:
    • Angebotsliste: alle Angebote mit regelmäßigen Zeiten und den nächsten Terminen
    • Termine heute: die heutigen Termine chronologisch; ein Termin verschwindet, sobald er beginnt, mit einstellbarem Versatz entsprechend früher (z. B. 10 Minuten für den Infomonitor an der Kasse)
    • Detailansicht: ein Angebot mit allen Angaben und den nächsten Terminen
  • Feiertage: je Angebot ein Bundesland wählen, an gesetzlichen Feiertagen entfallen die regulären Termine
  • Vorschau im Backend beim Angebot: die nächsten Termine mit Zustand und Hinweisen auf Unstimmigkeiten
  • Sitemap: Detailseiten der Angebote erscheinen in der Contao-Sitemap
  • Strukturierte Daten: angezeigte Termine als schema.org-Events (JSON-LD), abgesagte als abgesagt
  • Twig-Templates, Grundstil mit CSS-Variablen, deutsche und englische Texte

Auflösungsreihenfolge

Die speziellere Ebene schlägt die allgemeinere:

  1. Zeitraum des Angebots (außerhalb gibt es keine Termine)
  2. Spontane Absage (schlägt alles, auch Zusatztermine)
  3. Ausnahme (Verschiebung oder Hinweis bestätigen einen Termin auch am Feiertag; Ausfall schlägt Verschiebung, Hinweise werden gesammelt, Zusatztermine kommen hinzu)
  4. Feiertag (keine regulären Termine, sofern beim Angebot ein Bundesland gewählt ist)
  5. Saisonplan (ersetzt den Standardplan vollständig, höhere Priorität gewinnt)
  6. Standardplan

Anwendung

1. Angebot anlegen. Unter „Inhalte → Führungen“ ein Angebot mit Titel, Texten und Details anlegen. Die Dauer gilt für alle Termine ohne eigenes Ende. Unter „Zeitraum“ lässt sich das Angebot begrenzen: „Termine ab“ und „Termine bis“ und/oder „Endet nach X Terminen“ (gezählt ab „Termine ab“; jeder Termin zählt, auch abgesagte und Zusatztermine).

In der Liste führen die Symbole rechts zu den Plänen, Ausnahmen und spontanen Absagen des Angebots.

Angebotsliste im Backend mit den Symbolen für Pläne, Ausnahmen und Absagen

2. Pläne und Zeitslots. Über das Symbol „Pläne“ einen Standardplan anlegen, optional Saisonpläne (z. B. „Sommer“ vom 1.4. bis 31.10., jährlich). Je Plan Zeitslots anlegen: Wochentage anhaken (mit Schnellauswahl), Beginn und optional Ende.

Symbol „Standard- und Saisonpläne“

3. Ausnahmen. Für geplante Abweichungen an bestimmten Tagen. Art wählen:

Art Wirkung Betrifft
Fällt aus Termine fallen aus ganzes Angebot oder ausgewählte Slots
Andere Uhrzeit Termin findet zu neuer Uhrzeit statt, ohne Ende bleibt die Länge erhalten ausgewählte Slots
Findet statt, mit Hinweis Hinweis am Termin ganzes Angebot oder ausgewählte Slots
Zusatztermin zusätzlicher Termin zur angegebenen Uhrzeit –

Symbol „Ausnahmen“

4. Spontane Absage. Unter „Spontane Absagen“ Hinweistext und Beginn eintragen, das Ende ist optional. Alle Termine, die im Zeitraum beginnen, fallen aus. Zum Aufheben „Aktiv“ abwählen oder löschen.

Symbol „Spontane Absagen“

5. Ausgabe. Frontend-Modul anlegen und einbinden:

  • Angebotsliste: Angebote auswählen (ohne Auswahl alle), Anzahl nächster Termine, Weiterleitungsseite zur Detailansicht. Optional ein Lesermodul: Ist ein Angebot aufgerufen, zeigt die Liste stattdessen die Detailansicht (Liste und Detail auf einer Seite)
  • Termine heute: Angebote, Versatz in Minuten, abgesagte Termine anzeigen oder ausblenden, Text ohne Termine. Mit „Nächsten Tag anzeigen“ erscheinen nach dem Hinweis die Termine des nächsten Tages mit Terminen (z. B. „Morgen“)
  • Detailansicht: auf der Weiterleitungsseite einbinden; das Angebot kommt über den Alias in der URL. „Anzahl nächster Termine“ = 0 blendet die Terminliste auf der Detailseite aus

Einstellungen des Moduls „Angebot-Detailansicht“

Für die Sitemap zählen die Weiterleitungsseiten der Module „Angebotsliste“ und „Termine heute“. Liegen Liste und Detail auf einer Seite (Lesermodul), trage diese Seite auch als Weiterleitungsseite ein.

Abgesagte Termine erscheinen durchgestrichen mit „Fällt aus“ und Grund, wenn „Abgesagte Termine anzeigen“ aktiv ist.

Infomonitor

Die Tagesliste blendet vergangene Termine auch ohne Neuladen aus (kleines Skript, prüft alle 15 Sekunden) und lädt die Seite kurz nach Mitternacht neu. Der Seiten-Cache läuft bis zur nächsten Änderung ab (30 Sekunden bis eine Stunde), Änderungen im Backend leeren ihn sofort.

Installation

composer require derkosmonaut/tourtimes-contao

Oder im Contao Manager nach „tourtimes“ suchen. Danach die Datenbank aktualisieren.

Branding im Contao Manager

Titel, Beschreibung und Logo für die Paketliste des Contao Managers liegen vorbereitet unter docs/package-metadata/ (Pull Request an contao/package-metadata).

Entwicklung

composer install --no-plugins --ignore-platform-reqs
vendor/bin/phpunit
vendor/bin/phpstan analyse

Der Resolver (src/Resolver/) ist reines PHP ohne Contao und vollständig mit Tests abgedeckt.

Lizenz

GPL-3.0-or-later