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

# 404-Fehlerseite

> Die beiden 404-Seiten eines WEBSALE V8s Shops: die statische 404.htm im Shop-Root und die Hinweisseite ws_notify.htm im Template-Verzeichnis.

Diese Seite beschreibt, welche Seite ein WEBSALE V8s Shop ausliefert, wenn eine angeforderte Adresse nicht existiert, und wie Sie beide dafür zuständigen Seiten einrichten.

Die Meldungen "404 Error, Page not found", "Fehler 404, Seite nicht gefunden" oder "Die von Ihnen angeforderte Seite wurde nicht gefunden" bedeuten alle dasselbe: Die angesteuerte Seite gibt es nicht. Welche Seite der Besucher dann zu sehen bekommt, hängt davon ab, ob die aufgerufene Adresse überhaupt als Shop-URL erkannt wurde.

## Zwei Typen von 404-Seiten

WEBSALE unterscheidet zwei Seiten, die unterschiedlich weit reichen.

| Seite | Ablageort | Wird angezeigt, wenn | WEBSALE-Tags |
| - | - | - | - |
| statische 404-Seite, beispielsweise `404.htm` | direkt im Shop-Root | die Adresse **keine** Shop-URL ist | nicht möglich |
| Hinweisseite `ws_notify.htm` | im Template-Verzeichnis des Shops | die Adresse als Shop-URL erkannt wurde | alle Shop-Tags |

Der Unterschied ist technisch begründet. Ist die Adresse keine Shop-URL, wird der Shop gar nicht erst aufgerufen. Es gibt dann keine Session, keinen Warenkorb und folglich auch nichts, was ein Tag ausgeben könnte. Wird die Adresse dagegen als Shop-URL erkannt, läuft der Shop und kann eine vollwertige Seite ausliefern.

> [!WARNING]
>
> Leiten Sie die statische 404-Seite nicht weiter und machen Sie sie nicht zu einem Shop-Template, um doch Shop-Tags zu ermöglichen. Das hat zwei unerwünschte Folgen.
>
> Erstens gibt der Server nach einer Weiterleitung keine 404-Meldung mehr aus, sondern ein "OK". Suchmaschinen erfahren damit nie, dass eine Seite nicht mehr existiert, und nehmen sie nicht aus dem Index.
>
> Zweitens steigen Ihre Leistungseinheiten. Jede Anfrage, die keine Datei findet, würde an den Shop weitergereicht und dort abgerechnet.

## 404-Aufrufe in WEBSALE V8s

Sind die SEO-URLs aktiv, kommen echte 404-Fehler in WEBSALE V8s nur noch in seltenen Ausnahmefällen vor, etwa bei einem nicht vorhandenen Produktbild. In den typischen Fällen greift stattdessen eine automatische 301-Weiterleitung auf eine aktuelle URL, auf die Startseite oder, sofern konfiguriert, auf eine Auffangseite.

Weitergeleitet wird in diesen Fällen:

* Der Shop wird mit einem nicht mehr aktuellen Link aufgerufen, beispielsweise nach einer Änderung am URL-Aufbau.
* Der Shop wird mit einer nicht existierenden SEO-URL aufgerufen.
* Es wird eine Informationsseite aufgerufen, die im Shop nicht mehr gefunden wird.
* Es wird ein nicht mehr verfügbares Produkt aufgerufen, für das weder ein Ersatzprodukt definiert noch eine verfügbare Kategorie oder nächsthöhere Kategorie bis Level 1 vorhanden ist.
* Es wird eine nicht mehr verfügbare Kategorie ohne verfügbare nächsthöhere Kategorie bis Level 1 aufgerufen.

