Zum Hauptinhalt springen
Bei ProductsInAction laden Käufer eigene Fotos zu einem Produkt hoch und zeigen, wie sie es benutzen. Diese Bilder lassen sich an zwei Stellen einbauen: auf der Produktseite als Bilder genau zu diesem Produkt, und an beliebiger Stelle als zufällige Auswahl aus dem ganzen Shop. Beide Wege führen über eine Schleife. Innerhalb der Schleife holen die übrigen PIA-Tags zu jedem Bild die Datei selbst, den Urheber, den Zeitpunkt, die Bewertung und den Weg zurück zum Produkt. Wegweiser: ProductsInAction

Die beiden Einstiege

Beide verhalten sich gleich: als Klammerung prüfen sie, ob überhaupt Bilder vorliegen, als Schleife laufen sie darüber.
Die Anzahl ist Pflicht, und sie muss auch am Schleifentag stehen. {@PIA-Data} ohne Argument und {PIA-Data(0)} gelten beide als ungültiges Tag. Schreiben Sie dieselbe Zahl in die Klammerung und in die Schleife.
PIA-Data arbeitet mit dem Produkt der aktuellen Seite und gehört deshalb auf das Produkttemplate. PIA-RandomData braucht kein Produkt und steht überall, beispielsweise auf der Startseite. Das Shopsystem begrenzt die Anzahl nach oben. Fordern Sie mehr Bilder an, als erlaubt sind, bekommen Sie stillschweigend die Höchstzahl.
Jede Auswertung des Tags fragt die Datenbank ab. Öffnen Sie die Klammerung deshalb einmal pro Seite und arbeiten Sie innerhalb davon weiter, statt PIA-Data an mehreren Stellen zu wiederholen.
Ist ProductsInAction im Shop nicht freigeschaltet, geben alle Tags dieser Seite nichts aus und keine Klammerung greift. Ein Template mit ProductsInAction läuft also auch in einem Shop ohne diese Funktion, es bleibt dort einfach still.

Die Bilder

Beide geben als Einzel-Tag eine vollständige Adresse aus, die Sie unverändert in das src-Attribut setzen können. Als Klammerung greifen sie, wenn die jeweilige Fassung vorhanden ist. Das lohnt sich bei PIA-Image, denn nicht zu jedem Vorschaubild muss eine große Fassung existieren.

Woher das Bild stammt

Die Klammerung PIA-PRLink greift nur, wenn das Produkt noch gültig ist. Das Shopsystem fragt das eigens nach. Bei der zufälligen Auswahl ist das wichtig, denn dort können Bilder zu Produkten auftauchen, die inzwischen aus dem Sortiment sind. Mit der negativen Klammerung zeigen Sie das Bild dann ohne Link, statt den Käufer auf eine Fehlerseite zu schicken. PIA-TechName ist die Kennung des einzelnen Bildes. Sie brauchen sie, wenn Sie einem Bild per JavaScript etwas zuordnen wollen, beispielsweise eine Bewertungsschaltfläche.

Wer wann hochgeladen hat

PIA-Date gibt das Datum im Anzeigeformat des Shops aus, PIA-Time die Uhrzeit als Stunde und Minute. Beide greifen als Klammerung, wenn überhaupt ein Zeitstempel hinterlegt ist. Der Name kann leer sein, wenn der Käufer keinen angegeben hat. Klammern Sie die Zeile, sonst steht dort ein einsames “von”.

Bewertungen

Die hochgeladenen Bilder lassen sich bewerten.
Klammern Sie mit PIA-RatingVotes. Es greift, sobald mindestens eine Bewertung vorliegt, und deckt damit beide Werte ab. PIA-RatingScore als Klammerung greift dagegen nur, wenn die gerundete Punktzahl nicht null ist, was bei lauter Nullbewertungen zu einem irreführenden Ergebnis führt. PIA-RatingScore gibt die Punktzahl immer als ganze Zahl aus. Das Shopsystem rundet den Durchschnitt vor der Ausgabe, Nachkommastellen bekommen Sie nicht.
PIA-RatingScore nimmt als Klammerung eine Punktzahl im Argument entgegen. Diese Möglichkeit arbeitet derzeit verkehrt herum: {PIA-RatingScore(5)} greift bei allen Bildern, deren Punktzahl nicht fünf beträgt. Verwenden Sie das Argument deshalb vorerst nicht.

Veraltete Tags

Vor der Umbenennung auf PIA- hieß die Funktion Aktionsbilder, und die Tags trugen das Präfix AI-. Diese älteren Namen sind im Shopsystem weiterhin vorhanden und tun dasselbe wie ihre Nachfolger. In neuen Templates verwenden Sie die PIA-Namen. Die alten Namen sind keine Kopien, sondern führen im Shopsystem auf dieselbe Stelle. Sie können ein bestehendes Template deshalb Tag für Tag umstellen und beide Schreibweisen übergangsweise nebeneinander verwenden.

Die Tags im Überblick

PIA-Data gehört auf das Produkttemplate, PIA-RandomData ist auf allen Templates zulässig. Alle übrigen Tags arbeiten ausschließlich innerhalb der Schleife über eines der beiden und gelten außerhalb als ungültiges Tag.

Verwandte Themen