Joomla-Erweiterung nicht kompatibel: Prüfen, ersetzen und Daten retten

Warum blockieren alte Erweiterungen das Update auf Joomla 5 oder 6?

Wenn eine Joomla-Erweiterung beim Wechsel auf Joomla 5 oder 6 als nicht kompatibel gemeldet wird, kann das an einer von drei technischen Hürden liegen: an der PHP-Mindestversion der neuen Joomla-Version, an ihren Datenbank-Anforderungen oder an abgekündigten Programmierschnittstellen im Joomla-Kern. Wer das Update trotzdem anstößt, riskiert Fehlermeldungen und den Ausfall ganzer Seitenbereiche.

Auf einer gewachsenen Website übernehmen Erweiterungen genau die Aufgaben, die der Grundkern eines Content-Management-Systems (CMS) nicht selbst abdeckt, denn sie verwalten Kalender, stellen Formulare bereit oder schützen Dateianhänge. Im Alltag läuft dieser Bestand unauffällig weiter, bis ein Versionssprung ansteht oder der Hoster eine veraltete PHP-Version abschaltet. Dann meldet die Vorabprüfung von Joomla-Update vor dem Versionssprung Warnhinweise zu einzelnen Komponenten, Modulen oder Plugins, die für die Zielversion noch nicht als kompatibel ausgewiesen sind oder ein Update brauchen.

Die Ursache für diese Blockade liegt in den Hauptversionen, denn Joomla folgt laut der offiziellen Entwickler-Roadmap seit 2014 der semantischen Versionierung. Änderungen, die die Abwärtskompatibilität brechen, kommen nur mit einer neuen Hauptversion, und mit ihr kann sich auch das unterliegende Framework ändern. Während Joomla 5 noch auf Version 3 dieses Frameworks aufbaut, nutzt Joomla 6 bereits die nächste Generation. Drittanbieter-Pakete, die noch auf ältere Schnittstellen setzen, können dort deshalb scheitern.

Dazu kommen die technischen Mindestanforderungen an den Webserver und die Datenbank. Joomla 6 setzt laut den technischen Vorgaben im Joomla-Handbuch mindestens PHP 8.3.0 voraus, während die Entwickler PHP 8.4 empfehlen; zudem unterstützt das System MySQL ab Version 8.0.13 sowie MariaDB ab 10.6. Weil ältere PHP-Zweige nach vier Jahren laut der offiziellen PHP-Versionsübersicht aus den Sicherheitsupdates herausfallen, sollten Sie beim Umstellen der PHP-Version beim Hoster direkt auf PHP 8.4 oder 8.5 wechseln und PHP 8.3 nur als Zwischenschritt wählen, falls eine Erweiterung die neuere Version noch nicht verträgt.

PHP 8.3 erschien erst im November 2023, also nach dem regulären Supportende von Joomla 3. Wie Sie Template und Erweiterungen schon beim Umstieg von Joomla 3 vorab in einer Testumgebung prüfen und teils ablösen, zeigt mein Beitrag zum Update von Joomla 3. Im Sommer 2026 habe ich einen Auftritt mit einer Hauptseite und mehreren Regionalseiten, jede mit eigener Domain, von Joomla 3 auf Joomla 6 gebracht. Das offizielle Supportende von Joomla 3 lag zu dem Zeitpunkt knapp drei Jahre zurück.

Woran erkennen Sie vor dem Update, welche Erweiterungen nicht kompatibel sind?

Welche Erweiterungen ein Update bremsen, sehen Sie vorab an drei Stellen: in der Systemübersicht der installierten Komponenten, in der integrierten Vorabprüfung von Joomla-Update auf einer Testkopie und über den Versionsfilter im offiziellen Erweiterungsverzeichnis. Zusätzlich verrät ein Blick in das Webarchiv, wann am System zuletzt gearbeitet wurde.

