404-Fehler bei Erfolgs- oder Abbruchseiten in TYPO3 beheben

INHALTSVERZEICHNIS

• 404-Fehler erkennen
• Warum TYPO3 die Weiterleitung blockiert
  • Parameter bei automatischen Erfolgs- und Abbruchseiten
  • Parameter bei eingebetteten Spendenaktionen
• TYPO3-Konfiguration prüfen und 404-Fehler beheben
• Was Du auf FundraisingBox-Seite beachten musst
• Häufige Probleme
  • Die Erfolgsseite funktioniert weiterhin nicht
  • Der Fehler tritt bei Spendenaktionen auf

Wenn Du ein FundraisingBox-Formular oder eine Spendenaktion in eine TYPO3-Website eingebettet hast, kann bei einer Weiterleitung ein 404-Fehler auftreten. In diesem Artikel erfährst Du, welche URL-Parameter dabei verwendet werden und welche TYPO3-Einstellungen Du prüfen solltest.

404-Fehler erkennen

Nach einer Spende oder einem Abbruch kann TYPO3 anstelle der automatischen Erfolgs- oder Abbruchseite beispielsweise folgende Fehlermeldung anzeigen:

404 Page not found.
The page did not exist or was inaccessible.
Reason: Request parameters could not be validated (&cHash empty)

Warum TYPO3 die Weiterleitung blockiert

TYPO3 prüft URL-Parameter standardmäßig streng. Kennt TYPO3 die bei einer Weiterleitung übergebenen Parameter nicht oder fehlt der sogenannte cHash, kann das System die Anfrage blockieren und einen 404-Fehler ausgeben.

Parameter bei automatischen Erfolgs- und Abbruchseiten

Nach einer Spende leitet die FundraisingBox automatisch auf die Seite zurück, auf der das Formular eingebettet ist. Dabei ergänzt sie die URL abhängig vom Ergebnis um Parameter.

Bei einer erfolgreichen Spende:

?status=successful&token=

Bei einem Abbruch oder Fehler:

?status=failure

Wenn TYPO3 diese Parameter nicht akzeptiert oder der erforderliche cHash fehlt, kann die Weiterleitung mit einem 404-Fehler enden.

Parameter bei eingebetteten Spendenaktionen

Auch bei eingebetteten Spendenaktionen können Weiterleitungsprobleme auftreten. Für Spender*innen sieht es so aus, als blieben sie auf derselben Seite. Im Hintergrund erfolgen jedoch Weiterleitungen mit URL-Parametern.

Das betrifft beispielsweise folgende Aktionen:

• Eine neue Spendenaktion wird über „Neue Aktion erstellen“ gestartet.
• Eine bestehende Spendenaktion wird geöffnet und zum Formular weitergeleitet.

Dabei verwendet die FundraisingBox folgende Parameter:

• Neue Aktion erstellen:?cfs=e
• Bestehende Spendenaktion öffnen:?cfd=xxxxx#cff

Die Zeichenfolge xxxxx ist für jede Spendenaktion individuell und besteht aus einer Kombination von Buchstaben und Zahlen.

Auch diese Weiterleitungen können einen 404-Fehler auslösen, wenn TYPO3 die Parameter nicht akzeptiert oder der cHash fehlt.

TYPO3-Konfiguration prüfen und 404-Fehler beheben

Prüfe die folgenden Einstellungen, damit TYPO3 die Weiterleitungen der FundraisingBox korrekt verarbeitet.

1. Erlaube die benötigten URL-Parameter.

   Hinterlege die Parameter status und token in Deiner TYPO3-Konfiguration über TypoScript:

   config.linkVars = L,status,token

2. Prüfe alternativ die cHash-Validierung.

   Du kannst die strenge cHash-Validierung für die Seite deaktivieren, auf der das Spendenformular eingebettet ist:

   config.disableCHashValidation = 1

3. Prüfe die Einbettungsadresse.

   Stelle sicher, dass die im Spendenformular hinterlegte URL exakt der Seite entspricht, auf der Du den JavaScript-Einbettungscode eingebunden hast.

Was Du auf FundraisingBox-Seite beachten musst

Die Weiterleitung auf die automatische Erfolgs- oder Abbruchseite gehört zur Standardfunktion der FundraisingBox. Wenn TYPO3 die Weiterleitung aufgrund der Parameterverarbeitung blockiert, ist dafür keine Anpassung in der FundraisingBox erforderlich.

Häufige Probleme

Die Erfolgsseite funktioniert weiterhin nicht

Prüfe insbesondere, ob:

• status und token von TYPO3 akzeptiert werden,
• die cHash-Validierung die Anfrage blockiert und
• die im Formular hinterlegte URL exakt mit der Seite des eingebetteten Formulars übereinstimmt.

Der Fehler tritt bei Spendenaktionen auf

Berücksichtige zusätzlich die Parameter ?cfs=e und ?cfd=xxxxx#cff. Auch diese Parameter können von der TYPO3-Validierung blockiert werden.