El módulo permite sustituir la página de agradecimiento predeterminada después de un pedido en Magento 2 por una versión ampliada con todos los detalles del pedido y un bloque CMS configurable, por ejemplo instrucciones, banner, código de descuento, enlaces o upsell.
Descripción /
Checkout Success Page: Thank You Page con bloque CMS propio + detalles del pedido (Magento 2)
MAGENTO 2 · DESPUÉS DE LA COMPRA · RESUMEN · CONTENIDO CMS
Convierte la confirmación de compra en un resumen claro.
Kowal Checkout Thank You Page
Muestra al cliente los detalles del pedido, productos e importes junto con tu propio bloque CMS. Explica qué ocurrirá a continuación y añade información útil en la página de agradecimiento.
Detalles del pedido · Bloque CMS propio · Reseñas de Google opcionales
CÓMO FUNCIONA EN LA PRÁCTICA
01 · Preparas el contenido CMS Añades instrucciones, contacto e información posterior a la compra.
02 · Activas la página de confirmación Seleccionas el bloque y los ajustes de la vista de tienda.
03 · El cliente ve el resumen Tras el pedido recibe los detalles y los siguientes pasos.
¿Qué gana tu tienda?
Descubre las funciones, el uso y la configuración del módulo.
¿Para qué sirve este módulo?
La página «Thank You Page» predeterminada de Magento suele terminar el recorrido del cliente con un mensaje breve y el número del pedido. Este módulo transforma la página de confirmación en un punto útil de comunicación después de la compra, sin editores pesados ni reconstruir el checkout.
¿Qué hace el módulo Kowal_CheckoutThankYouPage ?
El módulo Kowal_CheckoutThankYouPage amplía la página «Thank You Page» predeterminada de Magento 2 y la convierte en una pantalla clara de resumen del pedido con la posibilidad de añadir contenido propio de marketing e información. Se basa en el layout de la página de confirmación y en bloques estándar de Magento, por lo que es ligero, compatible y seguro de mantener.
Organiza y traslada los elementos estándar de Magento a un nuevo layout
El módulo reúne en un único lugar los elementos clave de Magento visibles tras la compra. El cliente obtiene una vista coherente y ordenada, sin elementos dispersos:
los mensajes de confirmación (checkout.success) y registro después de la compra (checkout.registration) a un contenedor específico de la página,
los «messages» estándar, como advertencias, errores y confirmaciones, a una sección clara en la parte superior de la página.
Muestra todos los detalles del pedido en un único lugar
La página de confirmación se amplía con la sección Order Details, donde el cliente tiene a mano lo más importante. Esto reduce las consultas a atención al cliente sobre dónde comprobar el pedido y mejora la comodidad inmediatamente después de la compra:
información básica del pedido, como número y fecha,
bloques de información del pedido basados en componentes nativos de Magento, por ejemplo, Magento\Sales\Block\Order\Info),
un resumen completo del contenido del pedido.
Muestra los productos del pedido (items) y el resumen completo de importes (totals)
El cliente ve un recibo claro del pedido sin acceder a su cuenta o al correo. El módulo renderiza:
la lista de líneas del pedido (Magento\Sales\Block\Order\Items) con sus renderizadores (sales_order_item_renderers, sales_order_item_price),
el resumen completo de costes (Magento\Sales\Block\Order\Totals) con configuración de estilos label/value,
los impuestos (Magento\Tax\Block\Sales\Order\Tax),
y, si la tienda utiliza Magento EE y la configuración está disponible, la sección gift cards, condicionada por ifconfig="giftcard/email/identity".
Añade espacio adicional para contenido de otros módulos (container)
El módulo proporciona un contenedor para que tú u otros módulos podáis insertar contenido adicional en la página de confirmación de forma segura, como información de envío, una llamada a descargar la aplicación móvil o instrucciones B2B, sin editar el core:
order.success.additional.info
Muestra un bloque CMS propio en la página de confirmación (configurable)
Una de las funciones principales del módulo es poder seleccionar en la configuración un bloque CMSque se renderiza en la Thank You Page. El bloque pasa por el filtro CMS estándar, por lo que admite las directivas habituales de Magento, como widgets y variables. Además, el módulo establece cache_lifetime, por ejemplo, 86400, para que el contenido estático no sobrecargue la página. En el bloque CMS puedes incluir, por ejemplo:
instrucciones sobre los siguientes pasos, preparación, plazos y contacto,
información sobre devoluciones y reclamaciones,
un banner promocional o un código de descuento para futuras compras,
enlaces a preguntas frecuentes o páginas de ayuda,
cross-sell descriptivo, como «elige accesorios para tu compra».
Añade opcionalmente Reseñas de Clientes en Google (Google Customer Reviews – Survey Opt-in)
Tras activar la función en la configuración, el módulo puede mostrar en la página de confirmación el script de participación de Google Customer Reviews, una invitación a dejar una reseña después de la compra.
Permite recopilar reseñas mediante el mecanismo de Google sin añadir manualmente datos a la plantilla.
La integración completa automáticamente los datos necesarios para gapi.surveyoptin.render(), entre otros:
merchant_id,
order_id,
email,
delivery_country,
estimated_delivery_date,
la lista de productos como products[].gtin (GTIN/EAN obtenido del atributo de producto).
Admite comentarios o una sección de información adicional, si se utiliza
El layout de la página incluye un bloque adicional para comentarios o contenido propio (custom.comment). Así puedes añadir mensajes adaptados al proceso de venta, como una solicitud de contacto para pedidos especiales o información sobre personalización.
Es ligero y seguro para el proceso de pedido
El módulo no interviene en la creación del pedido ni en los pagos; cambia únicamente la presentación de la página de confirmación. Por ello:
es fácil de implementar,
es fácil de desactivar y volver a la vista estándar,
el riesgo de conflictos en el checkout es mínimo.
Principales ventajas, derivadas realmente del código
Configuración sencilla: activar o desactivar y seleccionar un bloque CMS para mostrar en la página de confirmación.
Funciona por vista de tienda (scope: default/website/store).
Renderizado CMS eficiente: el contenido del bloque se filtra con el filtro CMS estándar, directivas y variables, y se almacena en caché, por defecto 24 h, con una clave dependiente de la tienda.
Sin conflictos con un módulo más avanzado: si detecta Kowal_ThankYouPage y está activado en la configuración:
la opción del panel queda bloqueada (disabled),
y la página de confirmación permanece bajo el control de ese módulo más amplio.
Sin tablas ni cambios en la base de datos: instalación ligera mediante layout, bloques y configuración.
Custom Order Success Page: activar/desactivar la página de éxito propia; cuando está desactivada, vuelve la página predeterminada de Magento
Success Page Custom Block: selección del bloque CMS que aparece después de los detalles del pedido
Contenido CMS y datos del pedido
En Stores → Configuration → Kowal Checkout → Order Success Page activas Custom Order Success Page y seleccionas Success Page Custom Block. El bloque debe estar activo; su contenido se filtra mediante el mecanismo CMS de Magento.
El CMS tiene una duración predeterminada de caché de 86400 segundos y una clave que incluye la tienda. Utiliza contenido común para los clientes de esa vista, como instrucciones de preparación y contacto. Los detalles de cada pedido se renderizan en bloques separados sin caché de página.
Reseñas de Google: ajustes y datos de integración
El Survey Opt-in opcional requiere activarlo e introducir el Merchant ID. También configuras el número de días de entrega estimada y el código del atributo GTIN/EAN. El módulo transmite al script de Google el número de pedido, el correo, el país, la fecha estimada y los identificadores de productos.
La fecha se calcula como el día de presentación más el número de días configurado; no procede de un cálculo del transportista. El código obtiene el país de envío, utilizando el de facturación como alternativa, las líneas visibles y hasta 50 GTIN únicos. Algunos campos adicionales de configuración no cambian este flujo en la implementación revisada.
Merchant Widget de Google opcional
El paquete también incluye Merchant Widget en las páginas de la tienda. En el grupo Merchant Widget (Google) configuras un interruptor independiente, Merchant ID, la posición LEFT_BOTTOM o RIGHT_BOTTOM, los márgenes para escritorio y móvil y una región opcional.
El widget y Survey Opt-in están desactivados por defecto. La visibilidad de las funciones de Google también depende de la cuenta, de datos correctos y de la carga de scripts externos.
Dependencias y colaboración con otras extensiones
El paquete requiere kowal/base y kowal/module-checkout. Detectar un Kowal_ThankYouPage activo puede cederle el control de la página de confirmación y bloquear en el panel el interruptor de la página propia.
El contenedor order.success.additional.info permite añadir bloques propios. La sección custom.comment lee el comentario del pedido si lo guardó el proceso o la extensión utilizada. El módulo no añade por sí solo un campo de comentario en el checkout.
Instalación mediante Composer
Paquete kowal/module-checkoutthankyoupage, módulo Kowal_CheckoutThankYouPage. Tras configurar el acceso al repositorio de Kowal, instala el paquete, activa el módulo, actualiza Magento y limpia la caché. En producción, ten en cuenta la compilación y el despliegue de contenido estático de acuerdo con el proceso de la tienda.
De la configuración al resultado
1. Preparas el contenido CMS Añades instrucciones, contacto e información posterior a la compra.
2. Activas la página de confirmación Seleccionas el bloque y los ajustes de la vista de tienda.
3. El cliente ve el resumen Tras el pedido recibe los detalles y los siguientes pasos.
¿Qué ocurre ahora con mi pedido?
Junto a los productos y el resumen de importes, el cliente ve instrucciones de preparación, contacto con atención al cliente, un enlace a preguntas frecuentes e información sobre devoluciones.
Actualizas el contenido en el CMS. Puedes añadir un código para futuras compras o una descripción de accesorios como mensaje propio; el módulo no crea por sí mismo una regla de descuentos ni recomendaciones de productos.
Cuida la comunicación después de realizar el pedido
Integración **Google Customer Reviews (Survey Opt-in)** en la página de agradecimiento tras el pedido (Success Page).
Nueva plantilla: `view/frontend/templates/onepage/google_opinie.phtml` que carga `platform.js` y renderiza `gapi.surveyoptin.render()`.
Nuevo bloque: `Kowal\CheckoutThankYouPage\Block\Onepage\Success\GoogleOpinie` que genera el payload para Google (merchant_id, order_id, email, delivery_country, estimated_delivery_date, products[].gtin).
Adición del bloque al layout de la página de éxito (Success Page), con `cacheable='false'` (datos por pedido).
Configuración
Ampliación de `system.xml` con la sección de configuración de reseñas de Google:
Activar/desactivar la integración.
`merchant_id` (Merchant Center ID).
`estimated_delivery_days` (cálculo de la fecha de entrega).
`gtin_attribute` (código del atributo GTIN/EAN en el producto).
Opciones de origen del país de entrega (shipping/billing).
Límite del número de productos en el payload.
Se han añadido valores predeterminados en `etc/config.xml`.
Se ha añadido ACL para la configuración (permisos de la sección en el panel).
Notas
La integración se ejecuta únicamente en la página de éxito después de realizar el pedido y se basa en el último pedido de la sesión de checkout.
Si faltan datos obligatorios (p. ej., merchant_id), el bloque no renderiza el script opt-in.
Instrucciones de instalación del módulo
Instalación mediante Composer
Recibirás por correo electrónico los datos de acceso al repositorio Composer (dirección de e-mail del cliente y token de licencia) después de la compra. También están disponibles en el panel de cliente tras iniciar sesión en kowal.store. Sustituye TWOJ_EMAIL_KLIENTA por la dirección de e-mail de tu cuenta y TWOJ_TOKEN por el token recibido. Ejecuta los comandos en el directorio raíz de Magento.
En el entorno de producción, realiza también la compilación DI y el despliegue de archivos estáticos de acuerdo con el proceso de despliegue de la tienda.
Plus za to, że nie gryzie się z innymi modułami — u mnie działa per store view bez problemu.
Calidad
5
Precio
5
Asistencia
5
Lepsze ‘po zakupie’ bez przebudowy checkoutu
Comentario poranna
Dodaliśmy blok CMS z informacją o dostawie i zwrotach oraz banner z kolejną ofertą. Zero kombinowania w layoutach ręcznie.
Precio
3
Calidad
3
Asistencia
5
Prosto ale skutecznie
Comentario porbartek.dev
Dokładnie tego potrzebowałem — jedna konfiguracja i mam własną treść na stronie sukcesu. Klient od razu widzi instrukcje i linki, a nie tylko numer zamówienia
3 artículo(s)
Escribe tu propia reseña
Preguntas y respuestas
Pregunta
¿Qué puedo mostrar exactamente en la página de agradecimiento?
Respuesta
El módulo muestra la información estándar del pedido + la vista completa de los artículos y el resumen, y además permite insertar cualquier bloque CMS (banner, instrucciones, CTA, contenidos de marketing).
Pregunta
¿Puedo configurar un contenido diferente para distintas tiendas / versiones de idioma?
Respuesta
Sí. Los ajustes están disponibles en el ámbito Website/Store View, por lo que puedes indicar un bloque CMS diferente para cada versión de la tienda.
Pregunta
¿Se puede desactivar rápidamente el módulo y volver a la vista estándar de Magento?
Respuesta
Sí: en la configuración basta con desactivar “Custom Order Success Page” y el módulo mostrará la página de confirmación predeterminada de Magento.
Pregunta
¿El módulo es seguro en términos de rendimiento?
Respuesta
Sí — el contenido del bloque CMS se almacena en caché (por defecto 86400s) y depende de la vista de tienda, por lo que no sobrecarga innecesariamente la página.
Caso práctico – implementación en el proyecto toursport.pl
En toursport.pl, tras la compra, los clientes a menudo buscaban información sobre «qué sigue»: dónde consultar los detalles del pedido, cómo es el envío/la tramitación y qué productos elegir como accesorios. La página de éxito predeterminada de Magento era demasiado básica y no ofrecía espacio para una instrucción clara.
Solución implementada
Utilizamos el módulo Kowal_CheckoutThankYouPage para:
mantener todos los detalles del pedido en la página de éxito (artículos, importes, datos),
añadir en la parte inferior un bloque CMS dedicado preparado para toursport.pl.
En el bloque CMS se incluyeron, entre otros:
una breve instrucción sobre «qué sigue» (correo electrónico, plazo de tramitación, contacto),
una sección con enlaces de ayuda (devoluciones, reclamaciones, términos y condiciones),
un banner que anima a realizar nuevas compras (p. ej., accesorios / complementos),
un mensaje comercial adaptado a la marca.
Resultado
El cliente ve de inmediato no solo el número de pedido, sino también toda la información e instrucciones.
El equipo de la tienda puede editar el contenido sin la participación de un programador: basta con sustituir el bloque CMS.
La solución es ligera y segura: no interfiere en el proceso de pedido, solo en la vista de éxito.