Wegweiser: [SEO-URLs, automatische 301-Weiterleitung](https://dokumentation.websale.de/v8s/seo/seo-urls-und-link-optimierung.md)

Eine statische 404-Seite ist in WEBSALE V8s deshalb nicht zwingend nötig. Sie einzurichten lohnt sich trotzdem, weil sie die verbleibenden Ausnahmefälle abfängt.

## Statische 404-Seite einrichten

Die üblichen 404-Seiten sind optisch wenig ansprechend und helfen dem Besucher nicht weiter. Da Sie die Seite frei gestalten, können Sie den Besucher stattdessen aktiv zurück in den Shop führen.

![404](https://mintcdn.com/websaleag-44ee7ea6/GhYeuPYs7oEmFYIy/images/404.png?fit=max\&auto=format\&n=GhYeuPYs7oEmFYIy\&q=85\&s=f63edcae289eb4ab66aed3138a4e7706)

### Datei ablegen

Erstellen Sie eine beliebige HTML-Datei und speichern Sie sie direkt im Shop-Root, nicht wie sonst im Template-Verzeichnis. Nutzen Sie mehrere Subweb-Verzeichnisse, legen Sie pro Verzeichnis eine eigene 404-Datei an.

Legen Sie auch alle Dateien, die diese Seite braucht, im selben Verzeichnis ab, beispielsweise Stylesheets und Grafiken. Der Grund ist derselbe wie oben: Die Seite läuft außerhalb des Shops und kann deshalb nicht auf die üblichen Template-Pfade zugreifen.

### Template zuweisen

Im Standard wird bereits ein Template `404.htm` im Shop-Root ausgeliefert, das Sie nur anpassen müssen. Ist es nicht vorhanden, weisen Sie in der Konfigurationsdatei `ws_access.conf` über den Parameter `ErrorDocument 404` ein Dokument zu.

```apache theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
...
ErrorDocument 404 /404.htm
...
```

Das zugewiesene Dokument muss zwingend direkt im Shop-Root liegen.

> [!WARNING]
>
> Bearbeiten Sie die `ws_access.conf` nur mit einem Editor, der Unix-Zeilenumbrüche ("LineFeed") erzeugt. Andernfalls sind Shops ohne SEO-URLs nicht mehr aufrufbar.
>
> Haben Sie keinen Zugriff auf das Root-Verzeichnis Ihres Shops, wenden Sie sich an Ihren WEBSALE Ansprechpartner. Er veranlasst die Anpassung für Sie.

### Inhalt gestalten

Erstellen oder bearbeiten Sie die Datei unter dem Namen, den Sie zugewiesen haben. Das folgende Beispiel benennt den wahrscheinlichen Grund und bietet zwei Wege zurück an, die Startseite und den Kontakt.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<body>

   <h1>Diese Seite konnte leider nicht gefunden werden</h1>

   <p>Gründe dafür könnten sein, dass Sie eine falsche oder veraltete URL aufgerufen haben.
   Bitte überprüfen Sie diese noch einmal. Oder aber wir haben die betreffende Stelle archiviert,
   verschoben oder umbenannt.</p>

   <p>Vielleicht können Sie den von Ihnen gewünschten Inhalt über unsere Startseite finden.
   <a href="https://ihre-domain.de">Zur Startseite unseres Shops</a></p>

   <p>Oder dürfen wir Ihnen direkt behilflich sein? Schreiben Sie uns eine E-Mail oder rufen Sie
   uns einfach an.
   <a href="https://ihre-kontaktseite.de">Kontakt mit uns aufnehmen</a></p>

</body>
```

> [!WARNING]
>
> Auf dieser Seite werden weder WEBSALE-Tags noch WEBSALE-Klammerungen unterstützt. Alle Links müssen deshalb als vollständige Adressen notiert werden.

## Hinweisseite ws\_notify.htm einrichten

Die Hinweisseite ist mehr als eine 404-Seite. Sie zeigt auch Hinweise und Fehlermeldungen aus dem laufenden Shop an, beispielsweise wenn eine Aktion nicht ausgeführt werden konnte. In WEBSALE V8 ohne SEO-URLs erscheint sie zusätzlich immer dann, wenn Kategorien, Produkte oder Informationsseiten nicht gefunden werden.

Auch in WEBSALE V8s brauchen Sie diese Seite deshalb weiterhin, obwohl die 301-Weiterleitungen die meisten Fundstellen abfangen.

### Template in der Shopkonfiguration zuweisen

Geben Sie das Template im Abschnitt `<Templates>` der Shopkonfiguration `shop.config` hinter dem Parameter `Notify` an.

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<Templates>
   ...
   Notify = ws_notify.htm
   ...
</Templates>
```

Referenz: [Abschnitt Templates](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/grundlagen-und-technik.md#templates)

### Template erstellen

Legen Sie das Template unter genau diesem Namen in Ihrem Template-Verzeichnis an, beispielsweise `benutzer/templates/translation`.

Der Inhalt besteht aus drei Bausteinen. `MSG-Notify` gibt die eigentliche Meldung an den Besucher aus. `MSG-InternalErrorMessage` enthält Fehler, die sonst nur im Syslog landen. Diese Ausgabe ist für die Fehlersuche gedacht und im Beispiel deshalb auskommentiert, damit sie kein Besucher zu sehen bekommt. `WS-NotifyBackLink` liefert den Weg zurück auf die vorherige Seite und erscheint nur, wenn ein solcher Rücksprung möglich ist.

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

{MSG-Notify}
   ~MSG-Notify~
{/MSG-Notify}

<!-- Zum Debuggen: Fehler, die normalerweise per Syslog geschrieben werden und für den Besucher nicht sichtbar sein sollen
  {MSG-InternalErrorMessage}
     ~MSG-InternalErrorMessage~
  {/MSG-InternalErrorMessage} -->

{WS-NotifyBackLink}
   <a href="~WS-NotifyBackLink~">zurück</a>
{/WS-NotifyBackLink}
```

Referenz: [MSG-Notify](https://dokumentation.websale.de/v8s/referenz/tags/msg-meldungen.md#weitere-meldungen)


## Related topics

- [Server-Konfiguration ws_access.conf](https://dokumentation.websale.de/v8s/referenz/konfigurationen/server-konfiguration-ws-access-conf.md)
- [urls - URL (Webadressen)](https://dokumentation.websale.de/konfiguration/urls-url-webadressen.md)
- [Daten-Migration](https://dokumentation.websale.de/migration/daten-migration.md)
- [Bekannte Fehlermeldungen](https://dokumentation.websale.de/admin-interface/logs-und-statistiken/bekannte-fehlermeldungen.md)
- [PIA- (ProductsInAction)](https://dokumentation.websale.de/v8s/referenz/tags/pia-productsinaction.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.