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

# $wsStores - Märkte & Filialen

> Modul $wsStores: konfigurierte Märkte und Filialen laden, ausgewählten Markt verwalten und Öffnungszeiten für Click & Collect anzeigen.

Mit dem `$wsStores` Modul können Sie auf die konfigurierten Märkte und Filialen des Shops zugreifen. Typische Anwendungsfälle sind Click & Collect, Filialfinder und die Anzeige von Lagerbeständen im Markt. In diesem Abschnitt erfahren Sie, wie Sie Märkte laden, den ausgewählten Markt verwalten und Öffnungszeiten anzeigen können.

***

## Modulübersicht

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

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

**JSON-Ausgabe**

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{
  "selectedStore": null,
  "loadAllStores": "ƒ()",
  "loadStore": "ƒ()"
}
```

Anmerkung: `ƒ()` kennzeichnet eine Funktion.

**Variablen und Methoden in der Übersicht**

| **Name**          | **Rückgabe-Typ** | **Beschreibung**                                                    |
| ----------------- | ---------------- | ------------------------------------------------------------------- |
| `selectedStore`   | map              | Aktuell ausgewählter Markt oder `null`, wenn keiner ausgewählt ist. |
| `loadAllStores()` | array            | Lädt eine Liste aller verfügbaren Märkte.                           |
| `loadStore()`     | map              | Lädt einen einzelnen Markt anhand seiner ID.                        |

***

## Templates

Das \$wsStores Modul wird typischerweise verwendet auf:

* Marktsuche-Seiten (Filialfinder)
* Produktdetailseiten (Verfügbarkeit im Markt)
* Checkout-Seiten (Click & Collect Auswahl)
* Header/Footer (ausgewählter Markt anzeigen)

***

### Variablen

### \$wsStores.selectedStore

Gibt den aktuell in der Session ausgewählten Markt aus. Ist `null`, wenn kein Markt ausgewählt wurde.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{{ if $wsStores.selectedStore }}
  Ihr Markt: {{= $wsStores.selectedStore.name }}
{{ else }}
  Kein Markt ausgewählt
{{ /if }}
```

***

## Methoden

### \$wsStores.loadAllStores()

Lädt eine Liste aller verfügbaren Märkte.

**Signatur**\
`$wsStores.loadAllStores()`

**Rückgabe**\
`array` - Liste mit Store-Maps.

**Beispiel,** das alle Märkte lädt und anzeigt.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{{ foreach $store in $wsStores.loadAllStores() }}
  <p>{{= $store.name }} – {{= $store.city }}</p>
{{ /foreach }}
```

## \$wsStores.loadStore()

Lädt einen einzelnen Markt anhand seiner ID.

**Signatur**\
`$wsStores.loadStore(storeId)`

**Rückgabe**\
`map` - Store-Map mit allen Marktdaten.

**Beispiel,** das einen Markt lädt.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{{ var $store = $wsStores.loadStore(1) }}
Marktname: {{= $store.name }}
```

<Info>
  Mit Verwendung der Rückgabe-Daten von `$wsStores.loadStore` stehen verschiedene Eigenschaften zur Verfügung, die verwendet werden können. Nachfolgend eine Übersicht, welche Eigenschaften verfügbar sind.

  Eigenschaften von `$wsStores.loadStore`

  | **Eigenschaften** | **Rückgabe-Typ** | **Beschreibung**                                                                                                       |
  | ----------------- | ---------------- | ---------------------------------------------------------------------------------------------------------------------- |
  | `id`              | int              | Eindeutige ID des Marktes.                                                                                             |
  | `name`            | string           | Name des Marktes.                                                                                                      |
  | `street`          | string           | Straße (ggf. mit Hausnummer).                                                                                          |
  | `zipCode`         | string           | Postleitzahl.                                                                                                          |
  | `city`            | string           | Stadt.                                                                                                                 |
  | `country`         | string           | Land.                                                                                                                  |
  | `storageId`       | string           | ID des Markt-Lagers zur Abfrage des Lagerbestands über `$wsInventory.load()`.                                          |
  | `clickAndCollect` | bool             | Verfügbarkeit von Click & Collect.                                                                                     |
  | `openNow`         | bool             | Prüfung, ob der Markt aktuell geöffnet ist.                                                                            |
  | `location`        | map              | GPS-Koordinaten (`latitude, longitude`)                                                                                |
  | `latitude`        | float            | Breitengrad.                                                                                                           |
  | `longitude`       | float            | Längengrad.                                                                                                            |
  | `openingHours`    | map              | Öffnungszeiten nach Wochentag (0-6).                                                                                   |
  | `0-6`             | array            | Öffnungszeiten pro Wochentag (0=Sonntag, 1=Montag, … , 6=Samstag).                                                     |
  | `specialDays`     | array            | Tage mit abweichenden Öffnungszeiten (z.B. Feiertage).                                                                 |
  | `month`           | int              | Monat (1-12).                                                                                                          |
  | `day`             | int              | Tag (1-31).                                                                                                            |
  | `times`           | array            | Öffnungszeiten für diesen Tag.                                                                                         |
  | `startTime`       | map              | Startzeit mit `hours` und `minutes`.                                                                                   |
  | `endTime`         | map              | Endzeit mit `hours` und `minutes`.                                                                                     |
  | `zipPrefix`       | array            | Postleitzahl-Präfixe, die diesem Markt zugeordnet sind (für automatische Marktvorschläge basierend auf Kundenadresse). |
  | `allowedSubshop`  | array            | Liste der Subshop-IDs, in denen dieser Markt verfügbar ist.                                                            |
