Skip to content

Added a minor change regarding the maintenance template path in Contao 5.5. #1746

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
cmette wants to merge 7 commits into
base: main
Choose a base branch
from
+10 −2
Open

Added a minor change regarding the maintenance template path in Contao 5.5. #1746

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
5fb93d2
Update maintenance-template.de.md
cmette Mar 26, 2026
b5e8a76
Update maintenance-template.en.md
cmette Mar 26, 2026
a5d3ec0
Merge pull request #1 from cmette/cmette-patch-2
cmette Mar 26, 2026
be7ba7c
Update docs/manual/guides/maintenance-template.de.md
cmette Mar 26, 2026
039ee59
Update docs/manual/guides/maintenance-template.de.md
cmette Mar 26, 2026
77484ac
Update docs/manual/guides/maintenance-template.en.md
cmette Mar 26, 2026
40c9b58
Update docs/manual/guides/maintenance-template.en.md
cmette Mar 26, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 5 additions & 1 deletion docs/manual/guides/maintenance-template.de.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -90,7 +90,9 @@ Wird die komplette Contao-Installation über die Kommandozeile in den Wartungsmo

Das machen wir in diesem Beispiel für alle Errortemplates. Für eine updatesichere Anpassung kopieren wir uns das Originaltemplate `vendor/contao/core-bundle/src/Resources/views/Error/layout.html.twig` nach `/templates/bundles/ContaoCoreBundle/Error/`

{{< version-tag "5.1" >}} befindet sich das Originaltemplate unter `vendor/contao/core-bundle/templates/Error/layout.html.twig`
{{< version-tag "5.1" >}} befindet sich das Originaltemplate unter `vendor/contao/core-bundle/templates/Error/layout.html.twig`.

{{< version-tag "5.5" >}} muss das Template nach `/templates/error/` kopiert werden.

Dort setzen wir unser eigenes Logo innerhalb des DIV's mit der Klasse `header-logo` ein. Du kannst dafür ein normales image-Tag verwenden oder wie im Originaltemplate ein Inline-SVG.

Expand Down Expand Up @@ -124,4 +126,6 @@ Weitere Informationen zur Anpassung von Twigtemplates findest du in der [Twig-Do
Anstatt nur einzelne Texte anzupassen, kannst du auch einfach das komplette Template `service_unavailable.html.twig` mit deinem eigenen HTML und CSS überschreiben.
Damit das ganze updatesicher ist, musst du die Datei in den Ordner `/templates/bundles/ContaoCoreBundle/Error/` speichern.

{{< version-tag "5.5" >}} muss das Template nach `/templates/error/` kopiert werden.

Zum Schluss muss auch hier der Produktions-Cache erneuert werden.
6 changes: 5 additions & 1 deletion docs/manual/guides/maintenance-template.en.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -89,7 +89,9 @@ When the complete Contao installation is put into maintenance mode via the comma

In this example we do this for all error templates. For an update-safe adaptation we copy the original template `vendor/contao/core-bundle/src/Resources/views/Error/layout.html.twig` to `/templates/bundles/ContaoCoreBundle/Error/`.

{{< version-tag "5.1" >}} the original template is located at `vendor/contao/core-bundle/templates/Error/layout.html.twig`
{{< version-tag "5.1" >}} the original template is located at `vendor/contao/core-bundle/templates/Error/layout.html.twig`.

{{< version-tag "5.5" >}}, the template must be copied to `/templates/error/`.

There we put our own logo inside the DIV with the class `header-logo`. You can use a normal image tag for this or an inline SVG like in the original template.

Expand Down Expand Up @@ -123,4 +125,6 @@ For more information about customizing Twig templates, please refer to the [Twig
Instead of just changing some texts, you can simply overwrite the whole template `service_unavailable.html.twig` with your own HTML and CSS.
To make the whole thing update-safe, you have to save the file in the folder `/templates/bundles/ContaoCoreBundle/Error/`.

{{< version-tag "5.5" >}}, the template must be copied to `/templates/error/`.

Finally you have to refresh the production cache.