Checkout Comment - Adicione um comentário à encomenda no 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
Descrição / Checkout Comment - Adicione um comentário à encomenda no Magento 2
MAGENTO 2 · CHECKOUT · GESTÃO DE ENCOMENDAS
Dê ao cliente um espaço para notas importantes sobre a encomenda.
Kowal Checkout Comment
Adicione um campo de comentário na etapa de pagamento e encaminhe o seu conteúdo para a equipa responsável pela preparação das encomendas. As notas guardadas ficam disponíveis no Magento Admin e no histórico de encomendas.
Campo no checkout · Coluna de encomendas · Histórico e REST API
COMO FUNCIONA NA PRÁTICA
01 · Ativa o campo
Ativa o módulo na configuração do Magento.
02 · O cliente introduz uma nota
Adiciona uma instrução de entrega ou embalagem à encomenda.
03 · A equipa lê o comentário
Utiliza os detalhes da encomenda e a coluna no painel.
O que ganha a sua loja?
Conheça as funcionalidades, a utilização e as definições do módulo.
Conheça o módulo
O módulo Checkout Comment para Magento 2 permite adicionar um campo para o comentário do cliente durante a realização da encomenda. O comentário é guardado na base de dados, apresentado no painel de administração e disponível no histórico de encomendas.
Principais funcionalidades
- Adição de um campo de comentário na página de pagamento no Magento 2.
- Gravação automática do comentário na base de dados.
- Apresentação do comentário nos detalhes da encomenda no painel de administrador.
- Coluna Checkout Comment na grelha de encomendas no Magento Admin.
- Possibilidade de ativar e desativar o módulo na configuração do Magento.
- Melhoria da qualidade do atendimento ao cliente e da gestão de encomendas. O tema de SEO não significa uma funcionalidade separada de otimização para motores de pesquisa neste módulo.
Utilização
O módulo é útil para lojas Magento que pretendem permitir aos clientes enviar informações adicionais com a encomenda, por exemplo:
- Informações sobre a entrega, por exemplo, «Entregar após as 18:00»
- Notas sobre a embalagem, por exemplo, «Embalar como presente»
- Notas especiais para a encomenda
Configuração e gestão
O módulo permite a gestão completa dos comentários dos clientes através do painel de administração do Magento 2. Pode:
- Ativar ou desativar o campo de comentário na configuração do Magento.
- Consultar comentários na lista de encomendas no painel de administração.
- Pesquisar e ordenar encomendas pelo conteúdo dos comentários.
Compatibilidade com Magento 2
O módulo foi concebido de acordo com as diretrizes oficiais do Magento 2. Não interfere com o código base do processo de venda e não requer modificações no carrinho. A compatibilidade com futuras atualizações do Magento e com módulos adicionais de checkout deve ser verificada para a versão e configuração específicas da loja.
Comentário em integrações e na confirmação
A REST API disponibiliza o comentário através de extension_attributes.checkout_comment para uma encomenda individual e para a lista de encomendas. O modelo de e-mail pode utilizar a variável order_comment.
Em Stores → Configuration → Kowal → Checkout Comment, ativa o módulo e a opção de adicionar comentários do sistema à confirmação. A ativação do campo, a gestão da grelha e a utilização do comentário no modelo de e-mail permitem adaptar o fluxo de informação à loja.
Instalação via Composer
Pacote kowal/module-checkoutcomment, módulo Kowal_CheckoutComment. 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. Ativa o campo
Ativa o módulo na configuração do Magento.
2. O cliente introduz uma nota
Adiciona uma instrução de entrega ou embalagem à encomenda.
3. A equipa lê o comentário
Utiliza os detalhes da encomenda e a coluna no painel.
A instrução de embalagem chega à equipa de apoio
O cliente introduz «Embalar como presente» ou «Entregar após as 18:00». A equipa de apoio lê a nota associada à encomenda e pode tê-la em conta de acordo com as possibilidades da loja e da transportadora.
Garanta instruções claras dos clientes
Quer adaptar o módulo à sua loja? Pergunte sobre a implementação do Kowal Checkout Comment 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.1
28.01.2025
Correção
Correção da gravação do comentário no histórico de comentários da encomenda
Versão: 1.0.7
12.08.2025
Correção
Expandimos o módulo para que seja possível gerar o comentário na confirmação de encomenda enviada ao cliente. Agora, ao adicionar este código no modelo:
{{if order_comment}} Komentarz do zamówienia:
{{var order_comment|escape|nl2br}}
{{/if}}O comentário do cliente será adicionado à confirmação da encomenda.
Versão: 1.0.15
03.03.2026
Correção
- Corrigida a sincronização do campo checkout_comment com a tabela sales_order_grid.
- O comentário do checkout está agora corretamente visível na coluna da grelha de encomendas no painel de administração.
Adicionado
- Adicionada a gravação do comentário do cliente no histórico de comentários da encomenda, Comments History, na pré-visualização da encomenda.
- O comentário é adicionado automaticamente durante a realização da encomenda e marcado como sem notificação ao cliente.
Técnico
- Adicionado o mapeamento da coluna checkout_comment na configuração Order Grid (di.xml), para que a grelha obtenha os dados de sales_order.checkout_comment.
- Expandido o observer sales_model_service_quote_submit_before com a adição de uma entrada ao histórico de estados da encomenda.
Manual de instalação do módulo
Instalação e implementação
Para instalar o módulo, basta:
- Instalar o módulo: - Adicione o repositório Composer à configuração executando
Receberá os dados de acesso ao repositório Composer, o endereço de e-mail do cliente e o token de licença, por e-mail após a compra. Também estão disponíveis no painel de cliente depois de iniciar sessão em kowal.store. Substitua
TWOJ_EMAIL_KLIENTApelo endereço de e-mail da sua conta eTWOJ_TOKENpelo token recebido. Execute os comandos no diretório raiz do Magento.composer config repositories.kowal composer https://repo.kowal.store
Configure o acesso ao repositório Composer Kowalcomposer config http-basic.repo.kowal.store 'TWOJ_EMAIL_KLIENTA' 'TWOJ_TOKEN'
Instale o módulo Composer executandocomposer require kowal/module-checkoutcomment
Ative o módulo executandophp bin/magento module:enable Kowal_CheckoutComment
- Executar os comandos:
bin/magento setup:upgrade bin/magento setup:di:compile bin/magento cache:flush bin/magento indexer:reindex sales_order_grid
- Aceder a Kowal.co → Checkout Comment → Definições e ativar o módulo.