TYPO3 4.0 unterscheidet sich in einigen Punkten deutlich von den
Vorgängerversionen. Neben vielen kleinen Änderungen am Sourcecode
wurden in der neuen Version folgende Modifikationen vorgenommen:

• Die globalen Extensions wurden abgeschafft.
• Das Extension-Repository wurde weiterentwickelt (TER2).
• Der htmlArea-RTE ist eine Systemextension.
• „css_styled_imgtext“ ist mit in „css_styled_content“ eingeflossen.

Bei der Verbindung aus alten TYPO3-Dateien und -Datenbanken mit
neuen TYPO3-Sources ist etwas Fingerspitzengefühl beim Migrieren
gefragt. Der folgende Artikel soll einen Überblick über die häufigsten
Fehlerquellen und die jeweiligen Lösungsstrategien verschaffen.

Das neue Extension-Repository sollte zu Beginn konfiguriert werden.
Dazu wird im Modul Extension-Manager aus der Auswahlbox der Punkt
„Settings“ gewählt. Durch Aktivieren der Funktion „Enable unsupported
extensions“ werden auch Extensions angezeigt, die nicht vom TYPO3-Team
auf Sicherheit und Stabilität überprüft wurden. Um Extensions zu
importieren wird im TER2-Auswahldialog der Punkt „Import“ gewählt. Beim
Klick auf den Button „Retrieve/Update“ wird die aktuelle Liste der
Extensions vom ausgewählten Mirror geladen. Vor der Suche nach einer
neuen Extension sollte immer ein Datenabgleich auf diesem Wege
durchgeführt werden, da sonst die Liste der erhältlichen Extensions
nicht aktualisiert wird. Treten Probleme beim Datenabgleich mit dem
TER2 auf, ist es ratsam, die Speicherzuteilung für PHP zu überprüfen.
Die PHP-Variable „memory_limit“ sollte auf ca. 50 MB gesetzt sein.

Allgemeines zu Versionskonflikten

Bei vielen Extensions wird man momentan mit Meldungen dieser Art konfrontiert: „The running TYPO3 version (4.0) is lower than required (4.0.0)“. Um die Extension trotzdem zu installieren, genügt ein Häkchen bei „Ignore this version requirement“. Manche Extensions bringen einen Konfigurationsbildschirm mit. Wenn dieser erscheint, alle Einstellungen auf den Standardwerten lassen und auf „Update“ klicken. Bei veränderten Einstellungen wird die Extension nicht installiert.

Wenn kein Rich-Text-Editor funktioniert, kann der htmlArea-RTE
installiert werden, indem zunächst alle Rich-Text-Editoren
deinstalliert werden. Danach werden die Editor-Extensions am besten
komplett entfernt, indem im Extension-Manager der Bereich „Install
extensions“ betreten wird. Dort wird die betroffene Extension
ausgewählt. Im folgenden Schirm wird in der Auswahlbox oben rechts der
Punkt „Backup/Delete“ aktiviert. Durch einen Klick auf den (nicht
unterstrichenen) Link „DELETE EXTENSION FROM SERVER (in the "Local"
location "typo3conf/ext/xxxxxx")!“ kann die Extension entfernt werden.

Da der htmlArea-RTE (1.3.7) in TYPO3 4.0 eine Systemextension ist, kann
dieser wie gewohnt installiert werden. Die neueren htmlArea-RTE
Versionen (z. B. 1.4.1) müssen wie üblich als lokale Extensions
installiert werden.

Allgemeines zu MySQL-Fehlern

Wenn beim Aufruf von TYPO3-Seiten (Frontend oder Backend) MySQL-Fehler auftreten, sollte im TYPO3-Installtool unter „Database Analyser“ die Funktion „COMPARE“ gestartet werden. Wenn eine Liste mit Unterschieden angezeigt wird und die Einträge in der Checkbox davor ein Häkchen haben, werden die Änderungen durch Klick auf den Button „Write to database“ bestätigt. Anschließend den Link „IMPORT“ wählen und auf der folgenden Seite die Option „Import the whole file ‚CURRENT_STATIC‘ directly“ aktivieren. Dieser Ablauf empfiehlt sich als Standard-Vorgehensweise, um triviale Datenbank-Unterschiede als Fehlerursache auszuschließen.

