TYPO3 Upgrades - Ein Überblick

Die Komplexität eines TYPO3-Upgrades hängt von der Anzahl der Major-Versions-Schritte ab. Ein Upgrade von TYPO3 Version 12.4 auf TYPO3 Version 13.4 ist beispielsweise weniger aufwendig als ein Upgrade von TYPO3 Version 8.7 auf TYPO3 Version 13.4. Je mehr Versionen übersprungen werden, desto umfangreicher werden die erforderlichen Anpassungen an Extensions, Templates und individuellen Funktionen.

Welche TYPO3-Version Ihr Projekt aktuell nutzt, können Sie leicht im Backend einsehen. Die Versionsnummer finden Sie links oben unterhalb des Namens Ihrer Installation.

Im Rahmen das Upgrade-Checks prüfen wir auch die Installationsmethode. Ist Ihre Website als Composer-Installation oder klassische Installation mit Symlinks umgesetzt? Diese Information beeinflusst die Herangehensweise.

Welche Methode bei Ihrer Installation genutzt wird, können Sie einfach im Backend-Modul "Erweiterungen" überprüfen.

Für die Anzeige des Moduls "Erweiterungen" sind die Berechtigungen für einen Administrator bzw. System-Maintainer erforderlich.

Eine blaue Info-Box mit der Aufschrift "Composer-Modus" oberhalb der Erweiterungsliste zeigt an, dass es sich um eine Composer-Installation handelt. Andernfalls wurde die klassische Installationsmethode mit Symlinks verwendet.

Die Templating-Methode und die Content-Rendering-Methode Ihrer TYPO3-Website haben einen großen Einfluss auf den Upgrade-Prozess. Aktuell sind Fluid und Fluid Styled Content die Standards. Wenn Ihre Website jedoch noch auf der veralteten Content-Rendering-Methode CSS Styled Content basiert, müssen die Inhaltselemente während des Upgrades auf Fluid Styled Content migriert werden. Dabei ist der Aufwand gering, sofern keine Anpassungen an den Standard-Elementen vorgenommen wurden. Andernfalls sind Änderungen an den individuellen Templates notwendig.

Da Fluid Styled Content andere CSS-Klassen verwendet, als CSS Styled Content, müssen wir in diesem Fall das Frontend-CSS anpassen, um sicherzustellen, dass die Darstellung konsistent bleibt.

Zusätzlich wurden einige Features von CSS Styled Content nicht in Fluid Styled Content übernommen. Beispielsweise existieren die "Bildeffekte" nicht mehr, und bestimmte Datenbank-Felder wurden umbenannt, wie "section_frame" zu "frame_class". Solche Änderungen müssen berücksichtigt werden, insbesondere wenn Anpassungen mit TSConfig vorgenommen wurden.

Verwenden Sie noch Subparts oder Marker in Ihren Templates, müssen diese auf Fluid-Templates umgestellt werden. Ähnliches gilt, wenn Sie alte Extensions wie templavoila, rlmp_tmplselector oder automaketemplate nutzen. Diese Erweiterungen sind nicht mehr kompatibel und müssen ersetzt werden.

So überprüfen Sie die Templating-Methode

Loggen Sie sich mit einem Admin-Zugang in das TYPO3-Backend ein und wechseln Sie zum Modul "Template" (ab TYPO3 v12 "TypoScript"). Wählen Sie im Seitenbaum die Rootseite (erkennbar am Globus-Symbol) aus und öffnen Sie im oberen Dropdown-Menü den "TypoScript Object Browser" (ab TYPO3 v12 "Active TypoScript"). Suchen Sie im Abschnitt "Setup Root" nach dem Objekt "Page". Ist dort ein "FLUIDTEMPLATE" definiert, handelt es sich um Fluid. Finden Sie hingegen Einträge wie "workOnSubpart = DOCUMENT" oder Eigenschaften wie "marks" oder "subparts", wird noch mit Markern gearbeitet.

