Zum Hauptinhalt springen

Theme bauen: Die Template-Hierarchie

Auflösungsreihenfolge für die Einzelansicht

  1. single-<ContentTyp>.tpl im aktiven Theme (z.B. single-Product.tpl)
  2. single.tpl im aktiven Theme (genereller Fallback)
  3. Eigenes Standard-Template der Erweiterung selbst, falls vorhanden (contents/<Typ>/templates/default/single.tpl)
  4. Eingebauter Notfall-Hinweis statt eines Fatal Errors, falls nichts davon existiert

Für Kurzansichten (Teaser) und Archiv-Seiten gilt dieselbe Reihenfolge, nur mit teaser-<Typ>.tpl/teaser.tpl bzw. archive-<Typ>.tpl/archive.tpl.

Warum das wichtig ist

Ein Theme muss NICHT für jeden einzelnen Content-Typ eine eigene Vorlage mitbringen - der generische Fallback (single.tpl) greift automatisch. Für ein wirklich passendes Ergebnis (z.B. Preis und Warenkorb-Button bei einem Shop-Produkt) reicht der generische Fallback aber meist nicht - dann lohnt sich eine typ-spezifische Vorlage.

Kein einziges der vier mitgelieferten Themes hatte je ein passendes Produkt-Template für den Shop - Produkte zeigten dadurch nur nackten Titel und Text, komplett ohne Preis oder Warenkorb-Button. Der generische Fallback verschluckt zwar keinen Fehler, aber eben auch keine typ-spezifischen Felder wie Preis oder Lagerstatus.