Verschaffen Sie sich zuerst im Backend einen Überblick über alle Pakete, die nicht vom Joomla-Projekt selbst stammen. Prüfen Sie dabei nicht nur große Komponenten, sondern auch kleine Inhalts- und System-Plugins. Sobald Sie auf einer separaten Arbeitskopie in der Komponente Joomla-Update den Kanal auf die nächste Hauptversion stellen, gleicht die integrierte Vorabprüfung alle installierten Erweiterungen automatisch mit den Update-Servern der Hersteller ab.

Allerdings liefert diese Abfrage kein Ergebnis, wenn der Update-Server einer Erweiterung nicht antwortet, einen Fehler meldet oder der Entwickler dort keine Kompatibilitätsangabe hinterlegt hat. Gleichen Sie wichtige Pakete deshalb zusätzlich im offiziellen Erweiterungsverzeichnis (JED) ab. Dort lässt sich nach Version filtern: Laut der offiziellen Ankündigung zu Joomla 5.2.4 zeigte der Filter beim Wechsel auf Joomla 5, welche Erweiterungen bereit für Joomla 5 waren und welche nur mit aktiviertem Abwärtskompatibilitäts-Plugin.

Wenn bei einem älteren Auftritt jede Dokumentation zur bisherigen Pflege fehlt, hilft schon vor dem ersten Login ein Blick von außen. Das Webarchiv verrät dann, wann auf einer Joomla-3-Seite zuletzt etwas installiert oder aktualisiert wurde: Joomla hängt an seine Skript- und Stylesheet-Adressen eine Kennung, die sich bei jedem Kern-Update sowie beim Installieren oder Deinstallieren einer Erweiterung ändert. An einem Auftritt habe ich das an 21 archivierten Ständen nachvollzogen; dadurch lässt sich eingrenzen, wann zuletzt am Kern oder an den Erweiterungen etwas geändert wurde.

Welche Wege gibt es für Erweiterungen ohne Joomla-6-Unterstützung?

Für jede Erweiterung ohne direkte Unterstützung für Joomla 6 stehen vier Wege offen: Sie spielen eine aktuelle Hersteller-Version ein, überbrücken den Übergang mit dem Abwärtskompatibilitäts-Plugin, übertragen die vorhandenen Daten in eine aktiv gepflegte Nachfolge-Komponente oder bilden die Funktion mit den eigenen Bordmitteln des Joomla-Kerns nach.

Nicht jede Warnung in der Vorabprüfung zwingt Sie dazu, eine vertraute Funktion aufzugeben. Legen Sie jedoch vor dem eigentlichen Kern-Update für jedes Drittanbieter-Paket fest, welchen der vier folgenden Wege Sie auf Ihrer Testkopie einschlagen, denn das beugt späteren Ausfällen auf der Live-Website vor.

Weg 1: Aktualisierung durch den Hersteller einspielen

Wenn der Entwickler seine Komponente weiterpflegt, spielen Sie seine aktuelle Fassung auf der Testkopie ein. Das direkte Update im Backend kann dabei an einer veralteten Zwischenversion oder einem fehlenden Lizenzschlüssel hängen. Für die Formulare und die Dateianhänge gab es bei meinem Migrationsprojekt im Sommer 2026 aktuelle Fassungen der bisherigen Erweiterungen, und beide sind weiter im Einsatz. Auch das vertraute Erscheinungsbild blieb erhalten, denn das bisherige Template läuft auf der neuen Version weiter.

Weg 2: Übergang mit dem Abwärtskompatibilitäts-Plugin überbrücken

Beim Wechsel von Joomla 4 auf 5 überbrückt das Plugin Behaviour - Backward Compatibility für die meisten noch nicht angepassten Joomla-4-Erweiterungen umbenannte oder in Namespaces verschobene Klassen. In Joomla 6 übernimmt Behaviour - Backward Compatibility 6 diese Rolle gegenüber Joomla 5 und stellt bei Bedarf auch entfernte veraltete Klassen bereit. Außerdem bringt Joomla 5.4 gezielt zurückportierte Schnittstellen aus Joomla 6 mit, damit Entwickler den Übergang leichter bewältigen. Nutzen Sie dieses Plugin jedoch nur als Brücke auf Zeit, während der Hersteller an einer nativen Fassung arbeitet – nicht als Dauerlösung für aufgegebene Pakete.

