Zum Hauptinhalt springen
Zu jedem Produkt gehören zwei Dinge, die auf fast jeder Seite gebraucht werden: ein Bild und ein Link. Die PR-Tags dieser Seite liefern beides. Dazu kommen die URL-kodierten Fassungen einzelner Produktwerte, die Sie brauchen, wenn Sie einen Wert selbst an einen Link anhängen, und die SEO-Felder des Produkts. Alle Tags dieser Seite arbeiten mit dem aktiven Produkt. Auf der Produktdetailansicht ist das das angezeigte Produkt, in einer Liste das Produkt des aktuellen Schleifendurchlaufs. Referenz: PR- (Grundlagen und Produktdaten)

Die vier Bildgrößen

Ein Produkt kann vier Bilder haben. Jede Größe hat ein eigenes Produktdatenfeld, ein eigenes Verzeichnis und ein eigenes Tag. Statt des festen Produktdatenfelds können Sie auch ein freies Produktdatenfeld vom Typ Medien verwenden. Welche Größe dabei herauskommt, legt der Typ des freien Feldes fest.
Alle vier Tags geben als Einzel-Tag einen vollständigen Pfad aus, den Sie unverändert in das src-Attribut setzen. Als Klammerung greifen sie, wenn das zugehörige Produktdatenfeld gefüllt ist. Klammern Sie immer, denn ein leeres Feld ergibt sonst ein img-Element ohne Quelle. Für das alt-Attribut eignet sich PR-Name_StripHtml besser als PR-Name, weil der Produktname Auszeichnungen enthalten kann und diese im alt-Attribut nichts zu suchen haben. Das Shopsystem kann die Bildadresse für Suchmaschinen aufbereiten und dabei den Produktnamen und das Produktdatenfeld RobotImageKeywords in den Pfad einbauen. Das ist je Bildgröße einzeln konfigurierbar. Die Tags selbst ändern sich dadurch nicht, nur die ausgegebene Adresse sieht anders aus. PR-Link() erzeugt den Link auf ein Produkt. Ohne Argument ist das immer das Produkt, in dessen Zusammenhang das Tag steht.
Mit Argument verlinken Sie auf ein bestimmtes anderes Produkt. Als Argument geben Sie einen Produktindex an, entweder fest oder aus einem freien Produktdatenfeld.
Übergeben Sie ein Tag als Argument, ersetzen Sie dessen Tilde-Zeichen durch Dollar-Zeichen. ~PR-Link(~PR-Feld~)~ funktioniert nicht, ~PR-Link($PR-Feld$)~ schon.
Ohne Argument und mit einem freien Produktdatenfeld als Argument braucht das Tag ein aktives Produkt und gehört deshalb auf ein Produkttemplate oder in eine Produktschleife. Mit einem festen Produktindex steht es auf allen Templates zur Verfügung. PR-Link ist ausschließlich ein Einzel-Tag. Als Klammerung gibt es nichts aus. Der erzeugte Link enthält neben dem Produktindex auch den Index der Kategorie, aus der heraus verlinkt wird. Dasselbe Produkt bekommt dadurch je nach Weg unterschiedliche Adressen. Soll der Link unabhängig von der Kategorie sein, verwenden Sie PR-LinkWithoutCI(). Es arbeitet genau wie PR-Link(), lässt aber den Kategorie-Index weg. Sie eignen sich überall dort, wo eine Adresse eindeutig sein muss, beispielsweise in Exporten, in E-Mails oder als Ziel einer Weiterleitung.
PR-SetLink gehört in den PR-Data-Bereich der Produktdetailansicht, weil erst dort die gewählte Setkombination feststeht. Es ist das Gegenstück zu PR-ActionImagesUploadLink und führt auf die Anzeige statt auf das Hochladen. Alle vier Tags sind ausschließlich Einzel-Tags. Als Klammerung gelten sie als ungültiges Tag. Wegweiser: ProductsInAction

