Template-Pfadkommentare #

Diese Seite ist für Designer, die eine Seite ansehen und das Template hinter einem Teil davon brauchen. Mit eingeschalteten Template-Pfadkommentaren wird jedes gerenderte Template von zwei HTML-Kommentaren umschlossen, die seine Datei nennen. Die Funktionsseite ist Template-Pfadkommentare.

Inhalt #

1. Einschalten
2. Lesen
3. Vorsicht

Einschalten #

Auf einem Test-Siteaccess:

# settings/siteaccess/<test siteaccess>/site.ini.append.php
[TemplateSettings]
ShowTemplatePathComments=enabled

und dann den Template-Cache leeren (php bin/php/ezcache.php --clear-tag=template), weil kompilierte Templates die Prüfung tragen. Die Exp-Debugleiste kann dieselbe Einstellung umschalten.

Lesen #

<!-- START design/media/templates/pagelayout/footer.tpl -->
...the footer markup...
<!-- STOP design/media/templates/pagelayout/footer.tpl -->

Hat ein Override geantwortet, wird das angeforderte Template in Klammern genannt:

<!-- START design/media/templates/node/view/full/article.tpl (node/view/full.tpl) -->

„Die Datei article.tpl hat die Anfrage node/view/full.tpl beantwortet.“ Im Elementinspektor des Browsers erscheinen die Kommentare um die Elemente, sodass Sie von jedem Element zu seinem Template hinaufsteigen können.

Vorsicht #

• Nur für die Entwicklung: Die Kommentare fügen jedem Template Markup hinzu, zerstören JSON-, XML- und RSS-Ausgaben und verraten Dateipfade. Lassen Sie die Einstellung auf Live-Siteaccesses auf disabled (ihr Kommentar in settings/site.ini sagt dasselbe).
• Gecachte Ausgabe behält die Kommentare, mit denen sie gerendert wurde: Leeren Sie nach dem Umschalten Inhalts- und Template-Caches.

Verwandte Seiten #

• Template-Debugging
• Ein Design debuggen
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.