Weg 3: Ablösung durch eine Nachfolge-Erweiterung mit Datenübernahme

Wurde eine wichtige Komponente für Termine, Downloads oder Verzeichnisse endgültig eingestellt, müssen Sie auf eine aktiv gepflegte Erweiterung eines anderen Herstellers wechseln. Die eigentliche Arbeit steckt dabei nicht in der Installation des neuen Pakets, sondern im sauberen Umzug Ihrer gewachsenen Datenbanktabellen. Dafür bleiben die alten Tabellen auf der Testkopie zunächst bestehen, bis alle Einträge übertragen sind.

Weg 4: Rückbau auf Joomla-Bordmittel

Manche Aufgaben einer alten Drittanbieter-Erweiterung lassen sich auch mit Funktionen abdecken, die der Joomla-Kern selbst mitbringt. Sie können strukturierte Inhalte direkt mit Bordmitteln darstellen – über eigene Felder (Custom Fields), Kategorien und angepasste Layout-Ausgaben (Template Overrides) für Komponenten, Module oder Layouts. Jede eingesparte Fremdkomponente ist bei künftigen Updates außerdem eine Abhängigkeit weniger; wie Sie eigenen Programmcode bei Bedarf aufräumen, zeige ich im Ratgeber, wie Sie Legacy-Code in PHP wartbar machen.

Die vier Lösungswege im Überblick

Wie gelingt die Datenübernahme aus eingestellten Erweiterungen in ein neues System?

Wenn der Hersteller einer Erweiterung die Entwicklung eingestellt hat, sind Ihre über Jahre gepflegten Termine, Formulare oder Downloads nicht verloren. Weil Joomla die Inhalte getrennt vom Programmcode in eigenen Datenbanktabellen speichert, lassen sich diese Datensätze auf einer Testkopie auslesen, bereinigen und kontrolliert in eine aktuelle Nachfolge-Erweiterung importieren.

Ein folgenschwerer Fehler kann schon beim gut gemeinten Aufräumen vor dem Update passieren. Wer eine als inkompatibel gemeldete Komponente im Backend kurzerhand deinstalliert, löscht über deren Deinstallationsroutine unter Umständen nicht nur die alten PHP-Dateien, sondern auch die zugehörigen Tabellen in der Datenbank. Dann ist der Datenbestand weg. Deshalb starte ich größere Updates auf einer separaten Arbeitskopie, auf der ich die blockierende Erweiterung samt Begleit-Plugins zunächst nur deaktiviere, damit alle Datensätze unangetastet bleiben.

Wie wichtig diese Trennung zwischen Programmcode und Datenbank ist, zeigt der Veranstaltungskalender aus meinem Migrationsprojekt im Sommer 2026: Die Termin-Erweiterung, mit der die Seite seit Jahren arbeitete, lief unter der neuen Version nicht mehr. Ich habe die Termine in eine aktuelle Kalender-Erweiterung übertragen; jede Regionalseite zeigt wieder ihren eigenen Kalender, die Hauptseite alle Termine zusammen.

1. Arbeitskopie und Datenbank-Backup anlegen

   Richten Sie auf einer Subdomain eine Kopie aus Dateien und Datenbank ein und deaktivieren Sie die inkompatible Erweiterung dort nur, damit alle Tabellen erhalten bleiben.

2. Tabellen der alten Erweiterung identifizieren

   Suchen Sie in der Datenbankverwaltung der Testumgebung die Tabellen der alten Komponente anhand ihres Namenskürzels und prüfen Sie die Spalten für Kategorien, Texte und Zeiten.

