Manuel Killert
Ratgeber · Contao · Erweiterungen

Erweiterungen — der häufigste Grund, warum etwas klemmt.

Der Contao-Kern ist stabil. Was Systeme aus dem Tritt bringt, sind Erweiterungen: beim Update, bei Abhängigkeitskonflikten, bei Sicherheitslücken und dann, wenn ein Hersteller die Pflege einstellt.

Referenzen ansehen →Projekt anfragen
Kurz gesagt

Erweiterungen werden über die Abhängigkeitsverwaltung installiert, nicht per Dateiupload. Konflikte entstehen, wenn zwei Pakete unvereinbare Fassungen verlangen — die Meldung nennt die Beteiligten, und sie zu lesen lohnt sich. Für die Fehlersuche gilt: einzeln deaktivieren, nicht alles auf einmal. Und vor jeder Installation die Frage: Wird sie gepflegt?

Sofort-Hilfe

Website down oder gehackt? Schreib mir per WhatsApp oder E-Mail mit Domain und kurzer Beschreibung — ich melde mich in der Regel innerhalb weniger Stunden, auch am Wochenende, wenn es brennt. Zugangsdaten bitte nie in der ersten Nachricht, sondern erst nach Absprache über einen sicheren Weg.

Wie Erweiterungen eingebunden sind.

Contao setzt auf eine Abhängigkeitsverwaltung: Erweiterungen sind Pakete mit eigenen Anforderungen an Contao, an PHP und an andere Pakete. Das ist der professionelle Weg und der Grund, warum das System berechenbar bleibt.

Daraus folgt eine Regel, gegen die oft verstoßen wird: Erweiterungen werden nicht per Dateiupload in ein Verzeichnis geschoben. Was so installiert wird, ist beim nächsten Vorgang weg oder erzeugt einen widersprüchlichen Zustand.

Zwei Dateien steuern das Ganze: eine mit den gewünschten Anforderungen, eine mit den tatsächlich aufgelösten Fassungen. Die zweite gehört in die Versionsverwaltung, damit auf allen Umgebungen dasselbe läuft.

Installieren und entfernen.

  1. Vorher sichern — Dateien und Datenbank.
  2. In der Testumgebung beginnen, nicht live.
  3. Paket hinzufügen über die Abhängigkeitsverwaltung oder den Erweiterungsbereich im Backend.
  4. Datenbankabgleich ausführen und die Vorschläge lesen.
  5. Cache leeren (Cache).
  6. Prüfen, ob Frontend und Backend normal laufen.

Beim Entfernen derselbe Weg rückwärts — und ein wichtiger Zusatz: Viele Erweiterungen legen eigene Datenbanktabellen an. Die bleiben nach dem Entfernen bestehen, und der Datenbankabgleich schlägt ihr Löschen vor. Vor dem Bestätigen prüfen, ob darin Daten stehen, die noch gebraucht werden.

Abhängigkeitskonflikte.

Die häufigste Hürde. Die Meldung sieht unübersichtlich aus, ist aber lesbar: Sie nennt die beteiligten Pakete und die jeweils verlangten Fassungen, und daraus ergibt sich der Widerspruch.

Typische Muster:

  • Erweiterung A verlangt Contao 4, installiert ist 5.
  • Zwei Erweiterungen verlangen unvereinbare Fassungen einer gemeinsamen Bibliothek.
  • Die PHP-Version passt nicht zur verlangten Fassung.
  • Eine Fassung ist festgenagelt und blockiert alles darüber.

Vorgehen: Zuerst prüfen, ob es eine neuere Fassung der blockierenden Erweiterung gibt. Wenn nein, ob sie überhaupt noch gebraucht wird. Erst danach über Ausnahmen nachdenken — und eine erzwungene Auflösung ist fast immer die schlechtere Wahl, weil sie den Widerspruch nicht löst, sondern verschiebt.

Zweithäufigster Grund für einen Abbruch ist übrigens kein Konflikt, sondern zu knapper Arbeitsspeicher auf dem Server. Die Meldung sieht dann ganz anders aus (Speicherlimit).

Fehlerquelle eingrenzen.

Wenn etwas nicht funktioniert und der Verdacht auf einer Erweiterung liegt:

  1. Protokoll lesen — die genannte Datei verrät meist das Paket.
  2. In der Testumgebung arbeiten.
  3. Verdächtige Erweiterung gezielt deaktivieren, nicht alle auf einmal.
  4. Cache leeren und erneut prüfen.
  5. Bei Erfolg: Fassung prüfen, Hersteller kontaktieren, Ersatz suchen.
  6. Bei Misserfolg: nächste Erweiterung.

