Wartungstemplate unter Contao 4.9 anpassen

  • 4.4
  • 4.9

So lässt sich ganz einfach das Template für den Wartungsmodus updatesicher in Contao 4.9 anpassen.

Ab Contao 4.13

Seit Contao 4.13 gibt es verschiedene Wartungsmodi. Es gibt den Wartungsmodus pro Seitenbaum, den du direkt im Backend aktivieren kannst. Der Text dazu wird über den neuen Seitentyp «503 Dienst nicht verfügbar» konfiguriert.

Dann gibt es noch den globalen Wartungsmodus, welche über den Contao Manager und die Konsole aktivierbar ist. Dieses Template kannst du weiterhin über die service_unavailable.html.twig wie hier beschrieben anpassen. Allerdings ist der globale Wartungsmodus derzeit nicht sprachabhängig und wird immer in Englisch ausgegeben.

Mehrere Wege führen ans Ziel

Unter Contao 3 konntest du ganz einfach das Template be_unavailable.html5 über das Backend von Contao überschreiben und an deine Bedürfnisse anpassen. Unter Contao 4 gibt es jetzt mehre Möglichkeiten, wie du dieses Template für den Wartungsmodus updatesicher anpassen kannst.

Variante 1: service_unavailable.html.twig überschreiben

1.1 HTML-Template erstellen

Die schnellste und einfachste Variante besteht darin, dass du eine eigene service_unavailable.html.twig erstellst.

Dazu musst du nur mit einem Editor eine neue Datei mit dem Namen service_unavailable.html.twig erzeugen und ein simples HTML-Wartungs-Template vorbereiten.

Das kann dann am Ende so aussehen:

Contao 4 einfaches Wartungstemplate

1.2 Template hochladen

Wenn du dann zufrieden mit deinem Template bist, dann muss du diese Datei nur noch in einen speziellen Pfad hochladen. Der vollständige Pfad lautet wie folgt:

/templates/bundles/ContaoCoreBundle/Error/service_unavailable.html.twig

1.3 Contao Cache leeren

Contao Manager: Anwendungs-Cache erneuern

Damit die neue Konfiguration in Contao aktiv wird, musst du jetzt per Contao Manager den Anwendungs-Cache neu aufbauen. (Systemwartung > Prod.-Cache erneuern)

Schritt für Schritt Anleitung als Video

Allen Mitgliedern der Contao Academy steht ein Praxisvideo zu Verfügung, dass Schritt für Schritt alles erklärt und zeigt.

Variante 2: Gezielt nur einzelne Bereiche überschreiben

Contao 4 - angepasstes Wartungstemplate Schritt 5

Mit der oben vorgestellten Variante wird nur das Wartungstemplate komplett überschrieben. Sollte allerdings eine andere Fehlermeldung auftreten, dann wird trotzdem das Contao-Default Error-Template ausgegeben.

Deswegen kannst du zu zum Beispiel auch nur die einzelnen Textbereiche und das generelle Fehler-Layout anpassen. So kannst du bei Bedarf das Contao-Logo durch dein eigenes Logo oder das CSS anpassen.

Im Core von Contao 4.9 sind für die Frontendausgabe im Wartungsmodus folgende Dateien zuständig:

  • service_unavailable.html.twig - Wartungstemplate
  • layout.html.twig - Layouttemplate für alle Errortemplates
  • exception.xlf - Sprachdateien für Fehlermeldungen

Wie das Schritt für Schritt angepasst werden kann, erfährst du ebenfalls in der Contao Academy im Bereich "Praxisvideos" oder im offiziellen Contao-Handbuch.

Hat dir dieser Artikel gefallen?

Willst du in Zukunft keinen Artikel verpassen?
Dann trage hier deine E-Mailadresse ein und klicke auf "Abonnieren". Du erhältst regelmäßig aktuelle Infos über Contao und die Contao-Academy.

Du kannst deine E-Mail-Adresse jederzeit mit nur einem Mausklick aus unserem System löschen. Der Newsletter Versand sowie die individuelle Messung, Speicherung und Auswertung von Öffnungsraten und der Klickraten in Empfängerprofilen erfolgen durch KlickTipp. Ausführliche Hinweise erhältst du in unserer Datenschutzerklärung.

Über den Autor
Christian Feneberg (Gründer Fenepedia)

Christian Feneberg ist der Gründer der Contao-Academy und erstellt seit 2010 Websites mit Contao. Außerdem ist er im Team von trakked.io. und regelmäßig auf YouTube in der Contao Show zu sehen. Neben Contao begeistert er sich für Online-Marketing, Unternehmertum und Persönlichkeitsentwicklung.

Folge Christian jetzt auf Twitter, Xing und LinkedIn.

1 Kommentare

Gene |

Leider funktioniert das bei mir nicht.. Gibt es noch irgendetwas was beachtet werden muss?

Christian Feneberg Antwort von Christian Feneberg

Hallo Gene,

welche Contao Version verwendest du?

Ab Contao 4.13 gibt es für die Wartungsseite einen eigenen Seitentyp "503 Dienst nicht verfügbar"

Einen Kommentar schreiben

Was ist die Summe aus 5 und 9?