Sie können das Datensatzmodul in TYPO3 v14 erweitern. Dafür nutzen Sie die Erweiterung Records List Types. Sie brauchen dafür kein PHP. Wie sieht so eine eigene Ansicht in der Praxis aus? Die Erweiterung Records List Examples zeigt Ihnen die Antwort.
Diese zusätzliche Erweiterung liefert Ihnen sechs fertige Ansichten. Sie können diese Ansichten sofort installieren und nutzen. Oder Sie nutzen die Ansichten als Vorlage für eigene Ideen.
Inhaltsverzeichnis
Überblick
So arbeitet die Erweiterung mit Records List Types zusammen.
Die sechs Ansichten
Hier lernen Sie die sechs verschiedenen Ansichten kennen.
Installation
So installieren Sie die beiden Erweiterungen in Ihrem System.
Anpassung
So begrenzen Sie die Ansichten für bestimmte Seiten.
Überblick
Die Erweiterung Records List Examples ergänzt die Erweiterung Records List Types. Records List Types ist das Basisprogramm. Dieses Basisprogramm bereitet den Weg für neue Ansichten vor. Records List Examples liefert dann die fertigen Ansichten. Nach der Installation sehen Sie die neuen Ansichten in Ihrem TYPO3-Backend. Sie finden die Ansichten im Menü für die Datensätze.
Die Erstellung der Ansichten ist sehr einfach. Vier Ansichten nutzen bereits eingebaute Vorlagen. Diese Vorlagen heißen Grid, Compact und Teaser. Sie brauchen dafür nur eine andere Einstellung. Nur zwei Ansichten nutzen eigene Vorlagen und CSS-Dateien. Diese Ansichten heißen Timeline und Catalog. Diese beiden Ansichten bieten auch einen Dunkelmodus an. Das zeigt einen großen Vorteil von dieser Erweiterung. Viele Ansichten brauchen nur eine einfache TSconfig-Einstellung. Manchmal brauchen Sie noch zusätzliche Gestaltungsdateien.
Diese Erweiterung funktioniert nur mit TYPO3 v14. Sie brauchen mindestens die Version TYPO3 v14.3 LTS. Sie brauchen auch die Erweiterung Records List Types ab Version 1.0. Ihr Server muss PHP in den Versionen 8.3 bis 8.5 nutzen. Diese Version funktioniert nicht mit dem älteren TYPO3 v13.
Funktionen im Detail
Die sechs Ansichten helfen Ihnen bei Ihrer täglichen Arbeit. Sie können damit zeitliche Abläufe oder einen Katalog mit Bildern zeigen.
| Ansicht | Basis | Beschreibung |
|---|---|---|
| Timeline | Eigene Vorlage | Eine zeitliche Liste von oben nach unten mit Datum und Karten. |
| Catalog | Eigene Vorlage | Große Karten für Bilder mit einem Zoom-Effekt. |
| Address Book | CompactView | Enge Kontaktliste mit festen Spalten für 500 Kontakte. |
| Event List | TeaserView | Karten für Veranstaltungen mit einem kleinen Kalender. Sie zeigt 30 Veranstaltungen. |
| Gallery | GridView | Eine Bildergalerie mit großen Vorschaubildern und sehr wenig Text. |
| Dashboard | GridView | Sie bestimmen die Spalten selbst über ein Auswahlmenü. |
Sie können die Ansichten einfach pflegen.
Die Vorlagen für Timeline und Catalog nutzen dieselbe Technik.
Sie nutzen gemeinsame Vorlagenteile.
Die Vorlagen bereinigen den Programmcode im TYPO3-Backend automatisch.
Sie nutzen das standardmäßige HTML-Element <typo3-backend-contextual-record-edit-trigger>.
Das System zeigt Aktionen nur mit den passenden Rechten an.
So funktionieren die Ansichten auch nach einem Update der Basiserweiterung.
Die Erweiterung bringt kein eigenes JavaScript mit. Alle Funktionen stammen aus der Basiserweiterung und aus dem TYPO3-System selbst. Dazu gehören das Auswählen von Elementen oder das Umschalten der Sichtbarkeit. Die Vorlagen nutzen dafür feste HTML-Eigenschaften und Werkzeuge aus Fluid. Sie können alle Texte über Sprachdateien übersetzen. Das System nutzt dafür das Format XLIFF 2.0. Dieses Format funktioniert für Deutsch und Englisch.
Installation
Sie müssen beide Paketquellen in Ihrer Datei composer.json eintragen.
Der Paketmanager Composer lädt die Quellverzeichnisse sonst nicht automatisch herunter.
Das System installiert die Basiserweiterung dann ganz automatisch mit.
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.0Nach der Einrichtung finden Sie die sechs neuen Ansichten im Backend. Gehen Sie dafür auf den Menüpunkt Inhalt → Datensätze.
Anpassung
Normalerweise können Sie alle sechs Ansichten auf jeder Seite nutzen. Sie können die Ansichten aber für bestimmte Seiten einschränken. Dafür nutzen Sie die Einstellungen in Page-TSconfig. Sie können zum Beispiel die Timeline nur für Ihre Terminseite erlauben.
# Nur Timeline auf der Terminseite
[page["uid"] == 42]
mod.web_list.viewMode.allowed = list,timeline
mod.web_list.viewMode.default = timeline
[end]
# Nur Catalog im Shopbereich
[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 hilft Ihnen auf zwei Arten. Sie bekommen einen Werkzeugkasten mit sechs fertigen Ansichten. Zusätzlich lernen Sie viel über die Technik von TYPO3. Sie sehen, wie einfach Sie eigene Ansichten erstellen können. Nutzen Sie bereits Records List Types? Dann bekommen Sie mit dieser Erweiterung den schnellsten Start. Sie erhalten eine saubere Vorlage für Ihre eigenen Wünsche.
Wir beschreiben alle technischen Grundlagen in einem anderen Artikel. Lesen Sie dazu unseren Artikel über Records List Types.
Die Erweiterung nutzt das Datensatzmodul und Fluid von TYPO3 v14. Wir danken dem TYPO3-Core-Team und der Gemeinschaft sehr herzlich. Die Erweiterung ist freie Software unter der Lizenz GPL-2.0.