Club List for TYPO3

Kommunen und Dachverbände brauchen eine strukturierte Vereinsdatenbank statt statischer Listen

Wer auf einer Gemeinde-Website oder dem Portal eines Landessportbundes nach dem lokalen Schachclub sucht, erwartet eine Filtermaske und keine 15-seitige PDF-Liste. Genau dieses Problem löst hwvereinsliste: Die Extension bildet Vereine als TYPO3-Records ab und macht sie über Kategorie-Filter, Volltextsuche und Detailansichten zugänglich. Für kommunale Webauftritte, Dachverbände und Kreissportbünde ist das Plugin seit Jahren ein bewährtes Werkzeug, das Redaktionen die Pflege ohne Entwickler-Eingriffe erlaubt.

Die Realität in deutschen Kommunen sieht allerdings so aus, dass Vereinsregister oft noch als Word-Dokumente in Amtsleitungen kursieren. hwvereinsliste ersetzt diesen Workflow durch eine zentrale Datenbank im TYPO3-Backend, die über Frontend-Plugins ausgesteuert wird. Bürger finden ihren Verein in Sekunden, Redakteure aktualisieren Kontaktdaten ohne FTP-Zugang.

Typical use cases range from Gemeindeportalen bis zu Sportkreis-Datenbanken

Das häufigste Szenario ist die klassische Vereinsliste auf einer kommunalen Website. Eine Gemeinde mit 80 bis 120 eingetragenen Vereinen pflegt alle Einträge zentral im TYPO3-Backend. Bürger filtern im Frontend nach Kategorien wie Sport, Kultur, Soziales oder Jugend. Die Detailansicht zeigt Ansprechpartner, Trainingszeiten und Kontaktdaten. Die Redaktion der Gemeinde-Website aktualisiert Einträge selbstständig, ohne technische Hilfe.

Das zweite Szenario betrifft Dachverbände und Kreissportbünde. Ein Landessportbund verwaltet oft 500 bis 2.000 Mitgliedsvereine in dutzenden Sportarten. Hier wird die Filterfunktion zum Kernfeature: Nutzer kombinieren Sportart, Ort und Altersgruppe, um den passenden Verein in der Nachbarschaft zu finden. hwvereinsliste unterstützt diese Mehrfach-Filterung nativ.

Ein drittes Szenario sind Verzeichnisportale im Ehrenamts-Bereich. Freiwilligenagenturen nutzen die Extension, um Organisationen zu listen, die ehrenamtliche Unterstützung suchen. Die Kategorisierung läuft über TYPO3-Sys-Categories, was Überschneidungen mit anderen Content-Elementen auf der gleichen Seite erlaubt. In manchen Fällen wird die Extension auch als Branchenverzeichnis für lokale Wirtschaftsförderung eingesetzt, wobei Unternehmen statt Vereine gelistet werden.

Technical architecture is based on Extbase-Records und Fluid-Templates

hwvereinsliste nutzt das Extbase/Fluid-Framework von TYPO3. Vereine werden als eigene Domain-Records in einer dedizierten Tabelle gespeichert. Jeder Record enthält Felder für Name, Beschreibung, Adresse, Kontaktdaten, Website-URL, Logo und Kategorien. Die Kategorisierung verwendet TYPO3-Sys-Categories, was die Integration mit anderen Extensions vereinfacht.

Im Frontend stehen zwei Plugins zur Verfügung: eine Listenansicht mit Filter- und Suchfunktion sowie eine Detailansicht für einzelne Vereine. Die Templates sind Fluid-basiert und lassen sich über TypoScript-Pfade oder ein Site-Package überschreiben. Wer das Layout anpassen will, kopiert die Fluid-Templates ins eigene Package und passt HTML-Struktur und CSS-Klassen an, ohne die Extension selbst zu verändern.

Die Filterung arbeitet standardmässig clientseitig bei kleinen Datenmengen und serverseitig bei grösseren Beständen. Für Installationen mit mehr als 500 Vereinen empfiehlt sich die Kombination mit einer Suchindex-Lösung wie ke_search, um die Performance der Volltextsuche zu verbessern.

Ein Aspekt, der bei kommunalen Projekten oft vergessen wird: die Barrierefreiheit. Seit dem Barrierefreiheitsstärkungsgesetz (BFSG) müssen öffentliche Stellen ihre Webauftritte barrierefrei gestalten. Das betrifft auch die Vereinsliste: Filter-Elemente müssen per Tastatur bedienbar sein, Ergebnislisten brauchen ARIA-Labels, und die Suchfunktion muss Screenreader-kompatibel arbeiten. Die Standard-Templates der Extension erfüllen diese Anforderungen nicht vollständig und müssen angepasst werden.

Common problems involve Import, Kategorisierung und responsive Darstellung

Das häufigste Problem bei der Ersteinrichtung ist der Datenimport. Kommunen haben ihre Vereinsdaten typischerweise in Excel-Listen mit inkonsistenten Formaten. Spaltennamen variieren, Kategorien sind als Freitext statt als standardisierte Taxonomie gepflegt, und Kontaktdaten enthalten veraltete Einträge. Gosign löst das über einen KI-gestützten Import-Workflow: Die Excel-Datei wird automatisch analysiert, Spalten werden gemappt, Kategorien normalisiert und Duplikate erkannt. Was früher einen halben Tag manuelle Nacharbeit kostete, läuft so in unter einer Stunde.

Das zweite Problem betrifft die Kategoriestruktur. Wenn Kategorien im Vorfeld nicht sauber definiert werden, entstehen Redundanzen wie “Fussball”, “Fußball-Verein” und “Fussballclub” als drei separate Einträge. Wir empfehlen, vor dem Go-Live eine Kategorie-Taxonomie mit maximal 15 bis 20 Oberkategorien festzulegen und diese im TYPO3-Backend als Sys-Categories anzulegen.

Drittes Problem: Die responsive Darstellung der Listenansicht. Auf Mobilgeräten wird die Tabellen-Darstellung schnell unübersichtlich. Die Fluid-Templates sollten für mobile Viewports eine Karten-Darstellung statt einer Tabelle rendern, was über eine einfache Template-Anpassung im Site-Package realisierbar ist. Gosign liefert responsive Templates für Vereinslisten standardmässig mit, die auf Smartphones als Card-Grid und auf Desktops als Tabelle dargestellt werden.

Migration auf v12 requires Extbase-Anpassungen, v13 ist noch nicht offiziell unterstützt

hwvereinsliste wurde primär für TYPO3 v9 und v10 entwickelt. Für TYPO3 v12 ist eine Anpassung der Extbase-Persistenz nötig, da sich die Query-Schnittstelle geändert hat. Konkret betrifft das die Repository-Klassen und die TypoScript-basierte Persistenz-Konfiguration, die seit v12 über Classes.php gelöst wird. Die Template-Pfade müssen ebenfalls auf die neue SiteSet-Struktur umgestellt werden.

Für TYPO3 v13 gibt es aktuell keine offizielle Unterstützung durch den Extension-Autor. Wer auf v13 migriert, muss die Extension entweder selbst anpassen oder eine alternative Lösung evaluieren. Gosign prüft in solchen Fällen, ob eine Migration der Extension oder ein Neubau auf Basis von Extbase mit aktueller API wirtschaftlicher ist. Bei kleinen Vereinsdatenbanken mit unter 200 Einträgen ist ein Custom-Plugin oft die bessere Wahl, weil es exakt auf die Anforderungen der Kommune zugeschnitten ist und keine Legacy-Abhängigkeiten mitbringt.