Template-Debugging
Diese Seite ist für Designer, deren Template nicht tut, was sie erwarten. Sie listet die Werkzeuge vom schnellsten zum tiefsten auf. Bei „meine Änderung erscheint nicht“ beginnen Sie mit Ein Design debuggen (Caches); bei „welches Template ist das“ mit Template-Pfadkommentare.
Inhalt
Die Debug-Ausgabe
Auf einem Test-Siteaccess, nur für Ihre Adresse:
[DebugSettings]
DebugOutput=enabled
DebugByIP=enabled
DebugIPList[]=203.0.113.10
[TemplateSettings]
ShowUsedTemplates=enabledUnter der Seite erscheinen die Warnungen und Fehler der Anfrage, Zeitmessungen, Datenbankabfragen und mit ShowUsedTemplates
eine Tabelle jedes verwendeten Templates mit der Datei, aus der es kam. Template-Warnungen nennen Template und Zeile
(Compiler-Warnungen tragen seit der Arbeit an den Pfadkommentaren im August 2026 die Fundstelle).
In eine Variable sehen
$node|attribute( show, 1 ) {* the attributes of $node and their values, one level deep *}
$module_result.content_info|dump( show, 2 )Entfernen Sie diese vor dem Commit: Sie geben interne Daten auf der Seite aus.
Debug-Funktionen
Aus lib/eztemplate/classes/eztemplatedebugfunction.php, angezeigt in der Debug-Ausgabe, nicht auf der Seite:
debug-log msg='teaser part reached'
debug-log var=$items msg='items of the list'
debug-timing-point id='menu' ... /debug-timing-point
debug-accumulator ... /debug-accumulatordebug-timing-point misst, wie lange ein Teil des Templates braucht.
Syntaxprüfung
./console exp:eztemplatecheck extension/mytheme/design/mytheme/templates/
./console exp:eztemplatecheck -s mysitemeldet jede Datei als gültig oder mit ihrem Parse-Fehler. Es führt Templates nicht aus, kann also keine unbekannten Operatoren oder fehlenden Variablen finden.
Typische Meldungen
Meldung (Debug-Ausgabe oder var/log/error.log) | Bedeutung |
|---|---|
| Operator '...' is not registered | Den Operator gibt es nicht, oder seine Erweiterung ist hier nicht aktiv |
| Variable '...' is already defined | ein {def} einer vorhandenen Variablen (Variablen und def) |
| Variable '...' is not defined with {def} | {undef} einer Variablen, die nicht definiert war |
| Custom match file: path '...' not found in any resource | das MatchFile eines Overrides existiert nicht |
| Image '...' does not exist in any design | eine Datei für ezimage fehlt in der Kaskade |
| Could not find: ... | ein dem Packer übergebenes Stylesheet oder Skript fehlt |
Verwandte Seiten
- Template-Pfadkommentare
- Häufige Template-Fehler
- Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.
Werden Sie Exponential-Partner
Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.