> ## Documentation Index
> Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt
> Use this file to discover all available pages before exploring further.

# PR- (Bilder und Links)

> Produktbilder in vier Größen ausgeben, auf ein Produkt verlinken, Werte URL-kodiert übergeben und die SEO-Felder des Produkts auf dem Template nutzen.

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)](https://dokumentation.websale.de/v8s/referenz/tags/pr/grundlagen-und-produktdaten.md)

## Die vier Bildgrößen

Ein Produkt kann vier Bilder haben. Jede Größe hat ein eigenes Produktdatenfeld, ein eigenes Verzeichnis und ein eigenes Tag.

| Tag | Produktdatenfeld | Verzeichnis unter `benutzer/produkte/medien/bilder/` |
| - | - | - |
| `PR-MiniThumbnail` | `MiniThumbnail=` | `mini` |
| `PR-Thumbnail` | `Thumbnail=` | `klein` |
| `PR-Image` | `Image=` | `normal` |
| `PR-LargeImage` | `LargeImage=` | `gross` |

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.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{PR-Thumbnail}
   <a href="~PR-Link~">
      <img src="~PR-Thumbnail~" alt="~PR-Name_StripHtml~">
   </a>
{/PR-Thumbnail}

{!PR-Thumbnail}
   <img src="/bilder/kein-bild.svg" alt="">
{/!PR-Thumbnail}
```

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.

## Der Link auf ein Produkt

`PR-Link()` erzeugt den Link auf ein Produkt. Ohne Argument ist das immer das Produkt, in dessen Zusammenhang das Tag steht.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{@PR-Data}
   <a href="~PR-Link~">~PR-Name~</a>
{/@PR-Data}
```

Mit Argument verlinken Sie auf ein bestimmtes anderes Produkt. Als Argument geben Sie einen Produktindex an, entweder fest oder aus einem freien Produktdatenfeld.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<a href="~PR-Link(1234)~">Zum Zubehör</a>

<a href="~PR-Link($PR-LinkToThisProdIndex$)~">Zum Zubehör</a>
```

> [!WARNING]
>
> Ü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.

## Weitere Links zum Produkt

| Tag | Führt zu |
| - | - |
| `PR-SetLink` | der aktuellen Setkombination des Produkts |
| `PR-SetLinkEnc` | derselben Adresse, URL-kodiert zur Übergabe als Parameter |
| `PR-ActionImagesUploadLink` | dem Formular, über das Käufer ein eigenes Produktbild hochladen |
| `PR-ActionImagesShowLink` | der Übersicht der hochgeladenen Bilder zu diesem Produkt |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{PR-Data}
   <a href="~PR-SetLink~">Diese Zusammenstellung teilen</a>
{/PR-Data}
```

`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](https://dokumentation.websale.de/v8s/interaktive-funktionen/productsinaction-modul.md)

## 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.

| Tag | Kodierte Fassung von |
| - | - |
| `PR-ProdIndexEnc` | `PR-ProdIndex` |
| `PR-VarIndexEnc` | `PR-VarIndex` |
| `PR-NumberEnc` | `PR-Number` |
| `PR-OrderInfoEnc` | `PR-OrderInfo` |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{PR-Number}
   <a href="/service?artikel=~PR-NumberEnc~">Frage zu diesem Artikel</a>
{/PR-Number}
```

> [!WARNING]
>
> 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.

| Tag | Liefert |
| - | - |
| `PR-SeoName` | den SEO-Produktnamen |
| `PR-SeoFreeField1` … `PR-SeoFreeField20` | den Inhalt der SEO-Produktfelder 1 bis 20 |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{PR-SeoName}
   <h1>~PR-SeoName~</h1>
{/PR-SeoName}

{!PR-SeoName}
   <h1>~PR-Name~</h1>
{/!PR-SeoName}
```

> [!WARNING]
>
> 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](https://dokumentation.websale.de/v8s/referenz/tags/e-pseo.md#die-tags-im-uberblick)

## PR-DeepLink gehört nicht auf ein Shoptemplate

`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:

| Tag | Liefert |
| - | - |
| `PR-DeepLink` | die vollständige Adresse des Produkts |
| `PR-DeepLinkPath` | dieselbe Adresse ohne Domain und ohne Parameter |
| `PR-CanonicalDeepLink` | die kanonische Adresse des Produkts |
| `PR-IsCanonicalDeepLink` | eine Klammerung, die greift, wenn beide Adressen übereinstimmen |

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.

> [!WARNING]
>
> 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](https://dokumentation.websale.de/v8s/schnittstellen/produkte-und-kategorien/ws-sftp-produkte-pro/produktdaten.md)

## 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.

> [!WARNING]
>
> 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.

| Tag | Vermutlicher Zweck |
| - | - |
| `PR-SEOPath` | der SEO-Pfad des Produkts |
| `PR-SEOCanonicalPath` | der kanonische SEO-Pfad des Produkts |

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

| Tag | Einzel-Tag | Bereichs-Tag | negatives Bereichs-Tag | Schleifen-Tag |
| - | - | - | - | - |
| `PR-MiniThumbnail` | ja | ja | ja | – |
| `PR-Thumbnail` | ja | ja | ja | – |
| `PR-Image` | ja | ja | ja | – |
| `PR-LargeImage` | ja | ja | ja | – |
| `PR-Link()` | ja | – | – | – |
| `PR-LinkWithoutCI()` | ja | – | – | – |
| `PR-SetLink` | ja | – | – | – |
| `PR-SetLinkEnc` | ja | – | – | – |
| `PR-ActionImagesUploadLink` | ja | – | – | – |
| `PR-ActionImagesShowLink` | ja | – | – | – |
| `PR-ProdIndexEnc` | ja | – | – | – |
| `PR-VarIndexEnc` | ja | – | – | – |
| `PR-NumberEnc` | ja | ja | ja | – |
| `PR-OrderInfoEnc` | ja | – | – | – |
| `PR-SeoName` | ja | ja | ja | – |
| `PR-SeoFreeField1` … `PR-SeoFreeField20` | ja | ja | ja | – |

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

* Referenz: [PR- (Grundlagen und Produktdaten)](https://dokumentation.websale.de/v8s/referenz/tags/pr/grundlagen-und-produktdaten.md)
* Referenz: [PR- (Variantenübersicht)](https://dokumentation.websale.de/v8s/referenz/tags/pr/bilder-und-links.md)
* Referenz: [PIA- (ProductsInAction)](https://dokumentation.websale.de/v8s/referenz/tags/pia-productsinaction.md)
* Wegweiser: Suchmaschinenoptimierung
* Wegweiser: Produktdaten-Export


## Related topics

- [PR- (Grundlagen und Produktdaten)](https://dokumentation.websale.de/v8s/referenz/tags/pr/grundlagen-und-produktdaten.md)
- [Bekleidungsmodul](https://dokumentation.websale.de/v8s/kategorien/bekleidungsmodul.md)
- [Bilder einer Kategorie](https://dokumentation.websale.de/v8s/kategorien/bilder-einer-kategorie.md)
- [ProductsInAction-Modul](https://dokumentation.websale.de/v8s/interaktive-funktionen/productsinaction-modul.md)
- [Inhalte anpassen in strapi](https://dokumentation.websale.de/strapi-cms/inhalte-anpassen-in-strapi.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.