Die Content-Rendering-Methode können Sie im Modul "Template" unter "Info/Modify" einsehen. Klicken Sie dort auf "Edit the whole template record" und prüfen Sie unter dem Reiter "Includes", welche statischen Templates eingebunden sind. Ein Eintrag "Fluid Content Elements" bedeutet, dass Fluid Styled Content genutzt wird. Bei "CSS Styled Content" handelt es sich um die veraltete Methode.

Im Modul "Erweiterungen" können Sie außerdem überprüfen, ob alte Templating-Extensions wie templavoila, rlmp_tmplselector oder automaketemplate installiert sind. Diese sollten im Rahmen des Upgrades ersetzt werden.

Wenn Sie zusätzliches TypoScript oder TsConfig auf Ihrer Website einsetzen, können nach einem Upgrade Kompatibilitätsprobleme auftreten. Dies kann beispielsweise daran liegen, dass sich die Syntax von Bedingungen geändert hat oder bestimmte Objekte nicht mehr unterstützt werden. Um die Funktionalität Ihrer Website sicherzustellen, sind in solchen Fällen Anpassungen notwendig.

Besonders ältere TypoScript-Konfigurationen, die auf veralteten Standards basieren, sollten vorab geprüft werden.

Für das Bodytext-Feld von Inhaltselementen wird in TYPO3 in der Regel entweder HTMLArea oder CKEditor verwendet. Ab TYPO3 Version 9 ist HTMLArea jedoch nicht mehr verfügbar und muss durch CKEditor ersetzt werden. Dieser Wechsel ist oft unkompliziert, kann jedoch bei stark angepassten Konfigurationen von HTMLArea aufwendiger sein.

So finden Sie den verwendeten Text-Editor heraus:

Loggen Sie sich mit einem Admin-Zugang im TYPO3-Backend ein und wechseln Sie zum Modul "Erweiterungen". In der dortigen Liste sehen Sie, ob HTMLArea oder CKEditor installiert ist. Dies gibt Ihnen Klarheit darüber, ob bei einem Upgrade eine Umstellung erforderlich ist.

Der Aufwand für ein TYPO3-Upgrade hängt wesentlich von den installierten Extensions ab. Während der TYPO3-Core in der Regel reibungslos aktualisiert werden kann, wird das Upgrade aufwendiger, je mehr Extensions genutzt werden.

Herausforderungen mit Extensions

1. Nicht verfügbare Extensions: Manche Extensions sind für die Zielversion nicht verfügbar und müssen ersetzt werden. Dies kann eine Neuauswahl und Konfiguration neuer Extensions erforderlich machen oder, falls möglich, den Verzicht auf die betroffene Funktionalität bedeuten.

2. Individuell entwickelte Extensions: Für selbst entwickelte Extensions, die nicht im TYPO3 Extension Repository (TER) verfügbar sind, ist eine Anpassung oder ein vollständiges Upgrade notwendig. Dies erfordert entweder die Unterstützung des ursprünglichen Entwicklers oder eine separate Beauftragung.

So überprüfen Sie Ihre Extensions

Loggen Sie sich mit einem Admin-Zugang in das TYPO3-Backend ein und wechseln Sie zum Modul "Erweiterungen". Dort finden Sie eine Liste aller installierten Extensions. Filtern Sie nach "Lokale Extensions" ("Local"), um alle Third-Party-Extensions anzuzeigen, die zusätzlich aus dem TYPO3 Extension Repository installiert oder speziell für Ihre Installation entwickelt wurden. Die Verfügbarkeit im TYPO3 Extension Repository (TER) können Sie auf https://extensions.typo3.org prüfen. Suchen Sie dort nach dem jeweiligen Extension-Key, der in der Spalte "Key" angegeben ist. Falls eine Extension nicht gelistet ist, handelt es sich um eine individuell entwickelte Extension.

Um ein sauberes und zukunftssicheres Upgrade Ihrer TYPO3-Website zu gewährleisten, sollten alle Template-Dateien idealerweise in einem Site Package organisiert sein, ähnlich wie Extensions. In älteren Installationen befinden sich diese Dateien jedoch häufig im fileadmin-Verzeichnis.

