Templates überschreiben
Das Template-System wählt eine Datei in zwei Schritten. Das ist der Gedanke des ganzen Kapitels, und er hat sich nicht geändert.
- Die Override-Regeln werden zuerst betrachtet (
override.ini). Passt eine Regel mit ihren Bedingungen auf das angeforderte Template, wird die Template-Datei verwendet, die sie nennt. - Passt keine Regel, wird die Datei in den Designs gesucht, in ihrer Reihenfolge: das Design des Siteaccess, die
Designs der Erweiterungen, dann
standard. Die erste gefundene Datei wird verwendet. (Das ist die Kaskade.)
Sie ändern ein Template also, ohne das Original anzufassen: Legen Sie ein spezifischeres in Ihr Design oder fügen Sie eine Regel hinzu, die eine Klasse, eine Sektion oder einen Knoten an eine eigene Datei schickt.
Die Syntax
Eine Regel ist ein Block in einer override.ini.append.php Ihres Siteaccess oder einer Erweiterung:
[full_article]
Source=node/view/full.tpl
MatchFile=full/article.tpl
Subdir=templates
Match[class_identifier]=article- Der Blockname (
full_article) ist ein beliebiger eindeutiger Name. Sourceist das Template, das angefordert wird.MatchFileist die Datei, die stattdessen verwendet wird, unterhalb von<design>/override/templates/eines Designs, zum Beispielextension/mysite_design/design/mysite/override/templates/full/article.tpl(beiSubdir=templates).Match[...]sind die Bedingungen. Alle müssen erfüllt sein.
Die Schlüssel des Buchs waren die Klasse, die Sektion, der Knoten, das Objekt und die Tiefe. Heute gibt es mehr, die in
Override-Bedingungen aufgeführt sind:
class_identifier (verwenden Sie diesen statt des numerischen class), class_group, node, object, parent_node,
parent_class_identifier, section_identifier (statt section), state_identifier, depth, url_alias, layout und
weitere. Wo mehrere Regeln passen, entscheidet eine Priority.
Ein ausgearbeitetes Beispiel
Die Vollansicht jedes Artikels soll sich von der Standardansicht unterscheiden:
- Kopieren Sie
design/standard/templates/node/view/full.tplnachoverride/templates/full/article.tplin Ihrem Design. - Fügen Sie den Block
[full_article]von oben hinzu. - Leeren Sie den Override-Cache: Eine neue Regel oder eine neue Datei braucht
php bin/php/ezcache.php --clear-id=template-override --allow-root-user(siehe Welchen Cache leere ich?). - Laden Sie eine Artikelseite.
TemplateSettings ShowUsedTemplates=enabled(nur für Sie, auf einer Entwicklungsinstallation) listet das verwendete Template auf und den Override, der es ausgewählt hat.
Design > Template editor in der Administration listet die Regeln in der Reihenfolge, in der sie versucht werden, und lässt Sie sie umordnen.
Mehr: Template-Overrides: die Grundlagen und Ressourcen und Overrides.
Weiter: Häufige Aufgaben mit Templates.
Quelle und Lizenz
Bearbeitet nach Kapitel 3, „Displaying Content with eZ publish Templates“, von Learning eZ publish: Building Content Management Solutions von Paul Borgermans, Tony Wood, Paul Forsyth, Martin Bauer, Björn Dieding und Ben Pirt (zusätzliches Material von Bruce Morrison), zweite Auflage, 2024, Book-Learning-eZPublish. Copyright (c) 2004-2024 7x und Graham Brookins. Lizenziert unter der GNU Free Documentation License, Version 1.3 oder einer späteren Version, ohne unveränderliche Abschnitte, ohne vordere und ohne hintere Umschlagtexte (die Lizenz). Änderungen: umgestellt und gekürzt; Syntax, Operatoren, Einstellungen und Beispiele auf Exponential 6 aktualisiert (foreach, aktuelle Einstellungen, kein Inline-Stil und kein Inline-Skript).