$wsViews - Aktuelle Informationen abrufen

Mit dem $wsViews Modul können Sie auf Informationen zur aktuellen Seite zugreifen und URLs zu anderen Shop-Seiten generieren. Typische Anwendungsfälle sind SEO-Optimierung (Meta-Tags, hreflang), Navigation und bedingte Inhalte basierend auf dem aktuellen Template. In diesem Abschnitt erfahren Sie, wie Sie auf Seitendaten zugreifen und SEO-freundliche URLs erzeugen können.

---

Modulübersicht

Beispiel / Ausschnitt über $wsViews

{{= $wsViews | json }}

JSON-Ausgabe

{
  "current": {
    "closedShopRedirected": false,
    "ctrlName": "...",
    "info": { },
    "name": "...",
    "paramList": [...],
    "params": { },
    "robotOptions": [...],
    "status": 200,
    "getHreflangAutomatic": "ƒ()",
    "url": "ƒ()"
  },
  "host": "...",
  "getHreflangManual": "ƒ()",
  "identifyUrl": "ƒ()",
  "metaDescription": "ƒ()",
  "metaTitle": "ƒ()",
  "setChildUrl": "ƒ()",
  "url": "ƒ()",
  "viewUrl": "ƒ()"
}

Anmerkung: ƒ() kennzeichnet eine Funktion.

Variablen und Methoden in der Übersicht

Name	Rückgabe-Typ	Beschreibung
current	map	Informationen zur aktuellen Seite.
closedShopRedirected	bool	Prüft, ob eine Weiterleitung von einem geschlossenen Shop erfolgt ist.
ctrlName	string	Name des View-Controllers.
getHreflangAutomatic	function	Gibt die Werte der hreflang Tags der aktuellen Seite aus.
info	map	Zusätzliche Infos vom Controller (z.B. Kategorie, Produkt).
name	string	Name der View-Datei (z.B. "start.htm").
paramList	array	Liste der URL-Parameter mit name und value.
name	string	Name des Parameters.
value	string	Value des Parameters.
params	map	URL-Parameter als Map ({name: value}).
robotOptions	map	Robots-Einstellungen der Seite.
status	number	HTTP-Status-Code (z.B. 200).
host	string	Gibt die URL der Startseite aus.
metaDescription	string	Meta-Description der aktuellen Seite, Seiten-Beschreibung.
metaTitle	string	Meta Title der aktuellen Seite; Seiten-Titel.
url	string	Gibt die aktuell aufgerufene URL aus.
viewUrl	string	Bildet eine URL zu einer View mithilfe der Angabe eines View-Controllers und seiner Parameter.
current.url()	string	Erzeugt eine SEO-freundliche URL zu einer Shop-Seite.
url()	string	Bildet einen Link zu einer Shop-Seite.
viewUrl()	string	Erzeugt eine URL zu einer Template-Datei.
metaTitle()	string	Gibt den Seitentitel für den Browser-Tab und Suchergebnisse aus.
metaDescription()	string	Gibt die Seitenbeschreibung für Suchergebnisse aus.
getHreflangManual()	array	Gibt manuell konfigurierte hreflang-Einträge aus.
current.getHreflangAutomatic()	array	Gibt die Sprachversionen der aktuellen Seite für hreflang-Tags aus.

---

Variablen

$wsViews.current

Enthält alle Informationen zur aktuell angezeigten Seite.

{{= $wsViews.current | json }}

$wsViews.current.ctrlName

Gibt den Namen des View-Controllers aus, der die aktuelle Seite liefert.

View-Controller: {{= $wsViews.current.ctrlName }}

$wsViews.current.closedShopRedirected

Gibt aus, ob der Nutzer von einem geschlossenen Shop weitergeleitet wurde.

{{ if $wsViews.current.closedShopRedirected }}
  // Von geschlossenem Shop weitergeleitet
{{ /if }}

$wsViews.current.info

Gibt kontextspezifische Daten aus, z.B. das aktuelle Produkt auf Produktseiten (info.product) oder die Kategorie auf Kategorieseiten (info.category).

Zusätzliche Informationen: {{= $wsViews.current.info}}

$wsViews.current.name

Gibt den Namen der aktuellen View aus.

{{ if $wsViews.current.name == "category.htm" }}
    // Kategorie-Seite
{{ /if }}

$wsViews.current.paramList

Gibt eine Liste der URL-Parameter aus. Jeder Eintrag enthält name und value.

{{ foreach $myParam in $wsViews.current.paramList }}
  {{= $myParam.name }}: {{= $myParam.value }}
{{ /foreach }}

$wsViews.current.params

Gibt die URL-Parameter als Map aus.

{{ if $wsViews.current.params.promoCode }}
  Promo-Code: {{= $wsViews.current.params.promoCode }}
{{ /if }}

$wsViews.current.robotOptions

Gibt die Robots-Einstellungen der Seite aus.

Robots: {{= $wsViews.current.robotOptions | json }}

$wsViews.current.status

Gibt den HTTP-Status-Code der Seite aus.

Status: {{= $wsViews.current.status }}

$wsViews.host

Gibt die URL der Shop-Startseite aus.

Shop-Startseite: {{= $wsViews.host }}

---

Methoden

$wsViews.current.url()

