Records List Examples: sechs fertige Ansichten als Ergänzung zu Records List Types (TYPO3 v14)

Mit Records List Types lässt sich das Records-Modul von TYPO3 v14 um eigene Ansichtstypen erweitern – ganz ohne PHP. Die naheliegende Frage lautet: Wie sieht so ein eigener Ansichtstyp in der Praxis aus? Genau darauf antwortet Records List Examples.

Diese Begleit-Extension liefert sechs sofort einsetzbare Ansichten als Vorlage und Werkzeug zugleich: installieren und nutzen – oder als Blaupause für eigene Typen verwenden.

Inhaltsverzeichnis  

Überblick  

Records List Examples ist die direkte Ergänzung zu Records List Types: Die Basis-Extension stellt den Mechanismus für eigene Ansichtstypen bereit, die Beispiele liefern fertige Ansichten dafür. Sie erscheinen nach der Installation im Ansichts-Umschalter des Records-Moduls von TYPO3 v14.

Bemerkenswert ist, wie wenig dafür nötig ist: Vier der sechs Ansichten nutzen die mitgelieferten Built-in-Templates (Grid, Compact, Teaser) mit anderer Konfiguration. Nur Timeline und Catalog bringen eigene Fluid-Templates und CSS mit – inklusive Dark-Mode. Das zeigt den Kerngedanken: Viele Ansichtstypen brauchen lediglich TSconfig und optionale Assets.

Funktionen im Detail  

Die sechs Ansichten decken typische redaktionelle Szenarien ab – von der chronologischen Darstellung bis zum bildlastigen Katalog.

Wichtig für die Wartbarkeit: Die beiden eigenen Templates (Timeline, Catalog) folgen exakt der Template-Systematik der Basis-Extension – gemeinsame Partials, dieselbe Sanitize-Logik für TYPO3-Backend-Fragmente, das native <typo3-backend-contextual-record-edit-trigger>-Element und berechtigungsabhängiges Rendern der Aktionen. So bleiben sie auch funktionsfähig, wenn sich Records List Types weiterentwickelt.

Konsequenterweise bringt die Extension kein eigenes JavaScript mit: Interaktives Verhalten – Aktionen, Sichtbarkeits-Toggles, Pagination, Mehrfachauswahl – stammt aus der Basis-Extension und dem TYPO3-Core. Die Templates nutzen die dokumentierten data-gridview-action-Attribute und Fluid-ViewHelper. Alle Labels sind über XLIFF 2.0 (Englisch und Deutsch) übersetzbar.

Installation  

Da Composer Repository-Definitionen nicht aus Abhängigkeiten erbt, werden beide VCS-Repositories in der Projekt-composer.json eingetragen. Die Basis-Extension wird dabei automatisch mitinstalliert.

composer config repositories.records-list-types vcs https://github.com/dirnbauer/typo3-records-list-types.git
composer config repositories.records-list-examples vcs https://github.com/dirnbauer/typo3-records-list-examples.git
composer require webconsulting/records-list-examples:^1.0

Nach dem Setup erscheinen die sechs neuen Ansichtstypen im Umschalter unter Content → Records.

Anpassung  

Standardmäßig sind alle sechs Ansichten überall verfügbar. Über Page-TSconfig lassen sie sich gezielt pro Seitenbaum einschränken – etwa nur Timeline auf der Events-Seite.

# Nur Timeline auf der Events-Seite
[page["uid"] == 42]
  mod.web_list.viewMode.allowed = list,timeline
  mod.web_list.viewMode.default = timeline
[end]

# Nur Catalog im Shop-Seitenbaum
[page["uid"] == 100 || page["pid"] == 100]
  mod.web_list.viewMode.allowed = list,catalog
  mod.web_list.viewMode.default = catalog
[end]

Häufige Fragen  

Fazit  

Records List Examples ist beides: ein praktischer Werkzeugkasten mit sechs fertigen Ansichten und ein Lehrstück dafür, wie wenig Aufwand ein eigener Ansichtstyp im Records-Modul tatsächlich bedeutet. Wer Records List Types einsetzt, bekommt hier den schnellsten Einstieg – und eine saubere Vorlage für individuelle Anforderungen.

Die technischen Grundlagen – Records-Modul, eigene Ansichtstypen und die Zero-PHP-Erweiterbarkeit – beschreiben wir ausführlich im Artikel zu Records List Types.