Checkout Success Page: Thank You Page mit eigenem CMS-Block + Bestelldetails (Magento 2)

Wozu dient dieses Modul?

Die standardmäßige Thank You Page in Magento beendet die Customer Journey häufig mit einer kurzen Meldung und der Bestellnummer. Dieses Modul verwandelt die Erfolgsseite in einen nützlichen Kommunikationspunkt nach dem Kauf, ohne aufwendige Builder und ohne Umbau des Checkouts.

Was macht das Modul Kowal_CheckoutThankYouPage?

Das Modul Kowal_CheckoutThankYouPage erweitert die standardmäßige Thank You Page in Magento 2 und verwandelt sie in eine übersichtliche Bestellübersicht mit der Möglichkeit, eigene Marketing- und Informationstexte hinzuzufügen. Es basiert auf dem Layout der Erfolgsseite und den Standardblöcken von Magento, wodurch es schlank, kompatibel und sicher in der Wartung bleibt.

1. Ordnet die Standard-Elemente von Magento neu an und verschiebt sie in ein neues Layout
   Das Modul führt die wichtigsten nach dem Kauf sichtbaren Magento-Elemente an einer Stelle zusammen. Dadurch sieht der Kunde eine konsistente, geordnete Ansicht ohne verstreute Elemente:
   • Erfolgsmeldungen (checkout.success) sowie die Registrierung nach dem Kauf (checkout.registration) in einen dedizierten Seiten-Container,
   • standardmäßige messages (z. B. Warnungen, Fehler, Bestätigungen) in eine gut lesbare Sektion im oberen Seitenbereich.
2. Zeigt vollständige Bestelldetails an einer Stelle an
   Die Erfolgsseite wird um die Sektion Bestelldetails erweitert, in der der Kunde alle wichtigen Informationen direkt zur Hand hat. Das reduziert Anfragen an den Support wie Wo kann ich meine Bestellung prüfen? und erhöht den Komfort des Kunden unmittelbar nach dem Kauf:
   • grundlegende Bestellinformationen (Nummer, Datum),
   • Bestellinformationsblöcke auf Basis nativer Magento-Komponenten (z. B. MagentoSalesBlockOrderInfo),
   • vollständige Zusammenfassung des Bestellinhalts.
3. Zeigt die Produktliste der Bestellung (items) sowie die vollständige Betragssumme (totals) an
   Das Ergebnis: Der Kunde sieht eine übersichtliche Bestellquittung, ohne den Kundenbereich oder eine E-Mail öffnen zu müssen. Das Modul rendert:
   • die Liste der Bestellpositionen (MagentoSalesBlockOrderItems) einschließlich Renderern (sales_order_item_renderers, sales_order_item_price),
   • die vollständige Kostenübersicht (MagentoSalesBlockOrderTotals) mit Konfiguration des label/value-Stylings,
   • Steuern (MagentoTaxBlockSalesOrderTax),
   • sowie — sofern der Shop auf Magento EE läuft und die Konfiguration verfügbar ist — die Sektion gift cards (bedingt über ifconfig='giftcard/email/identity').
4. Fügt zusätzlichen Platz für Inhalte anderer Module hinzu (container)
   Das Modul stellt einen Container bereit, sodass Sie (oder andere Module) zusätzliche Inhalte sicher in die Erfolgsseite einfügen können — z. B. Versandinformationen, CTA zur mobilen App, B2B-Anleitungen usw. — ohne den Core zu bearbeiten:
   • order.success.additional.info
5. Zeigt einen eigenen CMS-Block auf der Erfolgsseite an (konfigurierbar)
   Dies ist eine der wichtigsten Funktionen des Moduls: In der Konfiguration kann ein CMS-Block ausgewählt werden, der auf der Thank You Page gerendert wird. Der CMS-Block wird über den standardmäßigen CMS-Filter gerendert, daher funktionieren darin typische Magento-Direktiven (Widgets, Variablen usw.). Zusätzlich hat das Modul eine cache_lifetime gesetzt (z. B. 86400), damit statische Inhalte die Seite nicht belasten.
   Im CMS-Block können Sie z. B. platzieren:
   • Anweisungen zum weiteren Vorgehen (Bearbeitung, Fristen, Kontakt),
   • Informationen zu Rücksendungen und Reklamationen,
   • Promobanner / Rabattcode für weitere Einkäufe,
   • Links zu FAQ oder Hilfeseiten,
   • beschreibendes Cross-Selling (z. B. passendes Zubehör zum Kauf auswählen).
6. (Optional) Fügt Google Customer Reviews hinzu (Google Customer Reviews – Survey Opt-in)
   Nach Aktivierung der Funktion in der Konfiguration kann das Modul auf der Erfolgsseite das Opt-in-Skript Google Customer Reviews anzeigen, also eine Einladung zur Abgabe einer Bewertung nach dem Kauf.
   

   So können Bewertungen gemäß dem Google-Mechanismus gesammelt werden, ohne Daten manuell im Template ergänzen zu müssen.

   Die Integration füllt automatisch die erforderlichen Daten für gapi.surveyoptin.render() aus, u. a.:
   • merchant_id,
   • order_id,
   • email,
   • delivery_country,
   • estimated_delivery_date,
   • die Produktliste als products[].gtin (GTIN/EAN wird aus dem Produktattribut abgerufen).
7. Unterstützt einen Kommentar / eine Sektion für zusätzliche Informationen (falls Sie sie verwenden)
   Im Seitenlayout ist ein zusätzlicher Block für einen Kommentar / eigenen Inhalt vorgesehen (custom.comment). Dadurch können Sie Mitteilungen ergänzen, die an Ihren Verkaufsprozess angepasst sind (z. B. Bitte um Kontaktaufnahme bei ungewöhnlichen Bestellungen, Information zur Personalisierung usw.).
8. Ist schlank und sicher für den Bestellprozess
   Das Modul greift nicht in die Aufgabe von Bestellungen oder Zahlungen ein — es verändert ausschließlich die Präsentationsschicht der Erfolgsseite. Dadurch lässt es sich:
   • einfach implementieren,
   • einfach deaktivieren (Rückkehr zur Standardansicht),
   • mit minimalem Risiko für Konflikte im Checkout einsetzen.

Wichtigste Vorteile (tatsächlich aus dem Code resultierend)

• Einfache Konfiguration: aktivieren/deaktivieren + Auswahl eines CMS-Blocks zur Anzeige auf der Erfolgsseite.

• Funktioniert pro Store View (scope: default/website/store).

• Performantes CMS-Rendering: Der Blockinhalt wird mit dem standardmäßigen CMS-Filter gefiltert (Direktiven, Variablen) und mit einem shopabhängigen Schlüssel gecacht (standardmäßig 24h).

• Keine Konflikte mit dem größeren Modul: Wenn ein aktives Kowal_ThankYouPage erkannt wird (und in der Konfiguration aktiviert ist), dann:

  • wird die Option im Adminbereich gesperrt (disabled),

  • und die Erfolgsseite bleibt unter der Kontrolle dieses größeren Moduls.

• Keine Tabellen und keine Änderungen an der Datenbank: Die Installation ist schlank (Layout + Blöcke + Konfiguration).

Konfiguration in Magento

Pfad: Stores → Configuration → Kowal Checkout → Order Success Page

• Custom Order Success Page: eigene Erfolgsseite aktivieren/deaktivieren (bei Deaktivierung wird die standardmäßige Magento-Seite wiederhergestellt)

• Success Page Custom Block: Auswahl des CMS-Blocks, der nach den Bestelldetails angezeigt werden soll