</Info>

***

## Aktionen

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

***

## Beispiele

### Alle Märkte auflisten

Beispiel, das alle Märkte mit Adresse und Öffnungsstatus anzeigt:

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{{ foreach $store in $wsStores.loadAllStores() }}
  <div class="store">
    <h3>{{= $store.name }}</h3>
    <p>{{= $store.street }}, {{= $store.zipCode }} {{= $store.city }}</p>
    {{ if $store.openNow }}
      <span class="open">Jetzt geöffnet</span>
    {{ else }}
      <span class="closed">Geschlossen</span>
    {{ /if }}
  </div>
{{ /foreach }}
```

### Filialauswahl als Dropdown darstellen

Beispiel, das eine Filialauswahl als Dropdown zur Verfügung stellt:

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{{ var $action = $wsActions.create("SelectStore") }}
<form method="post" action="{{= $wsViews.current.url() }}" data-ws-ajax-form data-auto-submit-change>
    <input type="hidden" name="wsact"    value="{{= $action.id }}">
    <input type="hidden" name="wscsrf"   value="{{= $action.csrf }}">
    <input type="hidden" name="wstarget" value="{{= $wsViews.current.url() }}">

    <label for="wsStorefinderSelect">Mein Markt</label>
    <select id="wsStorefinderSelect" name="storeId" aria-label="Markt auswählen" onchange="this.blur()">
        {{ foreach $store in $wsStores.loadAllStores() }}
            <option value="{{= $store.id }}"
                {{ if $wsStores.selectedStore and $store.id == $wsStores.selectedStore.id }}selected{{ /if }}>
                {{= $store.name }} - {{= $store.city }}
            </option>
        {{ /foreach }}
    </select>

    <button type="submit">Markt auswählen</button>
</form>
```

### Click & Collect im Checkout

Beispiel, das nur Märkte mit Click & Collect für Abholung anzeigt:

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{{ foreach $method in $wsConfig.shippingMethods }}
  {{ if $wsCheckout.selectedShippingMethod == $method.id and $method.type == "pickup" }}
    
    {{ var $storeAction = $wsActions.create("CheckoutStoreIdSelect") }}
    
    <form method="post" action="{{= $wsViews.current.url() }}">
      <input type="hidden" name="wsact" value="{{= $storeAction.id }}">
      <input type="hidden" name="wscsrf" value="{{= $storeAction.csrf }}">
      
      <label>Abholmarkt auswählen:</label>
      <select name="storeId">
        {{ foreach $store in $wsStores.loadAllStores() }}
          {{ if $store.clickAndCollect }}
            <option value="{{= $store.id }}"
              {{ if $wsCheckout.selectedStoreId == $store.id }}selected{{ /if }}>
              {{= $store.name }} – {{= $store.city }}
            </option>
          {{ /if }}
        {{ /foreach }}
      </select>
      
      <button type="submit">Markt auswählen</button>
    </form>
    
    {{ if $storeAction.error }}
      {{ foreach $error in $storeAction.errors }}
        <div class="alert danger">
          {{ if $error.code == "reservationFailed" }}
            Produkt nicht verfügbar in diesem Markt: {{= $error.details.productId }}
          {{ else }}
            {{= ifnull($error.text, $error.code) }}
          {{ /if }}
        </div>
      {{ /foreach }}
    {{ /if }}
    
  {{ /if }}
{{ /foreach }}
```

### Lagerbestand im Markt prüfen

Beispiel, das den Lagerbestand eines Produkts in einem bestimmten Markt prüft:

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{{ var $store = $wsStores.selectedStore }}
{{ if $store }}
  {{ var $inventory = $wsInventory.load($product.id, $store.storageId) }}
  {{ if $inventory.active }}
    <p>Verfügbar in {{= $store.name }}: {{= $inventory.amount }} Stück</p>
  {{ else }}
    <p>Nicht verfügbar in {{= $store.name }}</p>
  {{ /if }}
{{ /if }}
```

***

## Weiterführende Links

* [\$wsInventory](/frontend/referenz/module/wsinventory)
* [API-Referenz Stores](/schnittstellen/admin-interface-api/api-referenz-stores)