URL-kodierte Werte

Wenn Sie einen Produktwert selbst an eine Adresse anhängen, muss er URL-kodiert sein. Für die vier Werte, bei denen das regelmäßig vorkommt, gibt es fertige Tags.
Im Shopsystem teilt es sich den Zweig mit PR-Number und greift deshalb auch als Klammerung und als negative Klammerung, und zwar nach demselben Wert. Für die Klammerung ist es gleichgültig, welches der beiden Tags Sie nehmen.
Im Produktmenü-Typ Bestellen aus Katalog liefern PR-Number und PR-NumberEnc nicht die Produktnummer aus den Produktdaten, sondern die vom Käufer eingegebene Nummer der aktuellen Zeile. Das ist beabsichtigt, überrascht aber, wenn man das Template von einer Produktliste übernimmt.

Die SEO-Felder des Produkts

Neben dem Produktnamen pflegt das Shopsystem einen eigenen SEO-Produktnamen und zwanzig freie SEO-Felder.
Jede Auswertung eines dieser Tags liest die SEO-Felder aus der Datenbank. Holen Sie den Wert einmal in eine Klammerung und arbeiten Sie innerhalb davon weiter, statt dasselbe Tag an mehreren Stellen der Seite zu wiederholen.
Die SEO-Felder liefern denselben Inhalt wie die E-PSEO_Field1…20-Tags. Der Unterschied ist die Blickrichtung: die E-PSEO_Tags gehören zur Seite, die PR-SeoFreeField-Tags zum Produkt und funktionieren deshalb auch in einer Liste je Eintrag. Im Shopsystem hängen sie am aktiven Produkt und stehen damit überall zur Verfügung, wo Produktdaten vorliegen. Referenz: E-PSEO_Field1…20 PR-DeepLink ist kein Tag des Shopsystems. Es gehört zum Produktdaten-Export und wird dort beim Erzeugen der Exportdatei ersetzt. Zur selben Familie gehören: Zu PR-DeepLink, PR-DeepLinkPath und PR-CanonicalDeepLink gibt es jeweils eine Fassung mit dem Präfix ENCXML-, die den Wert XML-gerecht maskiert ausgibt.
In der Tag-Tabelle des Shopsystems kommt PR-DeepLink nicht vor. Für einen Produktlink in einer E-Mail verwenden Sie PR-Link oder PR-LinkWithoutCI.
Wegweiser: Produktdaten-Export

Veraltete Tags

Aus früheren Versionen stammen Bild- und Link-Tags mit einem zusätzlichen Listenkürzel im Namen, beispielsweise PR-CL-MiniThumbnail, PR-CSL-MiniThumbnail, PR-SL-MiniThumbnail und PR-SL-Link. Sie waren für die Cross-Link-Liste und die Ersatzproduktliste gedacht.
Diese Tags sind im Shopsystem zwar noch namentlich vorhanden, geben aber in jeder Verwendungsart ein ungültiges Tag zurück. Verwenden Sie stattdessen die normalen Bild- und Link-Tags innerhalb der jeweiligen Schleife.

Im Shopsystem vorhanden, bisher nicht beschrieben

Neben den oben genannten Tags gibt es zwei weitere SEO-Tags, für die bisher keine Beschreibung vorliegt. Beide sind im Shopsystem als Produktdatenfelder angelegt. Was genau sie ausgeben und in welchen Templates sie greifen, ist noch zu klären.

Die Tags im Überblick

Die Bildtags, die kodierten Werte und die SEO-Tags stehen überall zur Verfügung, wo Produktdaten vorliegen, also auf der Produktdetailansicht und innerhalb von PR-Data, @PR-Data und PR-AdvData(). PR-SetLink und PR-SetLinkEnc gehören auf die Produktdetailansicht. PR-Link() und PR-LinkWithoutCI() brauchen ein aktives Produkt, außer wenn Sie einen festen Produktindex als Argument angeben.

Verwandte Themen