Search Documentation

Search for pages and headings in the documentation

Weiterleitungen

Mit dem Weiterleitungs-Feature können Sie beliebige URL-Pfade Ihrer Website auf ein anderes Ziel umleiten — sowohl auf interne Seiten Ihrer Instanz als auch auf externe URLs. Weiterleitungen werden als 301 Permanent Redirect ausgeliefert und eignen sich beispielsweise für umbenannte Seiten, aufgelöste Kategorien oder Kampagnen-Links.


Priorität der Weiterleitungen

Beim Aufruf einer URL durchläuft CrispyCMS eine festgelegte Reihenfolge, bevor eine Antwort ausgeliefert wird:

  1. Statische Dateien & UGC — Der Webserver (Nginx) bedient statische Assets (Bilder, CSS, JS, hochgeladene Dateien) direkt, bevor PHP überhaupt aufgerufen wird. Existiert unter einem Pfad eine echte Datei, wird sie ausgeliefert — eine Weiterleitung für denselben Pfad bleibt wirkungslos.
  2. Aktive Weiterleitungen — Gibt es keine statische Datei für den Pfad, prüft CrispyCMS als Erstes die aktiven Weiterleitungen. Wird eine passende, aktive Weiterleitung gefunden, erfolgt sofort der 301-Redirect — ohne dass Seiten oder Kategorien geprüft werden.
  3. Seiten & Kategorien — Erst wenn keine Weiterleitung greift, wird nach einer passenden CMS-Seite oder Kategorie gesucht.

Das bedeutet: Bestehende Seiten oder Kategorien werden durch eine Weiterleitung auf denselben Pfad überschrieben, sofern die Weiterleitung aktiv ist. Statische Dateien und UGC können hingegen nicht über Weiterleitungen überlagert werden.


Übersicht der Weiterleitungen

Der Menüpunkt Redaktion → Weiterleitungen zeigt alle angelegten Weiterleitungen in einer Tabelle.

SpalteBeschreibung
QuelleDer URL-Pfad, der weitergeleitet wird (z. B. alte-seite).
ZielDas Weiterleitungsziel — eine interne oder externe URL.
StatusAktiv oder Inaktiv — nur aktive Weiterleitungen werden tatsächlich ausgewertet.
ErstelltZeitstempel der Erstellung.
AktionenBearbeiten oder Löschen der jeweiligen Weiterleitung.

Weiterleitung anlegen

  1. Klicken Sie auf + Weiterleitung erstellen oben rechts.
  2. Füllen Sie das Formular aus:
FeldBeschreibung
QuelleDer Pfad, der weitergeleitet werden soll. Führende Slashes werden automatisch entfernt — geben Sie z. B. alte-seite oder blog/alter-artikel ein.
ZielDas Ziel der Weiterleitung. Kann ein interner Pfad (/neue-seite) oder eine vollständige externe URL (https://example.com) sein.
AktivGibt an, ob die Weiterleitung sofort ausgewertet wird. Deaktivierte Weiterleitungen werden gespeichert, aber nicht ausgeführt.
  1. Klicken Sie auf Speichern. Die Weiterleitung ist umgehend wirksam.

Weiterleitung bearbeiten

Klicken Sie in der Übersichtstabelle auf das Bearbeiten-Symbol einer Weiterleitung. Sie können Quelle, Ziel und den Aktivstatus jederzeit ändern.

Besteht eine Kollision mit einer vorhandenen CMS-Seite oder Kategorie, wird dies in der Bearbeitungsansicht durch einen Hinweis hervorgehoben.


Weiterleitung löschen

Klicken Sie auf das Löschen-Symbol in der Übersicht und bestätigen Sie die Aktion. Gelöschte Weiterleitungen können nicht wiederhergestellt werden.


Interne vs. externe Weiterleitungen

ArtBeispielzielBeschreibung
Intern/neue-seite oder /blog/artikelLeitet auf eine andere Seite innerhalb derselben CrispyCMS-Instanz weiter.
Externhttps://example.comLeitet auf eine beliebige externe URL weiter.

Beide Varianten werden als HTTP 301 ausgeliefert, was Suchmaschinen signalisiert, dass die Ressource dauerhaft verschoben wurde.


Berechtigungen

BerechtigungWertBeschreibung
Weiterleitungen lesencrispy.read_redirectsErlaubt das Einsehen der Übersicht und der Bearbeitungsansicht.
Weiterleitungen verwaltencrispy.write_redirectsErlaubt das Anlegen, Bearbeiten und Löschen von Weiterleitungen.

Berechtigungen werden unter Verwaltung → Benutzer den jeweiligen Rollen zugewiesen. Superuser besitzen beide Berechtigungen automatisch.


Externe Weiterleitungsseite

Unabhängig von den oben beschriebenen Weiterleitungs-Einträgen zeigt CrispyCMS bei internen Links, die auf eine externe Domain verweisen, automatisch eine Zwischenseite mit Countdown, bevor Besucher tatsächlich weitergeleitet werden.

Ablauf für Besucher

  1. Der Besucher klickt auf einen Link, der zu einer externen Domain führt.
  2. Statt direkt weitergeleitet zu werden, erscheint eine Hinweisseite mit dem Titel „Externe Weiterleitung”, die die Zieladresse deutlich anzeigt und darauf hinweist, dass die aktuelle Seite verlassen wird.
  3. Ein Fortschrittsbalken zählt 5 Sekunden herunter, danach erfolgt die Weiterleitung automatisch.
  4. Der Besucher kann die Weiterleitung jederzeit über Jetzt fortfahren vorzeitig auslösen oder über Zurück abbrechen.