Schritt eins spart die meiste Zeit und wird am häufigsten übersprungen. Eine Fehlermeldung mit Dateipfad nennt praktisch immer das verursachende Paket — das ist schneller als jedes Ausschlussverfahren (Protokoll finden).

Beim Versionssprung.

Hier entscheiden Erweiterungen über Aufwand und Machbarkeit. Vor jedem Hauptversionssprung gehört eine Liste erstellt:

ErweiterungZu klären
Gepflegt, Fassung vorhandenNichts, läuft mit
Gepflegt, Fassung angekündigtWarten oder Zwischenschritt
EingestelltErsatz suchen oder selbst übernehmen
KommerziellLizenz für die neue Fassung nötig?
Selbst gebautAnpassen
Nicht mehr genutztEntfernen, spart Arbeit

Die letzte Zeile ist die angenehmste: Bei fast jeder gewachsenen Installation lässt sich ein Teil der Erweiterungen ersatzlos streichen, weil die Funktion seit Jahren niemand nutzt. Das senkt Aufwand und Angriffsfläche gleichzeitig (Update auf Contao 5).

Eingestellte Erweiterungen.

Wenn ein Hersteller die Pflege einstellt, gibt es vier Wege:

  • Ersatz suchen. Für verbreitete Funktionen gibt es meist Alternativen.
  • Mit Bordmitteln lösen. Contao kann inzwischen vieles, wofür es früher Erweiterungen brauchte.
  • Funktion streichen, wenn sie entbehrlich ist.
  • Selbst übernehmen: Bei quelloffenen Erweiterungen lässt sich eine angepasste Fassung weiterführen.

Der vierte Weg ist ernsthaft eine Option, wird aber unterschätzt: Damit übernimmst du die Verantwortung für Pflege und Sicherheit dieses Codes — dauerhaft. Das lohnt nur, wenn die Funktion wirklich zentral ist.

Mein Rat in dieser Reihenfolge: erst drei prüfen, dann zwei, dann eins, und vier nur bei echter Notwendigkeit.

Auswahlkriterien.

  1. Wann wurde zuletzt veröffentlicht? Über ein Jahr ohne Aktualisierung ist ein Warnzeichen.
  2. Unterstützt sie die aktuelle Hauptversion?
  3. Wie viele Installationen gibt es?
  4. Werden Fehlermeldungen beantwortet?
  5. Steht ein Unternehmen dahinter oder eine Einzelperson?
  6. Braucht sie weitere Pakete? Jede Abhängigkeit erhöht das Konfliktrisiko.
  7. Geht es auch ohne? Die wichtigste Frage.

Punkt sieben zuerst stellen. Jede Erweiterung ist dauerhafte Verantwortung: Sie will aktualisiert, beim Versionssprung geprüft und im Zweifel ersetzt werden. Eine Funktion, die man mit einer kleinen Anpassung im Template löst, ist oft die bessere Wahl.

Sicherheit.

Erweiterungen sind die häufigste Einfallstelle — nicht weil sie schlecht gebaut wären, sondern weil es viele sind und nicht alle gleich gepflegt werden.

Was dazugehört: Aktualisierungen zeitnah einspielen, Sicherheitsmeldungen des Projekts verfolgen, nicht genutzte Erweiterungen entfernen statt nur deaktivieren, und bei Erweiterungen mit Dateiupload oder Formularverarbeitung besonders aufmerksam sein.

Eine deaktivierte Erweiterung, deren Dateien noch auf dem Server liegen, kann weiterhin angreifbar sein. Entfernen heißt entfernen (Wartung, Absichern).

Eigene Erweiterungen.

Wenn es für eine Anforderung nichts Passendes gibt, ist eine eigene Erweiterung der saubere Weg — deutlich besser als Anpassungen im Kern, die beim nächsten Update verschwinden.

Was dabei zu beachten ist: als eigenes Paket mit klaren Anforderungen aufbauen, in der Versionsverwaltung halten, Konfiguration nicht fest verdrahten und dokumentieren, was sie tut. Letzteres entscheidet darüber, ob in drei Jahren noch jemand damit arbeiten kann.

Contao setzt dabei auf etablierte Muster aus dem Unterbau — wer sich daran hält, baut etwas, das auch nach einem Versionssprung noch funktioniert.

Aufräumen.

Einmal im Jahr lohnt ein Durchgang: Welche Erweiterungen sind installiert, welche werden tatsächlich genutzt, welche sind veraltet, welche eingestellt?

Das Ergebnis ist regelmäßig überraschend — in einer gewachsenen Installation finden sich Erweiterungen, die vor Jahren für ein Projekt installiert und nie wieder angefasst wurden. Jede davon ist Pflegeaufwand, Angriffsfläche und ein potenzielles Hindernis beim nächsten Versionssprung.

