TYPO3 Upgrades - Ein Überblick

Je mehr Major-Versions-Schritte das Upgrade beinhaltet, um so aufwendiger wird es. Ein Upgrade von TYPO3 Version 11.5 nach TYPO3 Version 12.4 ist zum Beispiel weniger aufwendig, als ein Upgrade von TYPO3 Version 8.7 nach TYPO3 Version 12.4.

Welche Version Ihr TYPO3 Projekt hat, sehen Sie im Backend links oben unterhalb vom Namen Ihrer Installation.

Ist Ihre TYPO3 Site eine Composer- oder eine klassische Installation mit Sym-Links? Je nach Installationsmethode ist der Upgrade-Vorgang sehr unterschiedlich.

Mit welcher Methode Ihre Website installiert wurde, sehen Sie, wenn Sie zum Backend-Modul "Erweiterungen" wechseln. Wird dort oberhalb der Auflistung eine blaue Info-Box mit dem Text "Composer-Modus" angezeigt, dann handelt es sich um eine Composer-Installation.

Die aktuell gängige Templating Methode ist Fluid und die Content Rendering Methode ist Fluid Styled Content. Wenn Ihre Website noch die veraltete Content Rendering Methode CSS Styled Content verwendet, müssen die Inhaltselemente während des Upgrades nach Fluid Styled Content migriert werden. Sofern an der Ausgabe der Inhaltselemente nichts verändert wurde und hier nur TYPO3-Standards verwendet werden, ist diese Migration auch recht simpel. Andernfalls müssen eventuell Anpassungen an den Templates der Inhaltselemente vorgenommen werden.

Da Fluid Styled Content andere CSS-Klassen verwendet als CSS Styled Content, muss ggf. das CSS des Frontends angepasst werden.

Außerdem werden einige Optionen aus CSS Styled Content nicht mehr unterstützt. Zum Beispiel gibt es die "Bildeffekte" nicht mehr. Auch die Bezeichnung einiger Datenbank-Felder hat sich geändert. So wurde aus dem Datenbank-Feld "section_frame" -> "frame_class". Das muss berücksichtigt werden, wenn Sie zum Beispiel per TSConfig Anpassungen vorgenommen haben.

Verwenden Sie Subparts und/oder Marker in Ihren Templates, müssen diese in Fluid-Templates umgebaut werden. Das gleiche gilt auch, wenn Sie eine veraltete Extension wie zum Beispiel templavoila, rlmp_tmplselector oder automaketemplate für das Templating einsetzen.

So finden Sie die Templating-Methode heraus:

Die Templating-Methode erkennen Sie, indem Sie sich mit einem Admin-Zugang ins Backend einloggen, zum Backend-Modul "Template" (ab TYPO3 v12 "TypoScript") wechseln und im Seitenbaum die Rootseite mit dem Globus-Symbol auswählen. Dann wählen Sie oben in der Select-Box "TypoScript Object Browser" (ab TYPO3 v12 "Active TypoScript") aus und suchen unten im Abschnitt "Setup Root" nach dem Objekt "Page". Befindet sich dort (meist an Position 10) ein Objekt "FLUIDTEMPLATE", dann handelt es sich bei der Templating-Methode um Fluid. Finden Sie stattdessen die Zeile "workOnSubpart = DOCUMENT" und die Eigenschaften "marks" oder "subparts", dann werden in Ihren Templates noch Marker verwendet.

Die Content Rendering Methode finden Sie heraus, wenn Sie oben in der Selektbox nun "Info/Modify" auswählen und dann auf die Schaltfläche "Edit the whole template record" klicken. Wenn Sie dann den Reiter "Includes" auswählen, sehen Sie im Feld "Include static (from extensions)", welche statischen Templates von Extensions auf Ihrer Site eingebunden sind. Befindet sich dort der Eintrag "Fluid Content Elements", ist die Content Rendering Methode Fluid. Ist stattdessen CSS Styled Content dort zu finden, ist die veraltete Content Rendering Methode im Einsatz.

Ob auf Ihrer Website Extensions wie zum Beispiel templavoila, rlmp_tmplselector oder automaketemplate fürs Templating eingesetzt werden, sehen Sie, indem Sie auf das Backend-Modul "Erweiterungen" wechseln. Dort sind alle installierten Extensions aufgelistet.

Wenn Sie zusätzliches TypoScript oder TsConfig auf Ihrer Website einsetzen, kann es sein, dass Teile davon nach dem Upgrade nicht mehr funktionieren, zum Beispiel weil sich die Syntax von Conditions geändert hat oder bestimmte Objekte nicht mehr existieren. Hier muss dann im Zuge des Upgrades nachgearbeitet werden.

