Typische Stolperfallen bei TYPO3 und wie du sie vermeidest
Artikel vorlesen lassen
In 20 Jahren TYPO3-Arbeit habe ich dieselben Fehler immer wieder gesehen. Fünf davon tauchen in fast jedem Projekt auf, das ich als Trainer oder Berater zu Gesicht bekomme. Keiner davon ist kompliziert zu vermeiden, wenn man sie einmal erkannt hat.
Konfiguration ohne Konzept
Die häufigste Stolperfalle sehe ich bei der Site Configuration. Einstellungen werden verstreut: ein Teil im TypoScript-Setup, ein Teil in der Site Configuration, ein Teil direkt im Backend. Bei Multi-Site-Projekten wird das schnell unübersichtlich.
Das Problem entsteht meistens am Anfang. Jemand richtet das Projekt ein, trifft Entscheidungen unter Zeitdruck, und sechs Monate später versteht niemand mehr, warum bestimmte Einstellungen an bestimmten Stellen liegen.
Was hilft:
- Lege vor Projektstart fest, wo welche Konfiguration hinkommt. Site Configuration für alles, was zur Site gehört. TypoScript für Rendering-Logik. Keine Mischformen.
- Dokumentiere Entscheidungen, die nicht offensichtlich sind. Nicht alles, sondern das, was in drei Monaten Fragen aufwirft.
- Nutze sprechende Bezeichnungen. Ein Site-Identifier wie "main" sagt nichts. "kundenname-de" sagt alles.
Rechte nach dem Gießkannenprinzip
Du kennst die Situation: Der Kunde soll "alles selbst machen können". Also bekommt der Redakteur Admin-Rechte oder zumindest viel zu weitreichende Berechtigungen. Kurzfristig spart das Rückfragen. Langfristig rufst du irgendwann an einem Freitagabend den Kunden zurück, weil "die Seite kaputt ist".
In fast jedem Schulungsprojekt, das ich begleite, finde ich Redakteure mit Zugriff auf TypoScript-Templates, Zugriff auf Ordner, die sie nicht brauchen, oder die Möglichkeit, Seitentypen zu ändern.
Was hilft:
- Erstelle ein Rechtekonzept vor dem Projektstart. Welche Rollen gibt es? Was darf jede Rolle? Das dauert eine halbe Stunde und spart Tage.
- Schränke per PageTSconfig ein, welche Felder und Optionen Redakteure sehen. TYPO3 bietet dafür umfangreiche Möglichkeiten, die zu wenige nutzen.
- Teste die Rechte aus der Perspektive des Redakteurs. Logge dich mit dem Redakteurs-Account ein und prüfe, ob alles Sinn ergibt.
Seitenbaum ohne Struktur
Ein Seitenbaum, der am Anfang übersichtlich war, wird nach zwei Jahren Redaktionsarbeit zum Labyrinth. Seiten auf der falschen Ebene, doppelte Inhalte, Ordner ohne erkennbare Logik.
Das passiert, wenn es keine klaren Regeln gibt. Redakteure machen dann das, was ihnen logisch erscheint, und das ist bei zehn Redakteuren zehnmal unterschiedlich.
Was hilft:
- Nutze Ordner (SysFolder) konsequent für alles, was nicht direkt im Frontend erscheint: Datensätze, Formulare, wiederverwendbare Inhaltselemente.
- Definiere eine Benennungskonvention und halte sie schriftlich fest. Klingt banal, macht aber den Unterschied zwischen einem wartbaren und einem chaotischen Projekt.
- Denke vom Redakteur aus, nicht vom Entwickler. Der Seitenbaum ist das tägliche Werkzeug der Redaktion, nicht deins.
Updates aufschieben
Die Angst vor Updates ist verständlich. Wer einmal ein Projekt nach einem missglückten Update reparieren musste, schiebt das nächste gern auf. Aber je länger du wartest, desto größer wird der Sprung und desto höher das Risiko.
Besonders kritisch: Sicherheitsupdates. TYPO3 hat ein verlässliches Security-Team, das regelmäßig Patches veröffentlicht. Diese nicht einzuspielen, ist fahrlässig.
Was hilft:
- Arbeite mit Composer. Composer-basierte Projekte lassen sich deutlich sauberer aktualisieren als klassische Installationen.
- Richte eine lokale Entwicklungsumgebung ein (z.B. mit DDEV). Jedes Update zuerst lokal testen, dann auf Staging, dann live.
- Plane einen festen Rhythmus. Einmal im Monat Minor-Updates prüfen, Sicherheitsupdates sofort. Das kostet pro Projekt vielleicht eine Stunde und verhindert die große Panik.
Alles allein herausfinden wollen
Der letzte Punkt ist kein technischer, sondern ein menschlicher. Viele TYPO3-Entwickler arbeiten isoliert. Wenn ein Problem auftaucht, wird stundenlang gegoogelt, in der Dokumentation gesucht oder im Code herumexperimentiert.
Dabei gibt es eine aktive Community, die genau für solche Fragen da ist. Auf t3forum.net findest du Antworten auf die meisten Praxisfragen. Auf TYPO3camps, den DevDays oder der T3CON triffst du Leute, die dieselben Probleme lösen wie du. Und oft reicht ein kurzer Austausch, um eine Lösung zu finden, für die du allein Stunden gebraucht hättest.
Ich bin seit 16 Jahren in der TYPO3-Community aktiv und kann sagen: Die Bereitschaft, sich gegenseitig zu helfen, ist in kaum einer anderen Open-Source-Community so ausgeprägt.
ZurückDu hast eine Frage oder willst das Thema diskutieren?
Im Community Hub für TYPO3 kannst du dich mit anderen TYPO3 Anwendern austauschen. Und wenn du keine neuen Artikel verpassen willst: Der TYPO3 Newsletter kommt einmal im Monat, ohne Spam.
Hi, ich bin Wolfgang.
Seit 2006 arbeite ich mit TYPO3. Nicht in der Theorie, sondern in echten Projekten mit echten Deadlines. Die Probleme, die du gerade hast, hatte ich wahrscheinlich schon dreimal.
Irgendwann habe ich angefangen, mein Wissen in Videokurse zu packen. Nicht weil ich gerne vor der Kamera stehe, sondern weil ich dieselben Fragen immer wieder gehört habe. Mittlerweile sind es Hunderte Videos geworden. Jedes Einzelne entstand aus einer konkreten Frage aus einem konkreten Projekt.
Was mich von einem YouTube-Tutorial unterscheidet: Ich kenne nicht nur die Lösung, sondern auch den Kontext. Warum etwas so funktioniert. Wann es nicht funktioniert. Und welche Fehler du dir sparen kannst, weil ich sie schon gemacht habe.
Meine Teilnehmer nutzen mich als Sparringspartner. Nicht im Sinne von "ruf mich jederzeit an", sondern so: Du kommst mit einem konkreten Problem in die Live-Session, postest deine Frage in der Community oder schaust dir das passende Video an. Und bekommst eine Antwort, die funktioniert, weil sie aus der Praxis kommt.
Als Mitglied im TYPO3 Education & Certification Committee sorge ich dafür, dass die Zertifizierungsprüfungen auf dem aktuellen Stand bleiben. Was dort geprüft wird, fließt direkt in meine Kurse ein.