> ## 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_ (Image data)

> The details of a single ProductsInAction image: image file, submitter, date, comment and the product behind it. These tags work the same in all ProductsInAction templates.

Every uploaded customer photo comes with a fixed set of details: the image file itself, who submitted it, when, with which comment and for which product. The tags on this page output exactly these details.

They are the shared toolkit of the three ProductsInAction templates. In the gallery, they are used in the loop over all images; in the detail view, for the single image; in the notification emails, for the image just uploaded. The notation is the same everywhere.

Guide: Offering ProductsInAction

## The image file

| Tag | Returns |
| - | - |
| `E-PIA_Action-Thumbnail` | the complete address of the preview image |
| `E-PIA_Action-Image` | the complete address of the normal-size image |

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

> [!NOTE]
>
> Both tags return a complete address, not just a file name. They therefore go directly into the `src` attribute without you having to prepend a path in the template.

> [!WARNING]
>
> The preview image belongs in the gallery and the product list, the normal image in the single view. A thumbnail grid made of normal images makes the page load unnecessarily slowly, because during upload the shop only scales down to the configured normal size, not to the display size in the grid.

## The submitter

| Tag | Returns |
| - | - |
| `E-PIA_Username` | the name the submitter chose during upload |
| `E-PIA_UserIndex` | the submitter's customer number |
| `E-PIA_UserIP` | the IP address from which the image was uploaded |

```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` and `E-PIA_UserIP` belong in the notification email to the shop operator, not on a page in the shop. Both are personal data that are none of other visitors' business.

## Time and comment

| Tag | Returns |
| - | - |
| `E-PIA_CreateDate` | the upload date in the format DD.MM.YYYY |
| `E-PIA_CreateTime` | the upload time in the format HH:MM:SS |
| `E-PIA_Comment` | the comment the submitter wrote about the image |

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

> [!NOTE]
>
> The comment is optional. As a range tag, `E-PIA_Comment` only applies if a comment actually exists, and otherwise also keeps the label in front of it off the page. Without this range, many images in the gallery show an empty "Comment:".

## File and product

| Tag | Returns |
| - | - |
| `E-PIA_Techname` | the technical identifier of the image |
| `E-PIA_FileName` | the original file name the submitter uploaded |
| `E-PIA_FileSize` | the file size including unit |
| `E-PIA_PR-Name` | the name of the product in the image |
| `E-PIA_PR-Number` | the product number |
| `E-PIA_PR-ProdIndex` | the product index |

> [!NOTE]
>
> `E-PIA_FileSize` chooses the unit itself. Up to 50 KB, the tag outputs KB, above that MB. Writing your own unit in the template therefore leads to output such as "0,12 MB KB".

> [!WARNING]
>
> `E-PIA_Techname` is the key you use to address a single image. The single view is called with the `techname` parameter, a product's gallery with the `pi` parameter and the product index. If you mix the two up, you always end up in the product gallery instead of at the desired image.

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

## The tags at a glance

| Tag | Single tag | Range tag | Negative range tag | Loop tag |
| - | - | - | - | - |
| `E-PIA_Action-Image` | yes | – | – | – |
| `E-PIA_Action-Thumbnail` | yes | – | – | – |
| `E-PIA_Username` | yes | – | – | – |
| `E-PIA_UserIndex` | yes | – | – | – |
| `E-PIA_UserIP` | yes | – | – | – |
| `E-PIA_CreateDate` | yes | – | – | – |
| `E-PIA_CreateTime` | yes | – | – | – |
| `E-PIA_Comment` | yes | yes | yes | – |
| `E-PIA_Techname` | yes | – | – | – |
| `E-PIA_FileName` | yes | – | – | – |
| `E-PIA_FileSize` | yes | – | – | – |
| `E-PIA_PR-Name` | yes | – | – | – |
| `E-PIA_PR-Number` | yes | – | – | – |
| `E-PIA_PR-ProdIndex` | yes | – | – | – |

All tags on this page are permitted in the ProductsInAction templates for the gallery and detail view, as well as in the ProductsInAction email templates. In the gallery template, they are used within the `{@E-PIA_DATA}` loop; in the detail view, within `E-PIA_SHOW-SINGLE`.

Reference: E-PIA\_ (Gallery) · Reference: E-PIA\_ (Single view and rating)

> [!NOTE]
>
> In the upload template, these tags are only filled after a successful upload, i.e. within `E-PIA_UPLOAD-SUCCESSFULL`. Before that, there is no image yet that they could refer to.

## Related topics

* Guide: Offering ProductsInAction
* Reference: E-PIA\_ (Upload)
* Reference: E-PIA\_ (Gallery)
* Reference: E-PIA\_ (Single view and rating)


## Related topics

- [E-PIA_ (Gallery)](https://dokumentation.websale.de/en/v8s/referenz/tags/e-pia/galerie.md)
- [E-PIA_ (Upload)](https://dokumentation.websale.de/en/v8s/referenz/tags/e-pia/upload.md)
- [E-PIA_ (Single view and rating)](https://dokumentation.websale.de/en/v8s/referenz/tags/e-pia/einzelansicht-und-bewertung.md)
- [PIA- (ProductsInAction)](https://dokumentation.websale.de/en/v8s/referenz/tags/pia-productsinaction.md)
- [PR- (Images and links)](https://dokumentation.websale.de/en/v8s/referenz/tags/pr/bilder-und-links.md)


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