In den meisten Fällen wird für das Bodytext-Feld von Inhaltselementen entweder HTMLArea oder CKEditor verwendet, die beide als Extension integriert werden. Allerdings steht HTMLArea ab TYPO3 Version 9 nicht mehr zur Verfügung, weshalb die Extension bei einem Upgrade ausgetauscht werden muss. Das kann unkompliziert sein, kann aber auch je nach Konfiguration, die für HTMLArea vorgenommen wurde, sehr aufwändig werden.

So finden Sie den Text-Editor heraus:

Loggen Sie sich mit einem Admin-Zugang ins Backend Ihrer TYPO3 Site ein und wechseln Sie auf das Backend-Modul "Erweiterungen". Je nach eingesetztem Editor finden Sie in der Liste der Extensions entweder HTMLArea oder CKEditor.

Während das Upgrade des TYPO3 Cores relativ einfach funktioniert, steigt der potentielle Aufwand mit jeder zusätzlichen Extension, die eingesetzt wird. Die Gründe dafür sind:

• Eine Extension ist in der Zielversion (noch) nicht verfügbar und muss daher durch eine andere Extension ersetzt werden. Das kann zu einem erheblichen Mehraufwand führen. Die Alternative wäre, auf die betreffende Extension in Zukunft zu verzichten, wenn das möglich ist.
• Es werden individuell entwickelte Extensions eingesetzt, die nicht im TYPO3 Extension Repository verfügbar sind. Hier empfehlen wir dringend, den Urheber mit dem Upgrade dieser Extension zu beauftragen. Falls das nicht möglich ist, muss das Upgrade der Extension separat beauftragt werden und wir berechnen die Überarbeitung nach Zeitaufwand.

So stellen Sie fest, welche Extensions auf Ihrer Site installiert sind und ob diese im TYPO3 Extension Repository in der Zielversion zur Verfügung stehen:

• Loggen Sie sich mit einem Admin-Zugang im Backend Ihrer TYPO3 Site ein und wechseln Sie auf das Backend-Modul "Erweiterungen". Dort sehen Sie eine Liste aller installierten Extensions. Für das Upgrade relevant sind die lokalen Extensions. Klicken Sie entweder auf die Schaltfläche "Local" rechts oben, oder auf den Titel der Spalte "Type", um die Extensions nach dem Typ "Local" zu sortieren.
• Nun rufen Sie unter der URL https://extensions.typo3.org/ das TYPO3 Extension Repository auf und durchsuchen es jeweils nach dem Extension-Key jeder lokalen Extension. Sie finden den Extension-Key in der Spalte "Key" Ihrer installierten Extensions. Im Suchergebnis sehen Sie, für welche Versionen von TYPO3 die Extension zur Verfügung steht. Wenn Sie kein Suchergebnis erhalten, handelt es sich um eine individuelle Extension.

Idealerweise wird das Template, also grob gesagt das Design der Site, über ein Site Package installiert, so wie es auch mit Extensions üblich ist. Gerade in älteren Installationen befinden sich diese Dateien aber oft noch im fileadmin-Verzeichnis. Wenn das der Fall ist, muss ein Site-Package erstellt, alle Dateien dorthin verschoben, Unterverzeichnisse umstrukturiert und Dateipfade angepasst werden. Bestimmte zusätzliche Dateien müssen erzeugt und bestehende Dateiendungen umbenannt werden.

So finden Sie heraus, wo Ihre Template-Dateien liegen:

Wenn Sie sich als Administrator ins Backend Ihrer Website einloggen, auf das Backend-Modul "Template" wechseln, dann oben in der Select-Box "TypoScript Object Browser" sowie in der Select-Box "Browse" "setup" auswählen und dann über das Suchfeld nach dem Begriff "fileadmin" suchen, sehen Sie im Suchergebnis gegebenenfalls verschiedene Pfade, die auf das Fileadmin-Verzeichnis zeigen. Wenn dort Unterverzeichnisse dabei sind, die TypoScript- oder HTML-Dateien enthalten, dann muss für Ihre Website bei einem Upgrade wahrscheinlich ein neues Site-Package erstellt werden.

Auch wenn Ihre Website schon die aktuelle Templating-Methode Fluid im Einsatz hat, kann es sein, dass die Dateien nach einem Upgrade überarbeitet werden müssen. Manche von Extensions zur Verfügung gestellten ViewHelper oder deren Argumente sind zum Beispiel in der aktuellen Version nicht mehr verfügbar und müssen dann durch andere ersetzt werden.

Ein Ziel des Upgrades ist es, dass Ihre Website den aktuellen Standards der Suchmaschinen-Optimierung und der DSGVO entspricht. Aus diesem Grund erweitern wir Ihre Website (falls nötig/noch nicht vorhanden) um eine XML-Sitemap, zusätzliche SEO-Felder und Opt-in-Mechanismen wie Cookie-Consent Manager. Auch das ist mit zusätzlichem Aufwand verbunden.