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

# E-PIA_ (Bilddaten)

> Die Angaben zu einem einzelnen ProductsInAction-Bild: Bilddatei, Einsender, Datum, Kommentar und das Produkt dahinter. Diese Tags gelten in allen ProductsInAction-Templates gleich.

Jedes hochgeladene Kundenfoto bringt einen festen Satz an Angaben mit: die Bilddatei selbst, wer sie eingesendet hat, wann, mit welchem Kommentar und zu welchem Produkt. Die Tags dieser Seite geben genau diese Angaben aus.

Sie sind der gemeinsame Baukasten der drei ProductsInAction-Templates. In der Galerie stehen sie in der Schleife über alle Bilder, in der Detailansicht beim einzelnen Bild, in den Benachrichtigungsmails beim gerade hochgeladenen Bild. Die Schreibweise ist überall dieselbe.

Wegweiser: [ProductsInAction anbieten](https://dokumentation.websale.de/v8s/interaktive-funktionen/productsinaction-modul.md)

## Die Bilddatei

| Tag | Liefert |
| - | - |
| `E-PIA_Action-Thumbnail` | die vollständige Adresse des Vorschaubildes |
| `E-PIA_Action-Image` | die vollständige Adresse des Bildes in Normalgröße |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<a href="~WS-LoadTpl(ws_actionimage_picture.htm)~&techname=~E-PIA_Techname~">
   <img src="~E-PIA_Action-Thumbnail~" alt="">
</a>
```

Beide Tags liefern eine fertige Adresse, keinen bloßen Dateinamen. Sie gehören also direkt in das `src`-Attribut, ohne dass Sie im Template einen Pfad davorsetzen.

> [!WARNING]
>
> Das Vorschaubild gehört in die Galerie und in die Produktliste, das Normalbild in die Einzelansicht. Ein Thumbnail-Raster aus Normalbildern lädt die Seite unnötig langsam, denn der Shop skaliert beim Upload nur auf die konfigurierte Normalgröße herunter und nicht auf die Anzeigegröße im Raster.

## Der Einsender

| Tag | Liefert |
| - | - |
| `E-PIA_Username` | den Namen, den der Einsender beim Upload gewählt hat |
| `E-PIA_UserIndex` | die Kundennummer des Einsenders |
| `E-PIA_UserIP` | die IP-Adresse, von der aus hochgeladen wurde |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
Dieses Bild wurde von ~E-PIA_Username~ am ~E-PIA_CreateDate~ hochgeladen.
```

> [!WARNING]
>
> `E-PIA_UserIndex` und `E-PIA_UserIP` gehören in die Benachrichtigungsmail an den Shopbetreiber, nicht auf eine Seite im Shop. Beides sind personenbezogene Daten, die andere Besucher nichts angehen.

## Zeitpunkt und Kommentar

| Tag | Liefert |
| - | - |
| `E-PIA_CreateDate` | das Datum des Uploads im Format TT.MM.JJJJ |
| `E-PIA_CreateTime` | die Uhrzeit des Uploads im Format HH:MM:SS |
| `E-PIA_Comment` | den Kommentar, den der Einsender zum Bild geschrieben hat |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{E-PIA_Comment}
   <p class="bildkommentar">~E-PIA_Comment~</p>
{/E-PIA_Comment}

{!E-PIA_Comment}
   <p class="bildkommentar leer">Ohne Kommentar eingesendet.</p>
{/!E-PIA_Comment}
```

Der Kommentar ist freiwillig. `E-PIA_Comment` als Bereichs-Tag greift nur, wenn wirklich einer vorliegt, und hält sonst auch die Beschriftung davor aus der Seite heraus. Ohne diese Klammerung steht in der Galerie bei vielen Bildern ein leeres "Kommentar:".

## Datei und Produkt

| Tag | Liefert |
| - | - |
| `E-PIA_Techname` | die technische Kennung des Bildes |
| `E-PIA_FileName` | den ursprünglichen Dateinamen, den der Einsender hochgeladen hat |
| `E-PIA_FileSize` | die Dateigröße einschließlich Einheit |
| `E-PIA_PR-Name` | den Namen des Produktes auf dem Bild |
| `E-PIA_PR-Number` | die Produktnummer |
| `E-PIA_PR-ProdIndex` | den Produktindex |

`E-PIA_FileSize` wählt die Einheit selbst. Bis 50 KB gibt das Tag KB aus, darüber MB. Eine eigene Einheit im Template davorzuschreiben führt deshalb zu Angaben wie "0,12 MB KB".

> [!WARNING]
>
> `E-PIA_Techname` ist der Schlüssel, mit dem Sie ein einzelnes Bild ansprechen. Die Einzelansicht wird über den Parameter `techname` aufgerufen, die Galerie eines Produktes über den Parameter `pi` mit dem Produktindex. Wer beides verwechselt, landet immer auf der Produktgalerie statt beim gewünschten Bild.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<!-- ein einzelnes Bild groß anzeigen -->
<a href="~WS-LoadTpl(ws_actionimage_picture.htm)~&techname=~E-PIA_Techname~">Bild vergrößern</a>

<!-- alle Bilder zu diesem Produkt -->
<a href="~WS-LoadTpl(ws_actionimage_picture.htm)~&pi=~E-PIA_PR-ProdIndex~">Alle Fotos zu diesem Artikel</a>
```

## Die Tags im Überblick

| Tag | Einzel-Tag | Bereichs-Tag | negatives Bereichs-Tag | Schleifen-Tag |
| - | - | - | - | - |
| `E-PIA_Action-Image` | ja | – | – | – |
| `E-PIA_Action-Thumbnail` | ja | – | – | – |
| `E-PIA_Username` | ja | – | – | – |
| `E-PIA_UserIndex` | ja | – | – | – |
| `E-PIA_UserIP` | ja | – | – | – |
| `E-PIA_CreateDate` | ja | – | – | – |
| `E-PIA_CreateTime` | ja | – | – | – |
| `E-PIA_Comment` | ja | ja | ja | – |
| `E-PIA_Techname` | ja | – | – | – |
| `E-PIA_FileName` | ja | – | – | – |
| `E-PIA_FileSize` | ja | – | – | – |
| `E-PIA_PR-Name` | ja | – | – | – |
| `E-PIA_PR-Number` | ja | – | – | – |
| `E-PIA_PR-ProdIndex` | ja | – | – | – |

Zulässig sind alle Tags dieser Seite in den ProductsInAction-Templates für Galerie und Detailansicht sowie in den ProductsInAction-Mail-Templates. Im Galerie-Template stehen sie innerhalb der Schleife `{@E-PIA_DATA}`, in der Detailansicht innerhalb von `E-PIA_SHOW-SINGLE`.

Referenz: [E-PIA\_ (Galerie)](https://dokumentation.websale.de/v8s/referenz/tags/e-pia/galerie.md) · [E-PIA\_ (Einzelansicht und Bewertung)](https://dokumentation.websale.de/v8s/referenz/tags/e-pia/einzelansicht-und-bewertung.md)

Im Upload-Template sind diese Tags erst nach einem erfolgreichen Upload gefüllt, also innerhalb von `E-PIA_UPLOAD-SUCCESSFULL`. Davor gibt es noch kein Bild, auf das sie sich beziehen könnten.

## Verwandte Themen

* Wegweiser: ProductsInAction anbieten
* Referenz: [E-PIA\_ (Upload)](https://dokumentation.websale.de/v8s/referenz/tags/e-pia/upload.md)
* Referenz: [E-PIA\_ (Galerie)](https://dokumentation.websale.de/v8s/referenz/tags/e-pia/galerie.md)
* Referenz: [E-PIA\_ (Einzelansicht und Bewertung)](https://dokumentation.websale.de/v8s/referenz/tags/e-pia/einzelansicht-und-bewertung.md)


## Related topics

- [E-PIA_ (Galerie)](https://dokumentation.websale.de/v8s/referenz/tags/e-pia/galerie.md)
- [E-PIA_ (Upload)](https://dokumentation.websale.de/v8s/referenz/tags/e-pia/upload.md)
- [E-PIA_ (Einzelansicht und Bewertung)](https://dokumentation.websale.de/v8s/referenz/tags/e-pia/einzelansicht-und-bewertung.md)
- [ProductsInAction-Modul](https://dokumentation.websale.de/v8s/interaktive-funktionen/productsinaction-modul.md)
- [PIA- (ProductsInAction)](https://dokumentation.websale.de/v8s/referenz/tags/pia-productsinaction.md)


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