Dieses Phänomen wird durch Parameter in der Datei extTables.php
ausgelöst, die ebenfalls die Darstellung im Backend steuern. Das Script
wird in der „typo3conf/localconf.php“ eingebunden.

Entweder wird der Befehl „include(‚extTables.php‘)“ entfernt oder
die Datei wird entsprechend abgeändert. Aber Vorsicht, die Datei kann
auch andere Befehle/Parameter enthalten.

Vorgehen bei Fehlern mit Extensions

Wenn zum Beispiel eine Fehlermeldung wie „TYPO3 Fatal Error: Extension key „xxxxx“ was NOT loaded!“ ausgegeben wird, deutet dies an, dass eine Extension nicht geladen werden konnte. So etwas kann passieren, wenn die Extension vor dem Update global installiert war, nicht kopiert wurde und jetzt noch in der „typo3conf/localconf.php“ als zu ladende Extension vermerkt ist. In diesem Fall hilft das Entfernen des Extension-Keys in der „typo3conf/localconf.php“ aus der Zeile „$TYPO3_CONF_VARS[‚EXT‘][‚extList‘]“. Wenn der Login im Backend noch möglich ist, kann alternativ die Extension einfach mit dem Extension-Manager installiert werden. Nach Modifikationen der Datei „typo3conf/localconf.php“ sollten immer die Dateien, die mit „temp_CACHED_“ beginnen, gelöscht werden.

Die Extensions für die Lokalisierung des TYPO3-Backends (z. B.
„csh_de“), die bisher die deutsche Übersetzung für das TYPO3- Backend
geliefert haben, sind veraltet. Um die Lokalisierung beispielsweise für
die deutsche Sprache zu aktivieren, wird im Extension-Manager der Punkt
„Translation handling“ gewählt. Dort die gewünschte Sprache in der
Liste markieren und mit Klick auf „Save selection“ bestätigen. Nun kann
mit dem Button „Check status against repository“ abgefragt werden, für
welche TYPO3-Bestandteile eine neue Übersetzung vorliegt. Mit dem
Button „Update from repository“ werden die neuen Übersetzungen
installiert.

Update Wizard

Wenn ein Update auf 4.0 durchgeführt wurde, erscheint beim Login in das Backend eine gelbe Warnmeldung. TYPO3 4.0 verhält sich an einigen Stellen deutlich anders als die Vorgänger, daher wird bei einem Update zunächst der Kompatibilitätsmodus aktiviert. Dieser kann abgestellt werden, indem im Installtool der Punkt „Update Wizard“ ausgewählt wird. Im folgenden Dialog werden die Unterschiede erläutert. Um kompromisslos alle neuen Konventionen zu übernehmen, einfach ein Häkchen bei „ignore selection above“ machen und den Button „3-Perform Updates“ drücken. In einigen Fällen ist es ratsam, den Kompatibilitätsmodus aktiviert zu lassen. Dies betrifft zum Beispiel die Generierung von RealURL-URLs. Im 3.8-Kompatibilitätsmodus werden Unterstriche als Trennzeichen verwendet, im nativen 4.0-Modus Bindestriche. Gerade bei diesem Unterschied sollte gründlich überlegt werden. Durch die Änderung könnte das Google-Ranking beeinflusst werden, weil alte URLs zu den Webseiten nicht mehr gültig sind. Auch das „Content-Rendering“ mit „css_styled_content“ ist von Umstrukturierungen betroffen. So werden das Mailformular und das Inhaltselement „Text mit Bild“ anders als bei den pre-4.0- Versionen formatiert. Die Meldung „The Reference Index table is empty[…]“ bezieht sich auf die neue Tabelle für Referenzen innerhalb von TYPO3. Um die Tabelle mit Daten zu füllen, wird im Backend der Punkt „Tools->DB-Check (DB Überprüfung)“ aufgerufen. In der folgenden Auswahlbox kann unter „Manage Reference Index“ mit dem Button „Update now!“ die Tabelle aktualisiert werden.

Dieses Phänomen kann von der DBAL-Extension verursacht werden. Um
wieder Änderungen vornehmen zu können, sollten die Extensions „dbal“
und „adodb“ deaktiviert werden. Dazu wird die Datei
„typo3conf/localconf.php“ editiert und die Keys „adodb“ und „dbal“ aus
der Variable „$TYPO3_CONF_VARS[‚EXT‘][‚extList‘]“ entfernt.