Dokumentation»Grundlagen»Templates

Grundlagen

Im Plugin-Verzeichnis findest du den Ordner templates. In diesem befinden sich alle mitgelieferten PHP-Template-Dateien, auf die das Plugin zur Ausgabe von Listen, Tabellen und einzelnen Produktboxen zugreift.

Wenn du vorhandene Templates überschreiben, oder neue Templates anlegen willst, findest du in der Dokumentation zum Templating alle Informationen.

Hinweis: Bitte niemals Änderungen innerhalb des Plugin-Verzeichnisses vornehmen, da diese sonst beim nächsten Update überschrieben werden!

Funktionsweise der Templates

Das Amazon Affiliate WordPress Plugin verwendet folgende drei Template-Arten: Layouts, Produkte und Elemente. Bei den Layouts handelt es sich, wie der Name schon vermuten lässt, um das (HTML-) Gerüst. Dieses ruft wiederum zur Darstellung der einzelnen Produkte, den gleichnamigen Template-Typen „Produkte“ auf.

Dadurch ist es möglich, verschiedene Layouts mit den gleichen Produktboxen zu verwenden, ohne diese doppelt zu erstellen: z.B. die normale Darstellung untereinander, sowie mehrspaltig nebeneinander als Grid. Bei den Elementen handelt es sich lediglich um kleine HTML-Fragmente (z.B. der Button), die ausgelagert wurden, damit sie im Nachhinein individuell angepasst werden können.

Layout-Templates

Template Beschreibung
loop.php
(Standard)
Schleife (Loop) zur Ausgabe der einzelnen Produkte untereinander
grid.php Schleife zur Ausgabe der einzelnen Produkte nebeneinander (Grid)
table.php Ausgabe der einzelnen Produkte in Tabellen-Form
widget.php Schleife zur Ausgabe der einzelnen Produkte in Widgets

Die Layout-Templates liegen direkt im Stammverzeichnis: /templates/.


Produkt-Templates

Template Beschreibung
horizontal.php
(Standard)
Produktbox, nutzt die volle Seitenbreite
list.php Stellt eine Zeile der Produkt-Liste dar
vertical.php Produktbox, kompakt und vertikal (quadratisch) ausgerichtet
widget-small.php Kompakte Produktdarstellung im Widget mit Bild, Titel, Bewertung und Preis
widget-vertical.php
(Standard)
Produktbox im Widget, kompakt und vertikal (quadratisch) ausgerichtet

Die Produkt-Templates liegen im entsprechenden Unterordner: /templates/products/.


Template-Elemente

Template Beschreibung
button.php Schaltfläche (Button), der in den Produkt-Templates verwendet wird
no-products.php Rückmeldung die ausgegeben wird, wenn keine Produkte (bei Listen) gefunden wurden
ribbon.php Band am oben linken/rechten Eck von Produktboxen, welches zur Darstellung der Nummerierung (z.B. Bestseller) oder des Angebot/Sale-Hinweise verwendet wird

Die Template-Elemente liegen in folgendem Unterordner: /templates/parts/.

Auswirkungen auf’s Templating

Vereinfach dargestellt, sieht ein Template-Aufruf wie folgt aus:

Layout (wird nur 1-mal aufgerufen) >>> Produkt (für jedes einzelne Produkt)

Beim Templating kann deshalb, je nach Anwendungsfall, entweder nur das einzelne Produkt-Template ersetzt werden, oder einfach das Produkt-Template direkt ins Layout-Template eingefügt werden.