Der beste Zeitpunkt dafür ist vor einem geplanten Update. Dann zahlt das Aufräumen direkt auf den Aufwand ein.

Wenn du nicht weiterkommst.

Wenn eine Erweiterung Ärger macht oder du vor einem Update wissen musst, was mit deinen Erweiterungen passiert. Ich finde die Ursache, behebe sie und erkläre dir, was passiert ist. Bei einem laufenden Ausfall hilft der Notfall-Support, dauerhaft begleitet die Contao-Wartung.

Fehleranalyse & Erste Hilfeab ~150 €

Ursache finden, Website wieder zum Laufen bringen, kurzer Bericht — meist am selben Tag.

Stundensatz~95 €

Für Anpassungen, Fehlerbehebung und Beratung nach Aufwand, abgerechnet in 15-Minuten-Schritten.

Wartungab ~49 €/Monat

Updates, Backups, Sicherheitscheck, Monitoring — Kleinigkeiten inklusive.

Orientierungswerte, keine Fixpreise — nach einem kurzen Gespräch bekommst du ein Festpreisangebot.

Wer hilft.

Manuel Killert
Manuel Killert Webentwickler & Dozent für Webentwicklung B.A. Marketing & Digitale Medien (FOM) · selbstständig seit 2022
Mehr über mich →

Ich bin Manuel Killert, Webentwickler aus Quakenbrück. Content-Management-Systeme sind mein Fachgebiet — ich arbeite seit Jahren damit, unterrichte das Thema als Dozent und kenne die Systeme nicht nur aus der Anwendung, sondern von innen: Datenmodell, Rechtekonzept, Templating, Erweiterungsarchitektur, Betrieb.

Das ist bei Contao besonders nützlich, weil es auf demselben Unterbau aufsetzt wie andere professionelle Systeme. Wer versteht, wie Abhängigkeitsverwaltung, Zwischenspeicherung und Konfigurationsebenen zusammenspielen, findet Fehler schneller — unabhängig davon, welcher Name über dem Backend steht.

Was du von mir bekommst: eine Diagnose in verständlicher Sprache, eine Behebung, die nicht nur das Symptom wegräumt, und eine ehrliche Einschätzung dazu, ob dein System weiterbetrieben, aktualisiert oder abgelöst gehört. Auch wenn die Antwort lautet, dass alles so bleiben kann.

Häufige Fragen

FAQ — Erweiterungen.

Wie werden Contao-Erweiterungen installiert?

Über die Abhängigkeitsverwaltung, nicht per Dateiupload in ein Verzeichnis. Was so installiert wird, ist beim nächsten Vorgang weg oder erzeugt einen widersprüchlichen Zustand.

Was mache ich bei einem Abhängigkeitskonflikt?

Die Meldung lesen — sie nennt die beteiligten Pakete und die verlangten Fassungen. Dann prüfen, ob es eine neuere Fassung gibt, ob die Erweiterung noch gebraucht wird, und erst danach über Ausnahmen nachdenken.

Wie grenze ich eine fehlerhafte Erweiterung ein?

Zuerst das Protokoll lesen — die genannte Datei verrät meist das Paket. Das ist schneller als jedes Ausschlussverfahren. Danach gezielt einzeln deaktivieren, nicht alle auf einmal.

Was tun, wenn eine Erweiterung eingestellt wurde?

In dieser Reihenfolge prüfen: Funktion entbehrlich? Mit Bordmitteln lösbar? Gibt es Ersatz? Erst zuletzt die Erweiterung selbst übernehmen — damit übernimmst du dauerhaft Verantwortung für Pflege und Sicherheit.

Worauf achte ich bei der Auswahl?

Zuerst: Geht es auch ohne? Danach Aktualität, Unterstützung der aktuellen Hauptversion, Verbreitung, Reaktion auf Fehlermeldungen und die Zahl zusätzlicher Abhängigkeiten.

Reicht es, eine Erweiterung zu deaktivieren?

Nein. Eine deaktivierte Erweiterung, deren Dateien noch auf dem Server liegen, kann weiterhin angreifbar sein. Was nicht gebraucht wird, gehört entfernt.

Manuel Killert, Webentwickler und Dozent aus QuakenbrückManuel Killert · Webentwickler & Dozent
Kontakt

Erzähl mir, was an deinem Contao klemmt.

Schreib mir die Adresse, die Contao-Version und was passiert ist. Bei einem laufenden Ausfall schreib das in die erste Zeile — dann sehe ich es sofort.

Antwort meist innerhalb von 24 Stunden · hallo@manuelkillert.de