Checkout Comment - Adicione um comentário à encomenda no Magento 2
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.
- Registo automático do comentário na base de dados.
- Apresentação do comentário nos detalhes da encomenda no painel de administração.
- Coluna Checkout Comment na grelha de encomendas no Magento Admin.
- Possibilidade de ativar e desativar o módulo na configuração do Magento.
- Otimização SEO - melhoria da qualidade do atendimento ao cliente e melhor gestão de encomendas.
Utilização
O módulo é indicado para lojas Magento que pretendem permitir aos clientes transmitir informações adicionais ao efetuar uma encomenda, por exemplo:
- Informações sobre a entrega, por exemplo, Por favor, entregar depois das 18:00
- Notas sobre a embalagem, por exemplo, Embrulhar como presente
- Observações especiais sobre a encomenda
Configuração e gestão
O módulo permite gerir totalmente os 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 desenvolvido de acordo com as diretrizes oficiais do Magento 2. Não interfere com o código principal do processo de venda e não requer alterações ao carrinho. Desta forma, garante total compatibilidade com futuras atualizações do Magento e com outros módulos que expandem o checkout.
Instalação e implementação
Para instalar o módulo, basta:
- Instale o módulo: - Adicione o repositório composer à configuração, executando
composer config repositories.project.checkout.comment vcs https://gitlab.com/magento2ext/magento-2-checkout-comment
Adicione o token de acesso ao repositório privado GitLabcomposer config --auth gitlab-token.gitlab.com <YOUR_TOKEN>
Instale o módulo composer executandocomposer require kowal/module-checkoutcomment
Ative o módulo executandophp bin/magento module:enable Kowal_CheckoutComment
- Execute os comandos:
bin/magento setup:upgrade bin/magento setup:di:compile bin/magento cache:flush bin/magento indexer:reindex sales_order_grid
- Aceda a Kowal.co → Checkout Comment → Definições e ative o módulo.
Versão: 1.0.1
28.01.2025
Correção
Melhoria do registo 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 fosse possível gerar o comentário na confirmação da encomenda enviada ao cliente. Agora, ao adicionar este código ao 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
- Adicionado o registo 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 para adicionar uma entrada ao histórico de estados da encomenda.













