Checkout Success Page: página de agradecimento com bloco CMS próprio + detalhes da encomenda (Magento 2)
- Compatibilidade
- 2.4.9, 2.4.8, 2.4.7, 2.4.6, 2.4.5, 2.4.4, 2.4.3, 2.4.2, 2.4.1, 2.4.0, 2.3.7, 2.3.6, 2.3.5, 2.3.4
Descrição / Checkout Success Page: página de agradecimento com bloco CMS próprio + detalhes da encomenda (Magento 2)
MAGENTO 2 · APÓS A COMPRA · RESUMO · CONTEÚDOS CMS
Transforme a confirmação de compra num resumo claro.
Kowal Checkout Thank You Page
Mostre ao cliente os detalhes da encomenda, os produtos e os valores juntamente com o seu próprio bloco CMS. Explique o que acontece a seguir e adicione informações úteis na página de agradecimento.
Detalhes da encomenda · Bloco CMS próprio · Google Opiniões opcional
COMO FUNCIONA NA PRÁTICA
01 · Prepara o conteúdo CMS
Adiciona instruções, contacto e informações pós-compra.
02 · Ativa a página de sucesso
Escolhe o bloco e as definições para a vista da loja.
03 · O cliente vê o resumo
Após a encomenda, recebe os detalhes e os passos seguintes.
O que ganha a sua loja?
Conheça as funcionalidades, a utilização e as definições do módulo.
Para que serve este módulo?
A página Thank You Page padrão no Magento termina muitas vezes o percurso do cliente com uma mensagem curta e o número da encomenda. Este módulo transforma a página de sucesso num ponto útil de comunicação pós-compra, sem builders pesados e sem reconstruir o checkout.
O que faz o módulo Kowal_CheckoutThankYouPage?
O módulo Kowal_CheckoutThankYouPage expande a página Thank You Page padrão no Magento 2 e transforma-a num ecrã claro de resumo da encomenda, com possibilidade de adicionar conteúdos próprios de marketing e informação. Funciona com base no layout da página de sucesso e nos blocos Magento padrão, pelo que é leve, compatível e seguro de manter.
Organiza e transfere os elementos padrão do Magento para uma nova disposição
- mensagens de sucesso (checkout.success) e registo após a compra (checkout.registration) para um contentor dedicado da página,
- mensagens padrão, como avisos, erros e confirmações, para uma secção clara no topo da página.
Apresenta todos os detalhes da encomenda num só local
- informações básicas da encomenda, como número e data,
- blocos de informação da encomenda baseados em componentes nativos do Magento, por exemplo Magento\Sales\Block\Order\Info,
- resumo completo do conteúdo da encomenda.
Mostra a lista de produtos da encomenda, items, e o resumo completo dos valores, totals
- a lista de itens da encomenda (Magento\Sales\Block\Order\Items) juntamente com os renderers (sales_order_item_renderers, sales_order_item_price),
- o resumo completo dos custos (Magento\Sales\Block\Order\Totals) com configuração de estilo label/value,
- impostos (Magento\Tax\Block\Sales\Order\Tax),
- e, se a loja funcionar em Magento EE e a configuração estiver disponível, a secção gift cards, condicionalmente através de ifconfig='giftcard/email/identity'.
Adiciona espaço extra para conteúdos de outros módulos, container
- order.success.additional.info
Apresenta um bloco CMS próprio na página de sucesso, configurável
No bloco CMS pode colocar, por exemplo:
- instruções sobre o que acontece a seguir, como processamento, prazos e contacto,
- informações sobre devoluções e reclamações,
- banner promocional / código de desconto para compras futuras,
- links para FAQ ou páginas de ajuda,
- cross-sell descritivo, por exemplo escolha acessórios para a sua compra.
(Opcional) Adiciona Google Opiniões dos Consumidores, Google Customer Reviews – Survey Opt-in
Isto permite recolher opiniões de forma compatível com o mecanismo da Google, sem inserir manualmente os dados no template.
A integração preenche automaticamente os dados necessários para gapi.surveyoptin.render(), incluindo:- merchant_id,
- order_id,
- email,
- delivery_country,
- estimated_delivery_date,
- a lista de produtos como products[].gtin (GTIN/EAN obtido a partir do atributo do produto).
Suporta comentário / secção de informações adicionais, se utilizar
É leve e seguro para o processo de encomenda
- é fácil de implementar,
- é fácil de desativar, voltando à vista padrão,
- o risco de conflitos no checkout é mínimo.
Principais vantagens, realmente resultantes do código
Configuração simples: ativar/desativar + escolha de um bloco CMS para apresentar na página de sucesso.
Funciona por store view (scope: default/website/store).
Renderização CMS eficiente: o conteúdo do bloco é filtrado pelo filtro CMS padrão, diretivas e variáveis, e colocado em cache, por defeito 24 h, com uma chave dependente da loja.
Cooperação com um módulo maior: se detetar o Kowal_ThankYouPage ativo, e ativado na configuração, então:
a opção no painel fica congelada, disabled,
e a página de sucesso permanece sob o controlo desse módulo maior.
Sem tabelas nem alterações na base de dados: a instalação é leve, layout + blocos + configuração.
Configuração no Magento
Caminho: Stores → Configuration → Kowal Checkout → Order Success Page
Custom Order Success Page: ativa/desativa a página de sucesso própria, quando desativada regressa a página padrão do Magento
Success Page Custom Block: escolha do bloco CMS a apresentar após os detalhes da encomenda
Conteúdo CMS e dados da encomenda
Em Stores → Configuration → Kowal Checkout → Order Success Page ativa Custom Order Success Page e escolhe Success Page Custom Block. O bloco deve estar ativo; o seu conteúdo é filtrado pelo mecanismo CMS do Magento.
O CMS tem uma duração de cache padrão de 86400 segundos e uma chave que inclui a loja. Utilize nele conteúdos comuns aos clientes de uma determinada vista, por exemplo instruções de processamento e contacto. Os detalhes de uma encomenda concreta são renderizados em blocos separados, sem cache da página.
Google Opiniões — definições e dados da integração
O Survey Opt-in opcional requer ativação e introdução do Merchant ID. Também define o número de dias da entrega estimada e o código do atributo GTIN/EAN. O módulo envia o número da encomenda, e-mail, país, data estimada e identificadores dos produtos para o script da Google.
A data é calculada como o dia da apresentação + o número de dias configurado; não provém de um cálculo da transportadora. O código obtém o país de entrega com fallback para o de faturação, itens visíveis e até 50 GTIN únicos. Parte dos campos de configuração adicionais não altera este fluxo na implementação verificada.
Merchant Widget Google opcional
O pacote inclui também o Merchant Widget nas páginas da loja. No grupo Merchant Widget (Google) define um interruptor separado, Merchant ID, posição LEFT_BOTTOM ou RIGHT_BOTTOM, espaçamentos desktop/mobile e região opcional.
O widget e o Survey Opt-in estão desativados por defeito. A visibilidade das funcionalidades Google depende também da conta, de dados corretos e do carregamento de scripts externos.
Dependências e cooperação com outras extensões
O pacote requer kowal/base e kowal/module-checkout. A deteção de Kowal_ThankYouPage ativo pode transferir-lhe o controlo da página de sucesso e bloquear o interruptor da página própria no painel.
O contentor order.success.additional.info permite adicionar blocos próprios. A secção custom.comment lê o comentário da encomenda, se tiver sido guardado pelo processo ou extensão utilizada. O módulo em si não adiciona um campo de comentário no checkout.
Instalação via Composer
Pacote kowal/module-checkoutthankyoupage, módulo Kowal_CheckoutThankYouPage. Depois de configurar o acesso ao repositório Kowal, instale o pacote, ative o módulo, atualize o Magento e limpe a cache. Em produção, inclua a compilação e a implementação de conteúdos estáticos de acordo com o processo da loja.
Da configuração ao resultado
1. Prepara o conteúdo CMS
Adiciona instruções, contacto e informações pós-compra.
2. Ativa a página de sucesso
Escolhe o bloco e as definições para a vista da loja.
3. O cliente vê o resumo
Após a encomenda, recebe os detalhes e os passos seguintes.
O que acontece a seguir com a minha encomenda?
Além dos produtos e do resumo dos valores, o cliente vê instruções de processamento, contacto do apoio, link para o FAQ e informações sobre devoluções.
Atualiza o conteúdo no CMS. Pode adicionar um código opcional para compras futuras ou uma descrição de acessórios como mensagem própria; o módulo não cria por si só uma regra de desconto nem recomendações de produtos.
Cuide da comunicação após a realização da encomenda
Quer adaptar o módulo à sua loja? Peça a implementação do Kowal Checkout Thank You Page e fale connosco sobre a configuração ou as extensões necessárias.
Mais informação
| Compatibilidade com o modelo | Luma / Blank, KOWAL |
|---|
Change Log
Versão: 1.0.13
12.02.2026
Adicionado
- Integração **Google Customer Reviews (Survey Opt-in)** na página de agradecimento após a encomenda (Success Page).
- Novo template: `view/frontend/templates/onepage/google_opinie.phtml`, que carrega `platform.js` e renderiza `gapi.surveyoptin.render()`.
- Novo bloco: `Kowal\CheckoutThankYouPage\Block\Onepage\Success\GoogleOpinie`, que gera o payload para a Google (merchant_id, order_id, email, delivery_country, estimated_delivery_date, products[].gtin).
- Adição do bloco ao layout da página de sucesso (Success Page), com `cacheable='false'`, dados por encomenda.
Configuração
- Expansão de `system.xml` com a secção de configuração das opiniões Google:
- Ativar/desativar a integração.
- `merchant_id` (Merchant Center ID).
- `estimated_delivery_days` (cálculo da data de entrega).
- `gtin_attribute` (código do atributo GTIN/EAN no produto).
- Opções da origem do país de entrega (shipping/billing).
- Limite do número de produtos no payload.
- Adicionados valores padrão em `etc/config.xml`.
- Adicionado ACL para a configuração, permissões para a secção no painel.
Notas
- A integração é executada apenas na página de sucesso após a realização da encomenda e baseia-se na última encomenda da sessão de checkout.
- Na ausência dos dados obrigatórios, por exemplo merchant_id, o bloco não renderiza o script opt-in.
Manual de instalação do módulo
Instalação via Composer
Receberá por e-mail, após a compra, os dados de acesso ao repositório Composer, endereço de e-mail do cliente e token de licença. Estes dados também estão disponíveis na área de cliente após iniciar sessão em kowal.store. Substitua TWOJ_EMAIL_KLIENTA pelo endereço de e-mail da sua conta e TWOJ_TOKEN pelo token recebido. Execute os comandos no diretório raiz do Magento.
composer config repositories.kowal composer https://repo.kowal.storecomposer config http-basic.repo.kowal.store 'TWOJ_EMAIL_KLIENTA' 'TWOJ_TOKEN'composer require kowal/module-checkoutthankyoupageConcluir a instalação
Depois de instalar o pacote, execute a atualização do Magento e limpe a cache:
php bin/magento setup:upgradephp bin/magento cache:flushEm ambiente de produção, execute também a compilação DI e a implementação dos ficheiros estáticos de acordo com o processo de deployment da loja.
Avaliações dos Clientes
Perguntas e respostas
Na toursport.pl, após a compra, os clientes procuravam frequentemente informações sobre “o que acontece a seguir” — onde consultar os detalhes da encomenda, como funciona a expedição/processamento e que produtos escolher como acessórios. A página de sucesso predefinida do Magento era demasiado limitada e não oferecia espaço para instruções claras.
Solução implementada
Aplicámos o módulo Kowal_CheckoutThankYouPage para:
manter todos os detalhes da encomenda na página de sucesso (itens, valores, dados),
adicionar na parte inferior um bloco CMS dedicado preparado para a toursport.pl.
No bloco CMS foram incluídos, entre outros:
uma breve instrução sobre “o que acontece a seguir” (email, prazo de processamento, contacto),
uma secção com links de ajuda (devoluções, reclamações, regulamento),
um banner a incentivar novas compras (por exemplo, acessórios / complementos),
uma mensagem comercial adaptada à marca.
Resultado
O cliente vê imediatamente não só o número da encomenda, mas também um conjunto completo de informações e instruções.
A equipa da loja pode editar o conteúdo sem intervenção de um programador — basta substituir o bloco CMS.
A solução é leve e segura: não interfere no processo de encomenda, apenas na vista de sucesso.