urls - URL (Webadressen)

Der urls-Knoten bündelt die URL-Konfiguration: hreflang-Alternativen, Weiterleitungen, veraltete URLs sowie Aufbau und Bereinigung der SEO-URLs.

Der Knoten urls bündelt die URL-Konfiguration des Shops. Er umfasst Sprach-/Länder-Alternativen per hreflang, den Umgang mit fehlerhaften oder veralteten URLs sowie den Aufbau und die Bereinigung der SEO-URLs hinsichtlich Struktur, Trennzeichen und Parameterbereinigung.

---

​

urls* - Grundstruktur

Nachfolgend der Grundaufbau des Knotens urls

{
  "urls": {
    "hreflang": {},
    "redirects": {},
    "urls": {}
  }
}

​

Parameterbeschreibung

Parameter	Beschreibung
hreflang	Steuert, welche Seiten-URLs Suchmaschinen per hreflang kennen sollen.
redirects	Steuert, wie der Shop auf fehlerhafte oder nicht mehr gültige URLs reagiert: mit Statuscode 404 oder 410 oder mit einer Weiterleitung.
urls	Steuert, wie sprechende URLs im Shop aufgebaut und bereinigt werden.

---

​

urls.hreflang - Sprach-/Länder-Alternativen für Seiten-URLs

Über diesen Knoten wird gesteuert, welche alternativen Seiten-URLs (beispielsweise DE/AT/CH/EN) Suchmaschinen per hreflang zu einer Seite kennen sollen. Dazu werden Subshops zu Gruppen zusammengefasst. Pro Gruppe lässt sich festlegen, ob Produkte/Kategorien automatisch oder manuell zugeordnet werden und in welchem Exportformat (CSV/JSON) die Zuordnungen ausgegeben werden sollen.

Die Einstellung kann über folgenden Link direkt im Admin-Interface geöffnet werden: https://<shop-domain>/admin/config/urls.hreflang (Deeplink-Übersicht)

​

Beispielkonfiguration

{
  "collectInfo": true,
  "subshopGroups": [
    {
      "categoryAlloc": "automatic",
      "checkMode": true,
      "fileNameCategory": "catAlloc.csv",
      "fileNameProduct": "prodAlloc.csv",
      "fileType": "csv",
      "groupId": "hrefGroup",
      "groupName": "Href-Group",
      "productAlloc": "automatic",
      "subshops": [
        {
          "default": true,
          "subshopId": "deutsch"
        },
        {
          "default": false,
          "subshopId": "englisch"
        }
      ]
    }
  ]
}

​

Parameterübersicht

Parameter	Typ	Beschreibung
collectInfo	bool	Wenn diese Option aktiviert wird, sammelt das System Informationen darüber, welche Sprach-/Länderversionen zu welcher Seite gehören und ob die Verknüpfungen korrekt gesetzt sind. Das hilft beim Finden von Fehlern. Default: true
subshopGroups	list (object)	Liste der Subshop-Gruppen, die für hreflang zusammengefasst werden.
groupId	string	Eindeutige Kennung der hreflang-Gruppe innerhalb von subshopGroups. Frei wählbar.
groupName	string	Lesbarer Name der hreflang-Gruppe.
checkMode	bool	Schaltet Prüfungen ein, die typische Fehler in den Sprach-/Länder-Zuordnungen finden.
productAlloc	enum	Legt fest, wie sprach-/subshop-spezifische Gegenstücke desselben Produkts (hreflang-Varianten) verknüpft werden. automatic - Automatische Zuordnung manual - Zuordnung wird manuell gepflegt (beispielsweise per Datei/Liste). Default: automatic
categoryAlloc	enum	Legt fest, wie sprach-/subshop-spezifische Kategorien verknüpft werden. automatic - Automatische Zuordnung manual - Zuordnung wird manuell gepflegt (beispielsweise per Datei/Liste). Default: automatic
fileType	enum	Legt das Exportformat der Hreflang-Zuordnungen für Kategorien und Produkte fest. csv - stellt die Export-Datei im csv-Format bereit json - stellt die Export-Datei im json-Format bereit
fileNameProduct	string	Legt den Dateinamen für den Export der Produktzuordnungen fest.
fileNameCategory	string	Legt den Dateinamen für den Export der Kategoriezuordnungen fest.
subshops	list (object)	Enthält eine Liste der verfügbaren Sprach-/Subshops.
subshopId	string	ID des Subshops, beispielsweise de oder en.
default	bool	Markiert die primäre Sprache/Region. Default: false

---

​

urls.redirects - Verhalten bei nicht gefundenen Seiten