Erzeugt eine SEO-freundliche URL zu einer Shop-Seite. Die URL wird automatisch mit sprechenden Pfaden generiert (z.B. /produkte/beispiel-produkt statt ?productId=123).

Signatur
$wsViews.current.url()

Rückgabe
string - Aktuelle URL / Pfad.

Beispiel, das die aktuelle URL ausgibt.

Aktuelle URL: {{= $wsViews.current.url() }}

$wsViews.url()

Bildet einen Link zu einer Shop-Seite (z.B. Produktseite, Kategorieseite). Die URL wird automatisch im SEO-freundlichen Format erzeugt.

Signatur
string $wsViews.url(viewCtrl, params)

Rückgabe
string - URL/Pfad zur gewünschten Seite..

Parameter

Name	Typ	Pflicht	Beschreibung
viewCtrl	string	ja	Ziel-Controller/Seitentyp (z.B. Product, Category)
params	map	ja	Parameter zum Ergänzen/Überschreiben der URL; der Wert null entfernt einen Parameter.

Beispiel
Beispiel, das eine URL zu einer Produktseite erzeugt.

{{= $wsViews.url('Product', {productId: $cProduct.product.id}) }}

Rückgabe-Beispiel:

/produkte/beispiel-produkt-12345

$wsViews.viewUrl()

Erzeugt eine URL zu einer Template-Datei.

Signatur

string wsViews.viewUrl(path, params, type)

Rückgabe
string - URL zur angegebenen View.

Parameter

Name	Typ	Pflicht	Beschreibung
path	string	ja	Pfad zur Template-Datei, z.B. account/forgotPassword.htm.
params	map	nein	Zusätzliche Parameter für die URL.
type	string	nein	URL-Typ (z.B. "absolute").

Beispiel, das eine URL zur Passwort-vergessen-Seite erzeugt:

<a href="{{= $wsViews.viewUrl('account/forgotPassword.htm') }}">
  Passwort vergessen?
</a>

$wsViews.metaTitle()

Gibt den Seitentitel für den Browser-Tab und Suchergebnisse aus.

Signatur
string $wsViews.metaTitle()

Rückgabe
string - Seitentitel.

Beispiel, das den Meta-Titel im HTML-Head setzt:

<title>{{= $wsViews.metaTitle() }}</title>

$wsViews.metaDescription()

Gibt die Seitenbeschreibung für Suchergebnisse aus.

Signatur
string $wsViews.metaDescription()

Rückgabe
string - Seitenbeschreibung.

Beispiel, das die Meta-Description im HTML-Head setzt.

<meta name="description" content="{{= $wsViews.metaDescription() }}">

$wsViews.getHreflangManual()

Gibt manuell konfigurierte hreflang-Einträge aus.

Signatur
$wsViews.getHreflangManual()

Rückgabe
array - Liste mit manuellen Sprachversionen.

Beispiel, das manuelle hreflang-Links ausgibt.

{{ foreach $myHref in $wsViews.getHreflangManual() }}
  <link rel="alternate" hreflang="{{= $myHref.lang }}" href="{{= $myHref.href }}">
{{ /foreach }}

$wsViews.current.getHreflangAutomatic()

Gibt die Sprachversionen der aktuellen Seite für hreflang-Tags aus.

Signatur
$wsViews.current.getHreflangAutomatic()

Rückgabe
array - Liste mit Sprachversionen (lang, href).

Beispiel, das automatische hreflang-Links ausgibt.

{{ foreach $myHreflang in $wsViews.current.getHreflangAutomatic() }}
  <link rel="alternate" hreflang="{{= $myHreflang.lang }}" href="{{= $myHreflang.href }}">
{{ /foreach }}

---

Aktionen

Für $wsViews stehen keine Aktionen zur Verfügung.

---

Beispiele für URL- und Parameter-Zugriffe

View-URL & Host

<link rel="canonical" href="{{= $wsViews.host }}{{= $wsViews.current.url() }}" />

{{= $wsViews.current.url() }}

Template bedingte Ausgaben von Inhalten

...
{{ if ($wsViews.current.name == "start") }}
  
  <section class="hero">…</section>
{{ /if }}
...

Parameter lesen (Liste & gezielte Abfrage)

Iteration über alle Parameter:

...
<ul class="params">
  {{ for (p in $wsViews.paramList) }}
    <li>{{= p.name }} = {{= p.value }}</li>
  {{ end }}
</ul>
...

Gezielt prüfen (Beispiel „otp“):

{{ if ($wsViews.params.otp && $wsViews.params.otp == "required") }}
  <div class="notice notice--otp">Bitte Einmalpasswort eingeben.</div>
{{ /if }}

Hreflang & Meta (Kurzbeispiele)

...
<title>{{= $wsViews.metaTitle() }}</title>
<meta name="description" content="{{= $wsViews.metaDescription() }}" />

{{ for (h in $wsViews.getHreflangAutomatic()) }}
  <link rel="alternate" hreflang="{{= h.lang }}" href="{{= h.href }}" />
{{ end }}

{{ for (h in $wsViews.getHreflangManual()) }}
  <link rel="alternate" hreflang="{{= h.lang }}" href="{{= h.href }}" />
{{ end }}
...

 

---

Weiterführende Links

• SEO-Metadaten konfigurieren