3. Nachfolge-Erweiterung auf der Testkopie installieren

   Aktualisieren Sie den Joomla-Kern auf der Arbeitskopie, installieren Sie die mit Joomla 6 kompatible Nachfolge-Erweiterung und legen Sie einen Testeintrag an.

4. Datensätze exportieren, zuordnen und importieren

   Übertragen Sie die vorhandenen Einträge samt Kategorie-Zuordnung per Migrationswerkzeug, CSV-Export oder SQL-Skript in die Tabellen der neuen Erweiterung.

5. Darstellung, Filter und Adressen im Frontend prüfen

   Kontrollieren Sie auf der Testseite Umlaute, Datumsformate, Bilder und Kategorien im Frontend, bevor Sie die Alt-Erweiterung entfernen und Weiterleitungen anlegen.

Wie lassen sich mehrere Domains aus einer Joomla-Installation neu organisieren?

Fällt bei der Migration eine alte Erweiterung weg, die bisher mehrere Domains aus einer einzigen Joomla-Installation bedient hat, müssen Sie die Struktur neu ordnen. Ob getrennte Installationen oder eine zentrale Verwaltung über Menüstrukturen und Kategorien besser passen, hängt davon ab, wer die Inhalte im Alltag pflegt.

Unter Joomla 3 konnte bei Auftritten mit mehreren Domains eine eigene Multisite-Erweiterung die Domains verwalten. Weil Joomla seitdem mit Version 5.0 und 6.0 jeweils auf eine neue Hauptversion seines Frameworks umgestiegen ist, können solche Konstruktionen beim Versionswechsel wegbrechen, auch wenn jede Domain über ihre DNS-Einträge weiter richtig angebunden ist. Arbeiten die Standorte inhaltlich völlig getrennt, sind eigenständige Joomla-Installationen je Domain der klarste Schnitt – allerdings steigt dann der laufende Wartungsaufwand, weil jedes System einzeln aktualisiert werden muss.

Greifen die Inhalte dagegen ineinander, weil eine gemeinsame Redaktion alle Bereiche betreut und Termine gebündelt ausspielt, bleibt ein zentrales System im Vorteil. Auch die Erweiterung, die alle Domains aus einer Installation bediente, lief bei der Migration im Sommer 2026 unter der neuen Version nicht mehr, also habe ich die Struktur neu aufgebaut: Jede Regionalseite hat weiter ihre eigene Domain, ihre eigene Startseite und ihr eigenes Menü, und gepflegt wird alles in einem Backend. Für die laufende Joomla-Wartung ist danach weiterhin nur ein einziges System aktuell zu halten.

Wie schützen 301-Weiterleitungen und Backups Ihre bestehenden Adressen und Inhalte?

Sobald Sie beim Versionswechsel eine Komponente durch eine andere ersetzen, können sich die Seitenadressen für Termine, Kataloge oder Downloads ändern. Damit bestehende Lesezeichen und Links aus Suchergebnissen weiter ans Ziel führen, sichern Sie die Seite vorab vollständig und richten für jede geänderte Adresse eine direkte 301-Weiterleitung auf das neue Ziel ein.

Wenn ich eine länger nicht gewartete Website übernehme und den Zugang wiederherstelle, prüfe ich als Erstes, ob das eingesetzte System überhaupt noch Sicherheitsupdates erhält – denn daran entscheidet sich, ob ein Weiterbetrieb möglich ist oder eine Migration ansteht. Joomla 4 bekam laut der Ankündigung des Joomla-Projekts zu Joomla 5.2.4 nur bis zum 14. Oktober 2025 Sicherheitsupdates. Für Joomla 5 läuft der Sicherheits-Support laut der offiziellen Joomla-Roadmap noch bis Oktober 2027, Joomla 6 wird bis Oktober 2029 versorgt.

Bevor Sie diese Migration starten, sichern Sie sämtliche Dateien per FTP sowie die komplette Datenbank.