Über den Unterknoten redirects wird gesteuert, wie der Shop auf nicht mehr gültige oder fehlerhafte URLs reagiert, beispielsweise bei gelöschten Produkten oder Kategorien oder bei veralteten Links. Hier wird auch festgelegt, welches Fehlerseiten-Template verwendet wird, ob nach Möglichkeit automatisch auf die Elternkategorie umgeleitet wird und welche Seite als Fallback dient. Ebenso wird hier bestimmt, mit welchem HTTP-Statuscode der Shop antwortet.

​

Statuscode statt Weiterleitung

Für Suchmaschinen ist es entscheidend, dass nicht existierende Seiten auch als solche gemeldet werden. Leitet der Shop stattdessen auf eine andere Seite weiter, behandeln Suchmaschinen die alte URL weiterhin als gültig. Deshalb antwortet der Shop standardmäßig mit dem Statuscode 404 und zeigt die Fehlerseite direkt unter der aufgerufenen URL an. Dabei bleibt die URL in der Adresszeile unverändert.

Das Verhalten legt der Parameter errorPageBehavior fest:

Wert	Statuscode	Verhalten
notFound	404 Not Found	Die Fehlerseite wird unter der aufgerufenen URL angezeigt. Geeignet für Seiten, die es nicht gibt oder nicht mehr gibt. Standardwert.
gone	410 Gone	Die Fehlerseite wird unter der aufgerufenen URL angezeigt. Der Statuscode teilt Suchmaschinen mit, dass die Seite dauerhaft entfernt wurde.
redirect	301 Moved Permanently	Der Aufrufer wird auf die URL der Fehlerseite weitergeleitet. Ist die Startseite die Fehlerseite, führt die Weiterleitung auf /.

Welche Seite als Fehlerseite dient, wird durch redirectFallback und errorPageTemplate bestimmt. Bei notFound und gone gibt $wsViews.current.status auf der Fehlerseite den gesendeten Statuscode aus, also 404 oder 410. Damit lässt sich im Template beispielsweise ein passender Hinweistext ausgeben.

Die Einstellung kann über folgenden Link direkt im Admin-Interface geöffnet werden: https://<shop-domain>/admin/config/urls.redirects (Deeplink-Übersicht)

​

Beispielkonfiguration

{
  "errorPageBehavior": "notFound",
  "errorPageTemplate": "error.htm",
  "redirectFallback": "errorPage",
  "redirectToParentCategory": true
}

​

Parameterübersicht

Parameter	Typ	Beschreibung
errorPageBehavior	enum	Legt fest, wie der Shop antwortet, wenn eine aufgerufene Seite nicht gefunden wurde. notFound - Statuscode 404, die aufgerufene URL bleibt gleich gone - Statuscode 410, die aufgerufene URL bleibt gleich redirect - Weiterleitung auf die URL der Fehlerseite Default: notFound
errorPageTemplate	string	Name des Templates, das für Fehlerseiten (beispielsweise die 404-Seite) verwendet wird.
redirectFallback	enum	Fallback-Ziel, wenn keine spezifische Weiterleitung greift. startPage - im Fehlerfall wird auf die Startseite des Shops weitergeleitet errorPage - Im Fehlerfall wird auf die Default-Fehlerseite weitergeleitet Ob weitergeleitet oder die Seite unter der aufgerufenen URL angezeigt wird, legt errorPageBehavior fest. Default: startPage
redirectToParentCategory	bool	Wenn true, wird bei fehlerhaften URLs nach Möglichkeit auf die Elternkategorie umgeleitet. Default: true

---

​

urls.urls - Allgemeine Einstellungen für SEO-URLs

Über den Unterknoten urls wird gesteuert, wie sprechende URLs im Shop aufgebaut und bereinigt werden. Dabei wird unter anderem festgelegt, ob die URL-Logik aktiv ist, ob URLs kleingeschrieben werden und welche Trennzeichen verwendet werden.

Die Einstellung kann über folgenden Link direkt im Admin-Interface geöffnet werden: https://<shop-domain>/admin/config/urls.urls (Deeplink-Übersicht)

​

Beispielkonfiguration

