schachbulle/contao-kongresse-bundle

Kongresse und Hauptausschüsse für Contao 4.13 und Contao 5

2.1.1 2026-08-24 09:24 UTC

Requires

• php: ^8.1
• contao/core-bundle: ^4.13 || ^5.0
• menatwork/contao-multicolumnwizard-bundle: ^3.6
• symfony/config: ^5.4 || ^6.4 || ^7.0
• symfony/dependency-injection: ^5.4 || ^6.4 || ^7.0
• symfony/http-kernel: ^5.4 || ^6.4 || ^7.0

Requires (Dev)

• contao/manager-plugin: ^2.0
• phpunit/phpunit: ^9.6

Conflicts

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

LGPL-3.0-or-later

• Frank Binding

• contao
• veranstaltungen
• schach
• kongress
• hauptausschuss

Published on Packagist.org on 2026-08-24 09:25 UTC

README

Contao-Erweiterung zur Verwaltung und Ausgabe von Kongressen, Hauptausschüssen und Kommissionstagungen.

Frank Hoppe

Anforderungen

• PHP 8.1 oder neuer
• Contao 4.13 LTS oder Contao 5

Installation

composer require schachbulle/contao-kongresse-bundle

Anschließend im Contao-Manager bzw. über contao:migrate die Datenbank aktualisieren.

Hinweis zum Update auf 2.0.0

Seit 2.0.0 gibt das Frontend-Modul nur noch veröffentlichte Veranstaltungen aus. Damit beim Update nichts verschwindet, setzt eine mitgelieferte Migration alle vorhandenen Datensätze einmalig auf veröffentlicht. Sie läuft automatisch beim ersten contao:migrate und danach nicht wieder – später zurückgezogene Veranstaltungen bleiben also zurückgezogen.

Backend

Unter Inhalte → Kongresse & Ausschüsse werden die Veranstaltungen gepflegt. Je Veranstaltung lassen sich Art, Jahr, Ort, Zeitraum, eine Bemerkung sowie Kongressbuch, Protokoll, eine Veranstaltungsseite und beliebig viele Zusatzlinks hinterlegen. Über das Auge-Symbol in der Liste wird ein Datensatz veröffentlicht oder zurückgezogen.

Frontend-Modul

Das Modul Kongresse & Ausschüsse gibt die Datensätze als Tabelle aus. In den Moduleinstellungen lässt sich der Jahresbereich eingrenzen; über Veranstaltungen wählen kann zusätzlich auf einzelne Arten eingeschränkt werden. Ohne Angaben werden alle veröffentlichten Veranstaltungen ausgegeben, absteigend nach Jahr und Anfangsdatum.

Frontend-Modul „Kongressprotokolle"

Das Modul Kongressprotokolle gibt, ähnlich dem Kern-Inhaltselement Downloads, eine einfache Liste der Protokolle der letzten zehn Jahre aus (das laufende Jahr und die neun davor). Veranstaltungen ohne Protokoll oder ohne Veröffentlichung erscheinen nicht; weder Jahresbereich noch Veranstaltungsart sind einstellbar – dafür eignet sich das Modul Kongresse & Ausschüsse.

Der Titel setzt sich aus Jahr und Ort zusammen, etwa „Protokoll 2025 – Hofgeismar". Ist kein Ort gepflegt (leer oder ein Bindestrich als Platzhalter für eine Online-Veranstaltung), erscheint stattdessen „online". Protokolle von Hauptausschüssen erhalten den Zusatz „(Hauptausschuss)".

Das Template setzt außerdem die CSS-Klasse download-element zusammen mit ext-⟨Endung⟩, denselben Klassen wie beim Kern-Inhaltselement Downloads – Themes, die dessen Icon-Darstellung bereits stylen, greifen damit ohne weiteres Zutun auch hier.

Das Template mod_kongressprotokolle.html5 erhält das Array $this->records mit einem Eintrag je Protokoll:

Feld	Inhalt
href	Link zur Datei, bereits maskiert
title	„Protokoll ⟨Jahr⟩ – ⟨Ort oder „online"⟩⟨" (Hauptausschuss)" falls zutreffend⟩", bereits maskiert
filesize	Lesbare Dateigröße, etwa 1,2 MB
extension	Dateiendung in Kleinbuchstaben, etwa pdf

Verfügbare Templatevariablen (Kongresse & Ausschüsse)

Das Template mod_kongresse.html5 erhält das Array $this->records mit einem Eintrag je Veranstaltung und folgenden Feldern:

Feld	Inhalt
jahr	Jahr der Tagung, bei hinterlegter Veranstaltungsseite als Link (enthält HTML)
typ	Kurzform der Art: oK = Ordentlicher Kongress, aK = Außerordentlicher Kongress, Ha = Hauptausschuss, Ko = Kommissionstagung
typTitle	Ausgeschriebene Bezeichnung zu typ
ort	Ort der Tagung, bei hinterlegter Veranstaltungsseite als Link (enthält HTML)
datum	Datum bzw. Zeitraum, zusammengefasst (etwa 30.03. - 02.04.2020)
info	Bemerkung zur Tagung, Rohwert
online	true, wenn die Veranstaltung als Online-Veranstaltung gekennzeichnet ist
broschuere	Fertiger Link zum Kongressbuch, leer wenn keine Datei hinterlegt ist (enthält HTML)
protokoll	Fertiger Link zum Protokoll, leer wenn keine Datei hinterlegt ist (enthält HTML)
links	Die Zusatzlinks, durch senkrechte Striche getrennt (enthält HTML)

Die als enthält HTML gekennzeichneten Felder sind bereits maskiert und dürfen im Template ohne weitere Behandlung ausgegeben werden. typ, typTitle und info sind Rohwerte und werden im mitgelieferten Template mit Contao\StringUtil::specialchars() maskiert.

CSS-Klassen im Standardtemplate

Jede Tabellenzeile erhält odd bzw. even, dazu typ_oK, typ_aK, typ_Ha oder typ_Ko und bei Online-Veranstaltungen zusätzlich online. Die Spalten tragen die Klassen jahr, typ, ort, datum, info, buch, protokoll und links.

Sprachen

Die Erweiterung bringt deutsche und englische Sprachdateien mit. In einer Installation mit einer anderen Sprache greifen die englischen Beschriftungen.