Checkout Success Page: página de agradecimento com bloco CMS próprio + detalhes da encomenda (Magento 2)

Para que serve este módulo?

A página predefinida “Thank You Page” 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 de comunicação útil após a compra, sem construtores pesados e sem reconstruir o checkout.

O que faz o módulo Kowal_CheckoutThankYouPage?

O módulo Kowal_CheckoutThankYouPage expande a página predefinida “Thank You Page” no Magento 2 e transforma-a num ecrã claro de resumo da encomenda, com a 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 standard do Magento, pelo que é leve, compatível e seguro de manter.

1. Organiza e move os elementos standard do Magento para um novo layout
   O módulo reúne num só local os principais elementos do Magento visíveis após a compra. Assim, o cliente vê uma vista coerente e organizada, sem elementos dispersos.:
   • mensagens de sucesso (checkout.success) e o registo após a compra (checkout.registration) num contentor dedicado da página,
   • as “messages” standard, como avisos, erros e confirmações, numa secção clara no topo da página.
2. Apresenta todos os detalhes da encomenda num só local
   A página de sucesso é ampliada com a secção Detalhes da encomenda, onde o cliente tem à mão tudo o que é mais importante. Isto reduz o número de pedidos ao apoio ao cliente, como onde consultar a encomenda?, e aumenta o conforto do cliente logo após a compra:
   • informações básicas sobre a encomenda, como número e data,
   • blocos de informação da encomenda baseados em componentes nativos do Magento, por exemplo MagentoSalesBlockOrderInfo,
   • resumo completo do conteúdo da encomenda.
3. Mostra a lista de produtos da encomenda, items, e o resumo completo dos valores, totals
   Resultado: o cliente vê um recibo claro da encomenda sem ter de entrar no painel da conta ou no e-mail. O módulo renderiza:
   • a lista de itens da encomenda (MagentoSalesBlockOrderItems) juntamente com os renderizadores (sales_order_item_renderers, sales_order_item_price),
   • o resumo completo dos custos (MagentoSalesBlockOrderTotals) com configuração de estilo label/value,
   • impostos (MagentoTaxBlockSalesOrderTax),
   • 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'.
4. Adiciona espaço extra para conteúdos de outros módulos, container
   O módulo disponibiliza um contentor, para que possa, ou para que outros módulos possam, injetar em segurança conteúdos adicionais na página de sucesso — por exemplo, informações de envio, CTA para a aplicação móvel, instruções B2B, etc. — sem editar o core.:
   • order.success.additional.info
5. Apresenta um bloco CMS próprio na página de sucesso, configurável
   Esta é uma das funções mais importantes do módulo: a possibilidade de indicar na configuração o bloco CMS que será renderizado na Thank You Page. O bloco CMS é renderizado pelo filtro CMS standard, pelo que nele funcionam as diretivas típicas do Magento, como widgets, variáveis, etc. Além disso, o módulo tem cache_lifetime definido, por exemplo 86400, para que os conteúdos estáticos não sobrecarreguem a página.
   No bloco CMS pode inserir, por exemplo:
   • instruções sobre o que fazer 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 adicionar acessórios à compra.
6. (Opcional) Adiciona Google Customer Reviews, Survey Opt-in
   Depois de ativada a função na configuração, o módulo pode apresentar na página de sucesso o script opt-in Google Customer Reviews, ou seja, um convite para deixar uma avaliação após a compra.
   

   Isto permite recolher avaliações de forma compatível com o mecanismo da Google, sem adicionar manualmente 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, com GTIN/EAN obtido do atributo do produto.
7. Suporta comentário / secção de informações adicionais, se utilizar
   No layout da página está previsto um bloco adicional para comentário / conteúdo próprio (custom.comment). Assim, pode adicionar mensagens adaptadas ao processo de venda, por exemplo pedido de contacto em encomendas atípicas, informação sobre personalização, etc.
8. É leve e seguro para o processo de encomenda
   O módulo não interfere na colocação da encomenda nem nos pagamentos — altera apenas a camada de apresentação da página de sucesso. Por isso:
   • é fácil de implementar,
   • é fácil de desativar, voltando à vista standard,
   • o risco de conflitos no checkout é mínimo.

Principais vantagens, diretamente resultantes do código

• Configuração simples: ativar/desativar + seleção 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 standard, diretivas e variáveis, e colocado em cache, por defeito 24h, com uma chave dependente da loja.

• Sem conflitos com o módulo mais amplo: se detetar 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 mais amplo.

• 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, volta a página predefinida do Magento

• Success Page Custom Block: seleção do bloco CMS a apresentar após os detalhes da encomenda