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.

Inhaltsverzeichnis

1 Modulübersicht
2 Templates
3 Variablen
- 3.1 $wsStores.selectedStore
4 Methoden
- 4.1 $wsStores.loadAllStores()
- 4.2 $wsStores.loadStore()
5 Aktionen
6 Beispiele
- 6.1 Alle Märkte auflisten
- 6.2 Markt auswählen (Session)
- 6.3 Öffnungszeiten anzeigen
- 6.4 Click & Collect im Checkout
- 6.5 Lagerbestand im Markt prüfen
7 Weiterführende Links

Modulübersicht

Beispiel / Ausschnitt über $wsStores

{{= $wsStores | json }}

JSON-Ausgabe

{
  "selectedStore": null,
  "loadAllStores": "ƒ()",
  "loadStore": "ƒ()"
}

Anmerkung: "ƒ()" kennzeichnet eine Funktion.

Variablen und Methoden in der Übersicht

Name	Rückgabe-Typ	Beschreibung

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.

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

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

{{ var $store = $wsStores.loadStore(1) }}
Marktname: {{= $store.name }}

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

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.

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:

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

Markt auswählen (Session)

Beispiel, das eine Marktauswahl mit der Action SelectStore implementiert:

{{ var $action = $wsActions.create("SelectStore") }}

{{ if $action.success }}
  <div class="alert success">Markt erfolgreich geändert.</div>
{{ /if }}

<form method="post" action="{{= $wsViews.current.url() }}">
  <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() }}">
  
  {{ foreach $store in $wsStores.loadAllStores() }}
    <label>
      <input type="radio" name="storeId" value="{{= $store.id }}"
        {{ if $wsStores.selectedStore and $store.id == $wsStores.selectedStore.id }}checked{{ /if }}>
      {{= $store.name }}
      {{ if $store.openNow }}<span class="open">Jetzt geöffnet</span>{{ /if }}
    </label>
  {{ /foreach }}
  
  <button type="submit">Markt auswählen</button>
</form>

Öffnungszeiten anzeigen

Beispiel, das die Öffnungszeiten eines Marktes formatiert ausgibt:

{{ var $days = [
  {"id": "1", "name": "Montag"},
  {"id": "2", "name": "Dienstag"},
  {"id": "3", "name": "Mittwoch"},
  {"id": "4", "name": "Donnerstag"},
  {"id": "5", "name": "Freitag"},
  {"id": "6", "name": "Samstag"},
  {"id": "0", "name": "Sonntag"}
] }}

{{ foreach $day in $days }}
  <div>
    <strong>{{= $day.name }}:</strong>
    {{ var $slots = $store.openingHours[$day.id] }}
    {{ if $slots | len > 0 }}
      {{ foreach $slot in $slots }}
        {{= $slot.startTime.hours }}:{{= $slot.startTime.minutes | pad(2, "0") }} - 
        {{= $slot.endTime.hours }}:{{= $slot.endTime.minutes | pad(2, "0") }}
      {{ /foreach }}
    {{ else }}
      Geschlossen
    {{ /if }}
  </div>
{{ /foreach }}

Click & Collect im Checkout

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

{{ 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 }}
            {{= $error.text | default($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:

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

$wsStores