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

# $wsSubshop - Subshop

Mit dem `$wsSubshop` Modul können Sie auf Subshop-Daten zugreifen. Typische Anwendungsfälle sind Sprachumschalter oder Links zwischen verschiedenen Länder- und Sprachversionen des Shops. In diesem Abschnitt erfahren Sie, wie Sie Subshop-Informationen auslesen und zwischen Subshops verlinken können.

***

## Modulübersicht

**Beispiel / Ausschnitt über** `$wsSubshop`

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{{= $wsSubshop | json }}
```

**JSON-Ausgabe**

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
  "currentTime": "2026-06-26T09:18:59.000Z",
  "id": "deutsch",
  "language": {
    "isoCode": "DE",
    "name": "Deutsch"
  },
  "subshopUrl": "ƒ()",
  "subshops": ["deutsch"],
  "timeZone": "Europe/Berlin"
}
```

Anmerkung: `ƒ()` kennzeichnet eine Funktion.

**Variablen und Methoden in der Übersicht**

| **Name**       | **Typ** | **Beschreibung**                                             |
| -------------- | ------- | ------------------------------------------------------------ |
| `id`           | string  | ID des aktuellen Subshops.                                   |
| `currentTime`  | string  | Aktueller Zeitstempel im ISO-8601-Format.                    |
| `timeZone`     | string  | Im Shop konfigurierte Zeitzone (z. B. `"Europe/Berlin"`).    |
| `language`     | map     | Map mit Sprachinformationen des Subshops.                    |
| `isoCode`      | string  | ISO-Sprachcode (z.B. `“DE”`, `“EN”`).                        |
| `name`         | string  | Name der Sprache (z.B. `“Deutsch”`, `“Englisch”`).           |
| `subshops`     | array   | Liste aller verfügbaren Subshop-IDs.                         |
| `subshopUrl()` | string  | Gibt die URL zur Startseite des angegebenen Subshops zurück. |

***

## Templates

Subshop-Daten werden typischerweise an folgenden Stellen eingesetzt:

* Header: Sprachumschalter zwischen verschiedenen Subshops.
* Footer: Links zu anderen Länder-/Sprachversionen des Shops.
* Inhalte: Länderspezifische Hinweise oder Anpassungen.

***

## Variablen

### \$wsSubshop.id

Gibt die ID des aktuellen Subshops aus.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
Aktueller Subshop: {{= $wsSubshop.id }}
```

### \$wsSubshop.currentTime

Gibt den aktuellen Zeitstempel im ISO-8601-Format aus (z. B. `2026-06-26T09:18:59.000Z`). Diesen Wert formatieren Sie mit der globalen Funktion [`dateFmt()`](/frontend/referenz/funktionen#datefmt) in ein lesbares Datum oder eine Uhrzeit.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{{= $wsSubshop.currentTime | dateFmt("%Y") }}
```

Damit geben Sie z. B. die aktuelle Jahreszahl aus, etwa für eine Copyright-Angabe im Footer.

### \$wsSubshop.timeZone

Gibt die im Shop konfigurierte Zeitzone aus (z. B. `Europe/Berlin`). Dies ist die Zeitzone, die [`dateFmt()`](/frontend/referenz/funktionen#datefmt) verwendet, wenn beim Formatieren keine eigene Zeitzone angegeben wird.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
Zeitzone des Shops: {{= $wsSubshop.timeZone }}
```

### \$wsSubshop.language

Gibt eine Map mit Sprachinformationen des aktuellen Subshops aus.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
Sprache: {{= $wsSubshop.language.name }} ({{= $wsSubshop.language.isoCode }})
```

#### \$wsSubshop.language.isoCode

Gibt den ISO-Sprachcode des aktuellen Subshops aus.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
ISO-Code: {{= $wsSubshop.language.isoCode }}
```

#### \$wsSubshop.language.name

Gibt den Namen der Sprache des aktuellen Subshops aus.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
Aktuelle Sprache: {{= $wsSubshop.language.name }}
```

### \$wsSubshop.subshops

Gibt eine Liste aller verfügbaren Subshop-IDs aus. Nützlich für die Erstellung eines Sprachumschalters oder einer Länderauswahl.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{{ foreach $myShopId in $wsSubshop.subshops }}
  {{= $myShopId }}
{{ /foreach }}
```

***

## Methoden

### \$wsSubshop.subshopUrl()

Gibt die URL zur Startseite des angegebenen Subshops zurück. Die URL berücksichtigt automatisch die korrekte Domain und den Pfad des Ziel-Subshops.

**Signatur**\
`$wsSubshop.subshopUrl(subshopId)`

**Rückgabe**\
`string` - URL des angegebenen Subshops.

**Parameter**

| **Name**    | **Typ** | **Pflicht** | **Beschreibung**      |
| ----------- | ------- | ----------- | --------------------- |
| `subshopId` | string  | ja          | ID des Ziel-Subshops. |

**Beispiel,** das die URL eines Subshops ausgibt.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
URL: {{= $wsSubshop.subshopUrl('english') }}
```

***

## Aktionen

Für `$wsSubshop` stehen keine Aktionen zur Verfügung.

***

## Beispiele

### HTML-Lang-Attribut setzen

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<html lang="{{= $wsSubshop.language.isoCode | lower }}">
```

### Aktuelle Sprache anzeigen

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<p>Sie befinden sich im Shop: {{= $wsSubshop.language.name }}</p>
```

### Aktuelle Jahreszahl im Footer ausgeben

Kombiniert `currentTime` mit `dateFmt`, um z. B. eine Copyright-Zeile immer aktuell zu halten.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<p>© {{= $wsSubshop.currentTime | dateFmt("%Y") }} Mein Onlineshop</p>
```

**Ergebnis**

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
© 2026 Mein Onlineshop
```

***

# Weiterführende Links

* [general - Allgemeine Shopeinstellungen](/konfiguration/general-allgemeine-shopeinstellungen)
* [Funktionen](/frontend/referenz/funktionen) - globale Funktionen wie `dateFmt`, `isoToUnix` und `unixToIso` zum Verarbeiten von Zeitstempeln.