Template-Variablen anzeigen

Wenn du ein Template in Contao anpassen möchtest, ist es nützlich, die verfügbaren Template-Variablen zu kennen. In diesem kurzen Beitrag erfährst du, wie du Template überschreiben und alle verfügbaren Variablen ausgeben kannst.

Ein Template kopieren und bearbeiten

Um ein Template zu überschreiben, gehe zunächst in das Backend deiner Contao-Installation. Öffne anschließend den Menüpunkt Layout > Templates und erstelle ein neues Template, indem du eine Kopie eines Original-Templates anlegst.

Für «Latest News» wäre das beispielsweise: news_latest.html5

Nun kannst du den Quelltext des Templates direkt in Contao öffnen und bearbeiten.

Die Variablen in einem Template lassen sich wie folgt ansprechen: $this->variablenname.
So kannst du z. B. im News-Template den Headline--Links ausgeben lassen:

<?= $this->linkHeadline ?>

Verfügbare Variablen ausgeben

Um anzeigen zu lassen, welche Template-Variablen derzeit verfügbar sind, kannst du folgenden PHP-Code im Template ergänzen:

Contao 3.5

<?php $this->showTemplateVars(); ?>

Contao 4 und Contao 5 (HTML-Templates)

<?php $this->dumpTemplateVars(); ?>

Templatevariablen bei aktivem Debugmodus

Wenn du in Contao den Debugmodus aktiviert hast, dann werden die Template-Variablen nicht mehr direkt ausgegeben. Du kannst diese dann über den Symfony Profiler ansehen. (siehe Screenshot)

Contao 5 (Twig)

Variablen werden in Twig innerhalb von geschweiften Klammern ausgegeben:
{{ name_der_variablen }}

Um alle verfügbaren Variablen auszugeben, verwendest du:
{{ dump() }}

Um eine konkrete Variable auszugeben, kannst du diese mit angeben:
{{ dump(name_der_variablen) }}

Twig-Templates

Das ist nur ein kurzer Überblick, zur Vertiefung empfehle ich dir, das Kapitel über Twig im Contao Handbuch zu lesen.

Wichtiger Hinweis

Aus Sicherheitsgründen unbedingt darauf achten, dass der Code für die Ausgabe der Variablen nach Bearbeitung des Templates wieder entfernt wird.

Möchtest du über neue Artikel informiert werden?

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 ist der Initiator und Dozent der Contao Academy. Er bringt über 15 Jahre Praxiswissen in der professionellen Umsetzung von Contao-Websites mit. Zudem ist er Teil des Teams von trakked.io. Er liebt es, sich neues Wissen anzueignen und es weiterzugeben. Abseits des Bildschirms verbringt er am liebsten Zeit mit seiner Familie und in der Natur.

Folge Christian jetzt bei LinkedIn.

Christian Feneberg

Einen Kommentar schreiben

Bitte rechnen Sie 2 plus 9.