Herausforderungen bei älteren Ablageorten

Wenn Ihre Templates im fileadmin-Verzeichnis liegen, sind mehrere Schritte erforderlich:

1. Erstellung eines Site Packages: Alle Template-Dateien müssen in ein neues Site Package übertragen werden.

2. Dateien umstrukturieren: Unterverzeichnisse müssen organisiert und bestehende Dateipfade in der Konfiguration angepasst werden.

3. Anpassungen vornehmen: Gegebenenfalls müssen zusätzliche Dateien erstellt und bestehende Dateiendungen angepasst werden.

So überprüfen Sie den Ablageort Ihrer Template-Dateien:

Loggen Sie sich als Administrator in das TYPO3-Backend ein und wechseln Sie zum Modul "Template". Wählen Sie dort oben in der Select-Box den "TypoScript Object Browser" aus. Geben Sie im Suchfeld den Begriff fileadmin ein. Im Suchergebnis werden alle Verweise auf das fileadmin-Verzeichnis angezeigt. Sollten TypoScript- oder HTML-Dateien unter diesen Pfaden liegen, ist ein neues Site Package erforderlich.

Auch wenn Ihre Website bereits Fluid als Templating-Methode verwendet, können nach einem Upgrade Anpassungen erforderlich sein. Manche von Extensions bereitgestellte ViewHelper oder deren Argumente sind in neueren TYPO3-Versionen nicht mehr verfügbar und müssen durch alternative Lösungen ersetzt werden.

Herausforderungen bei Fluid-Templates

1. Veraltete ViewHelper: Wir prüfen, ob die verwendeten ViewHelper noch kompatibel sind. Falls nicht, müssen alternative Lösungen gefunden werden.
2. Template-Logik anpassen: Änderungen in neueren TYPO3-Versionen können dazu führen, dass die bestehende Logik innerhalb von Templates angepasst werden muss. Dies betrifft häufig geänderte Argumente von ViewHelpern oder neue Anforderungen an die Struktur von Fluid-Templates.

So prüfen Sie Ihre Fluid-Templates

Melden Sie sich im Backend als Administrator an und navigieren Sie zu Ihren Template-Dateien (sofern diese im fileadmin-Verzeichnis liegen), oder nutzen Sie einen SFTP- oder SSH-Zugang, wenn die Template-Dateien in einem Site Package im Verzeichnis typo3conf/ext/ liegen, um die Fluid-Templates gezielt auf Inkompatibilitäten zu prüfen.

Ein Upgrade Ihrer TYPO3-Website bietet die Gelegenheit, Ihre Seite an aktuelle Standards in den Bereichen Barrierefreiheit, Suchmaschinenoptimierung (SEO) und Datenschutz anzupassen. Diese Features integrieren wir im Rahmen eines Upgrades für Sie standardmäßig:

1. XML-Sitemaps: Eine aktuelle und vollständige Sitemap erleichtert Suchmaschinen das Crawlen Ihrer Website und verbessert die Indexierung.

2. Erweiterte SEO-Felder: Modernere TYPO3-Versionen bieten verbesserte Möglichkeiten zur Optimierung Ihrer Metadaten, wie Titel, Beschreibungen und Open-Graph-Tags, um die Sichtbarkeit der Webseite zu erhöhen.

3. Cookie-Consent-Manager: Falls sich entsprechende Inhalte auf Ihrer Website befinden, ist für die Einhaltung der DSGVO ein Opt-in-Mechanismus zur Einwilligung in die Datennutzung unverzichtbar. Wir integrieren moderne Cookie-Consent-Tools für Sie.

Zusätzlicher Aufwand

Diese Anpassungen sind mit technischem Aufwand verbunden, da Konfigurationen vorgenommen, bestehende Inhalte angepasst und neue Funktionen implementiert werden müssen. Es lohnt sich jedoch, diese Arbeiten direkt im Zuge eines Upgrades durchzuführen, um Ihre Website zukunftssicher und wettbewerbsfähig zu halten.