„Spielen Sie kein Update ohne frisches Backup ein – und probieren Sie aus, ob es sich zurückspielen lässt.“

— Sascha Fix

Ein Backup, das nur ungeprüft als Archiv auf dem Server liegt, hilft im Ernstfall nicht weiter. Spielen Sie die Sicherung deshalb gleich zu Beginn auf Ihrer Testumgebung ein; so prüfen Sie das Archiv und erhalten zugleich Ihre Arbeitskopie.

Tauschen Sie auf dieser Arbeitskopie eine Erweiterung gegen einen Nachfolger aus, kann sich durch die neue Komponente auch die URL der Unterseiten ändern. Damit weder Besucher noch Suchmaschinen auf Fehlerseiten landen, braucht jede geänderte Adresse einen direkten 301-Redirect auf ihr neues Gegenstück. Vermeiden Sie dabei mehrstufige Ketten über mehrere Zwischenziele, sondern leiten Sie in einem einzigen Schritt direkt auf die endgültige HTTPS-Adresse weiter.

Bei meiner Stichprobenprüfung des migrierten Auftritts im November 2026 leiten alte Adressen mit Statuscode 301 weiter: Beiträge auf ihre neue Adresse bei gleicher Beitragsnummer und gleichem Erstellungsdatum, frühere Terminseiten auf den Kalender und die geprüfte Regionaldomain von HTTP auf HTTPS. Wie Sie solche Regeln sauber anlegen, zeige ich im Ratgeber zur .htaccess-Weiterleitung, in der Hilfe gegen Redirect-Schleifen nach einem Umzug und im Beitrag zur Chrome-Warnung bei HTTP-Seiten.

Inkompatible Erweiterungen selbst austauschen oder Hilfe holen?

Ob Sie inkompatible Erweiterungen selbst ablösen oder die Migration abgeben, hängt von der Zahl der Drittanbieter-Komponenten und den gespeicherten Daten ab. Einen überschaubaren Auftritt mit verfügbaren Hersteller-Updates können Sie auf einer Testkopie selbst aktualisieren; bei eingestellten Komponenten mit gewachsenen Datenbanktabellen spart fachkundige Unterstützung riskante Umwege.

Bleibt eine Seite auf Joomla 3 oder 4 stehen, werden bekannte Sicherheitslücken – sogenannte CVE-Einträge – dort nicht mehr durch kostenlose Kern-Updates geschlossen. Eine klare Abgrenzung hilft Ihnen bei der Entscheidung, was Sie auf einer Testkopie selbst erledigen können und wann Unterstützung sinnvoll ist.

Wenn Sie den Wechsel nicht selbst auf Datenbank-Ebene durchführen möchten, übernehme ich das in meiner Joomla-Migration. Vorab prüfe ich Ihre Erweiterungsliste kostenlos und nenne Ihnen einen verbindlichen Festpreis, bevor Arbeiten beginnen. Das Update von Joomla 5 auf 6 inklusive Erweiterungsprüfung kostet ab 690 € zzgl. 19 % USt., die Migration von Joomla 3 oder 4 auf 6 samt Ablösung alter Komponenten, Datenübernahme und 301-Weiterleitungen ab 1.490 € zzgl. 19 % USt.

Ist Ihre Seite beim eigenen Update-Versuch bereits ausgefallen, hilft meine Website-Reparatur; bei einem kompromittierten Altsystem finden Sie Unterstützung auf meiner Seite zur Joomla-Hack-Hilfe sowie im Leitfaden, wie Sie eine Website nach einem Hack wiederherstellen. Damit nach dem Umstieg kein neuer Wartungsstau entsteht, betreue ich Ihre Seite auf Wunsch in meiner Joomla-Wartung im Tarif Basis für 39 € im Monat zzgl. 19 % USt.; alle weiteren Angebote zeigt die Übersicht zur Joomla-Entwicklung.