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

# Freie Parameter-Tags verwenden

> Eigene Werte an den Shop-Aufruf anhängen, im Template ausgeben und Bereiche davon abhängig anzeigen, mit drei Varianten für Gültigkeitsdauer und Suchmaschinen.

Freie Parameter-Tags transportieren eigene Werte durch den Shop. Sie hängen den Wert an einen Shop-Aufruf an, und im Template lässt er sich ausgeben oder als Bedingung für einen Bereich verwenden.

Ein typischer Fall ist die Umschaltung zwischen Listen- und Kachelansicht auf der Kategorieseite. Zwei Links setzen je einen Wert, das Template fragt beide ab und zeigt die passende Darstellung.

Diese Tags tragen den Präfix `WS-` und gehören in URLs, Links und Formulare. Davon zu unterscheiden sind die DesignControl-Tags `DC-FP1` bis `DC-FP3`, die nur innerhalb eines Templates leben und nicht über den Seitenaufruf transportiert werden.

Referenz: [DC-FPX](https://dokumentation.websale.de/v8s/referenz/tags/dc/parameter.md#die-tags-im-uberblick)

## Die drei Arten im Vergleich

Es gibt drei Familien mit je drei Tags. Sie unterscheiden sich darin, wie lange ein Wert gilt und ob er in den Canonical-Link für Suchmaschinen aufgenommen wird.

| Art | Tags | Gültigkeit | Im Canonical-Link |
| - | - | - | - |
| OneTime-Parameter | `WS-OTP1` bis `WS-OTP3` | nur auf der Folgeseite, die mit dem Tag aufgerufen wird | nein |
| Design-Parameter | `WS-DP1` bis `WS-DP3` | auf allen Folgeseiten, bis überschrieben oder zurückgesetzt | nein |
| Free-Parameter | `WS-FP1` bis `WS-FP3` | auf allen Folgeseiten, bis überschrieben oder zurückgesetzt | ja |

Der Unterschied zwischen Design- und Free-Parameter liegt allein im Canonical-Link. Nehmen Sie einen Free-Parameter, wenn die Variante eine eigene Adresse in Suchmaschinen verdient, und einen Design-Parameter, wenn sie das nicht soll. Eine Umschaltung zwischen Listen- und Kachelansicht ist ein Fall für den Design-Parameter, weil beide Ansichten denselben Inhalt zeigen.

Wegweiser: Canonical-Anweisung im Head erzeugen

Referenz: WS-OTP1…3() · WS-DP1…3() · WS-FP1…3()

## Einen Wert übergeben

Hängen Sie den Parameter an einen beliebigen Shop-Aufruf an. In der URL steht dabei nur der technische Name in Kleinbuchstaben, nicht die Tag-Schreibweise mit Tilden.

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
https://www.ihr-shop.de/?fp1=abc
```

> [!WARNING]
>
> Der technische Name lautet `fp1`, `dp2`, `otp3` und so weiter. Ein Aufruf mit `?WS-FP1=abc` oder `?~WS-FP1~=abc` bewirkt nichts.

## Einen Wert ausgeben

An der Stelle, an der das Tag im Template steht, erscheint der übergebene Wert.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
~WS-FP1~
```

## Bereiche abhängig vom Wert anzeigen

Ohne Argument greift die Klammerung, sobald der Parameter überhaupt einen Wert hat.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{WS-FP1}
   Dieser Bereich erscheint, sobald fp1 irgendeinen Wert trägt.
{/WS-FP1}
```

Mit Argument greift sie nur bei genau diesem Wert.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{WS-FP1(abc)}
   Dieser Bereich erscheint nur, wenn fp1 den Wert abc hat.
{/WS-FP1(abc)}

{WS-FP3(12345)}
   Dieser Bereich erscheint nur, wenn fp3 den Wert 12345 hat.
{/WS-FP3(12345)}
```

So entsteht die Umschaltung zwischen zwei Ansichten: Sie fragen zwei Werte desselben Parameters ab und hinterlegen in jeder Klammerung die eine beziehungsweise die andere Darstellung. Denken Sie daran, auch den Fall abzudecken, dass noch kein Wert gesetzt ist, sonst sieht ein Besucher beim ersten Aufruf gar keine Liste.

## Einen Wert zurücksetzen

Design- und Free-Parameter bleiben über Folgeseiten hinweg bestehen. Zum Zurücksetzen hängen Sie den technischen Namen ohne Wert oder mit dem Wert `$unused` an den Aufruf.

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
https://www.ihr-shop.de/?fp1=
https://www.ihr-shop.de/?fp1=$unused
```

OneTime-Parameter brauchen das nicht. Sie gelten ohnehin nur für den einen Aufruf, mit dem sie übergeben wurden.

## Verwandte Themen

* Wegweiser: [Zähler und Vergleiche im Template](https://dokumentation.websale.de/v8s/fortgeschrittene-designtechniken/zaehler-und-vergleiche-im-template.md)
* Wegweiser: Canonical-Anweisung im Head erzeugen
* Materialien: [URL-Parameter](https://dokumentation.websale.de/v8s/domains/grundlagen-domains-und-shop-aufruf.md#url-parameter)


## Related topics

- [URL-Parameter](https://dokumentation.websale.de/v8s/referenz/url-parameter.md)
- [Zähler und Vergleiche im Template](https://dokumentation.websale.de/v8s/fortgeschrittene-designtechniken/zaehler-und-vergleiche-im-template.md)
- [DC- (Vergleiche und weitere Tags)](https://dokumentation.websale.de/v8s/referenz/tags/dc/vergleiche.md)
- [DC- (Freie Parameter und Session-Parameter)](https://dokumentation.websale.de/v8s/referenz/tags/dc/parameter.md)
- [FMSG- (Freie Vorgabetexte)](https://dokumentation.websale.de/v8s/referenz/tags/fmsg-freie-vorgabetexte.md)


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