{
  "active": true,
  "alwaysEndWithSlash": true,
  "generate": [
    {
      "options": {
        "urlschema": [
          {
            "schema": [
              {
                "fields": [
                  "categoryPath"
                ],
                "listOptions": {
                  "categoryField": "name",
                  "order": "reverse",
                  "top": 2
                },
                "optional": true,
                "separator": "/",
                "type": "field"
              },
              {
                "fields": [
                  "name"
                ],
                "optional": true,
                "separator": "/",
                "type": "field"
              }
            ],
            "subshop": "englisch"
          },
          {
            "schema": [
              {
                "fields": [
                  "categoryPath"
                ],
                "listOptions": {
                  "categoryField": "name",
                  "order": "normal",
                  "top": 1
                },
                "optional": true,
                "separator": "/",
                "type": "field"
              },
              {
                "fields": [
                  "name"
                ],
                "optional": true,
                "separator": "/",
                "type": "field"
              }
            ]
          }
        ]
      },
      "service": "seoUrlHandler.category"
    },
    {
      "options": {
        "urlschema": [
          {
            "schema": [
              {
                "fields": [
                  "brand"
                ],
                "optional": true,
                "separator": "/",
                "type": "field"
              },
              {
                "fields": [
                  "categoryPath"
                ],
                "listOptions": {
                  "categoryField": "name",
                  "order": "normal",
                  "top": 1
                },
                "optional": true,
                "separator": "/",
                "type": "field"
              },
              {
                "fields": [
                  "name"
                ],
                "optional": true,
                "separator": "/",
                "type": "field"
              }
            ]
          }
        ]
      },
      "service": "seoUrlHandler.product"
    }
  ],
  "lowercase": true,
  "mappings": {
    "ß": "ss",
    "ä": "ae",
    "ö": "oe",
    "ü": "ue"
  },
  "parametersToRemove": [
    "ref"
  ],
  "suffixSeparator": "-",
  "wordSeparator": "_"
}

​

Parameterübersicht

Parameter	Typ	Beschreibung
active	bool	Schaltet die URL-Logik ein/aus. Wenn false, wird die automatische SEO-URL-Verarbeitung (Funktion, die die URLs suchmaschinenfreundlich macht) deaktiviert. Default: true
lowercase	bool	Wenn true, werden URLs in Kleinbuchstaben ausgegeben (beispielsweise /produkte/t-shirt).
suffixSeparator	string	Separator zwischen Basis-URL und Suffix, beispielsweise der Produkt-ID. Häufig -, beispielsweise /t-shirt-1234.
wordSeparator	string	Separator zwischen Wörtern im Pfad, beispielsweise _ → /t_shirt_herren/.
alwaysEndWithSlash	bool	Wenn true, enden generierte URLs immer mit / (beispielsweise /herren/t-shirts/)
parametersToRemove	list (string)	Liste von Query-Parametern, die aus URLs entfernt werden sollen (beispielsweise Tracking-Parameter wie ref, utm).
mappings	map	Zeichen-Mappings für die URL-Erzeugung. Schlüssel = Originalzeichen (meist für Umlaute verwendet), Wert = Ersatzzeichenfolge.
<Schlüssel>	string	Originalzeichen (beispielsweise ä, ß), das in URLs ersetzt werden soll.
<Wert>	string	Ersatzzeichen (beispielsweise ae statt ä), das das Originalzeichen ersetzt.
generate	list (object)	Ein Eintrag in generate beschreibt die URL-Erzeugung für einen bestimmten Typ, beispielsweise Kategorien oder Produkte.
service	string	Name des URL-Handlers, beispielsweise seoUrlHandler.category.
options	object	Optionen für diesen Service, insbesondere die Definition der URL-Schemate über urlschema.
urlschema	list (object)	Jedes urlschema beschreibt ein Schema für die Zusammensetzung des URL-Pfads.
subshop	string	Subshop-ID, für den dieses Schema gilt, beispielsweise englisch.
schema	list (object)	Liste von Schema-Bausteinen, die nacheinander den URL-Pfad aufbauen.
type	string	Art des Schema-Bausteins, beispielsweise field.
fields	list (string)	Liste von Feldnamen, deren Werte in diesen Abschnitt einfließen, beispielsweise categoryPath, brand, name.
separator	string	Trenner, der hinter diesem Abschnitt in der URL gesetzt wird, beispielsweise /.
optional	bool	Wenn true, wird der Baustein übersprungen, falls keine Werte vorhanden sind.
listOptions	object	Zusätzliche Optionen, wenn das Feld eine Liste/Hierarchie ist, beispielsweise categoryPath.
categoryField	string	Feld, das für den Kategorienamen genutzt wird (typisch: name).
order	enum	Reihenfolge, in der Kategorien ausgegeben werden. normal - von oben nach unten reverse - von unten nach oben
top	int	Anzahl der Ebenen, die übernommen werden sollen (beispielsweise 1 → nur die oberste Kategorie oder 2 → die ersten beiden Ebenen).