Checkout Success Page : Thank You Page avec bloc CMS personnalisé + détails de commande (Magento 2)

À quoi sert ce module ?

La page « Thank You Page » par défaut de Magento termine souvent le parcours client par un court message et un numéro de commande. Ce module transforme la page de succès en point de communication utile après l’achat, sans créateurs lourds et sans refonte du checkout.

Que fait le module Kowal_CheckoutThankYouPage ?

Le module Kowal_CheckoutThankYouPage enrichit la page « Thank You Page » par défaut de Magento 2 et la transforme en écran clair de récapitulatif de commande, avec la possibilité d’ajouter vos propres contenus marketing et informatifs. Il fonctionne sur la base du layout de la page de succès et des blocs Magento standard, ce qui le rend léger, compatible et sûr à maintenir.

1. Organise et déplace les éléments Magento standard dans une nouvelle mise en page
   Le module regroupe au même endroit les éléments clés de Magento visibles après l’achat. Ainsi, le client voit une vue cohérente et structurée, sans éléments dispersés :
   • les messages de succès (checkout.success) ainsi que l’inscription après achat (checkout.registration) vers un conteneur dédié de la page,
   • les « messages » standard (par exemple avertissements, erreurs, confirmations) vers une section lisible en haut de page.
2. Affiche tous les détails de la commande au même endroit
   La page de succès est enrichie d’une section Order Details, dans laquelle le client dispose immédiatement de toutes les informations essentielles. Cela réduit le nombre de demandes au support, par exemple où consulter la commande ?, et améliore le confort du client juste après l’achat :
   • informations de base sur la commande (numéro, date),
   • blocs d’informations de commande basés sur les composants natifs de Magento (par exemple MagentoSalesBlockOrderInfo),
   • récapitulatif complet du contenu de la commande.
3. Affiche la liste des produits de la commande (items) ainsi que le récapitulatif complet des montants (totals)
   Résultat : le client voit un « reçu » de commande clair, sans avoir besoin d’accéder à son compte ou à un e-mail. Le module rend :
   • la liste des lignes de commande (MagentoSalesBlockOrderItems) avec les renderers (sales_order_item_renderers, sales_order_item_price),
   • le récapitulatif complet des coûts (MagentoSalesBlockOrderTotals) avec configuration du style label/value,
   • les taxes (MagentoTaxBlockSalesOrderTax),
   • et, si la boutique fonctionne sous Magento EE et que la configuration est disponible, la section gift cards (conditionnellement via ifconfig='giftcard/email/identity').
4. Ajoute un espace supplémentaire pour les contenus d’autres modules (container)
   Le module fournit un conteneur grâce auquel vous pouvez, ou d’autres modules peuvent, injecter en toute sécurité du contenu supplémentaire sur la page de succès — par exemple des informations de livraison, un CTA vers une application mobile, des instructions B2B, etc. — sans modifier le core :
   • order.success.additional.info
5. Affiche un bloc CMS personnalisé sur la page de succès (configurable)
   C’est l’une des fonctions les plus importantes du module : la possibilité d’indiquer dans la configuration le bloc CMS qui sera rendu sur la Thank You Page. Le bloc CMS est rendu via le filtre CMS standard, ce qui permet l’utilisation des directives Magento habituelles (widgets, variables, etc.). De plus, le module dispose d’un cache_lifetime défini (par exemple 86400), afin que les contenus statiques ne chargent pas la page.
   Dans le bloc CMS, vous pouvez placer par exemple :
   • des instructions « et maintenant ? » (traitement, délais, contact),
   • des informations sur les retours et les réclamations,
   • une bannière promotionnelle / un code de réduction pour de prochains achats,
   • des liens vers la FAQ ou les pages d’aide,
   • un cross-sell descriptif (par exemple « ajoutez des accessoires à votre achat »).
6. (En option) Ajoute Google Avis clients (Google Customer Reviews – Survey Opt-in)
   Après activation de la fonction dans la configuration, le module peut afficher sur la page de succès le script opt-in Google Customer Reviews, c’est-à-dire une invitation à laisser un avis après l’achat.
   

   Cela permet de collecter des avis conformément au mécanisme de Google, sans ajouter manuellement les données dans le template.

   L’intégration renseigne automatiquement les données requises pour gapi.surveyoptin.render(), notamment :
   • merchant_id,
   • order_id,
   • email,
   • delivery_country,
   • estimated_delivery_date,
   • la liste des produits sous forme de products[].gtin (GTIN/EAN récupéré depuis l’attribut produit).
7. Prend en charge un commentaire / une section d’informations supplémentaires (si vous l’utilisez)
   La mise en page prévoit un bloc supplémentaire pour un commentaire / contenu personnalisé (custom.comment). Vous pouvez ainsi ajouter des messages adaptés au processus de vente (par exemple une demande de contact pour les commandes atypiques, une information sur la personnalisation, etc.).
8. Il est léger et sûr pour le processus de commande
   Le module n’interfère pas avec la passation de commande ni avec les paiements — il modifie uniquement la couche de présentation de la page de succès. Ainsi :
   • il est facile à déployer,
   • il est facile à désactiver (retour à la vue standard),
   • le risque de conflits dans le checkout est minimal.

Principaux avantages (réellement issus du code)

• Configuration simple : activation/désactivation + choix d’un bloc CMS à afficher sur la page de succès.

• Fonctionne par store view (scope : default/website/store).

• Rendu CMS performant : le contenu du bloc est filtré par le filtre CMS standard (directives, variables) et mis en cache (24 h par défaut) avec une clé dépendante de la boutique.

• Sans conflit avec le module plus complet : s’il détecte un Kowal_ThankYouPage actif (et activé dans la configuration), alors :

  • l’option dans le panneau est « verrouillée » (disabled),

  • et la page de succès reste sous le contrôle de ce module plus complet.

• Aucune table ni modification de base de données : l’installation est légère (layout + blocs + configuration).

Configuration dans Magento

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

• Custom Order Success Page : active/désactive la page de succès personnalisée (lorsqu’elle est désactivée, la page Magento par défaut revient)

• Success Page Custom Block : choix du bloc CMS à afficher après les détails de la commande