Magento 2

Como sobrescrever um template “phtml” no Magento 2

Como sobrescrever um template “phtml” no 2 utilizando um Módulo e arquivo xml de layout.

Uma das tarefas mais comuns para um desenvolvedor do é substituir um template por uma versão customizada.

O Magento 2 torna essa tarefa fácil na maioria dos casos, mas há alguns casos que deixarão você se perguntando se é mesmo possível fazer isso.

Primeiro o módulo

Neste exemplo irei utilizar um módulo como base para fazer o override.

Caso você não saiba como criar uma estrutura básica de um módulo no Magento 2 clique neste link: Como criar um Módulo no Magento 2

Neste exemplo iremos substituir o template “phtml” da lista de desejos “wishlist”.

Utilizando o Layout Block Argument

Layout: O Magento implementa o padrão de arquitetura Model-view-controller; o que significa que o software Magento é projetado em camadas, incluindo a camada de exibição.

A maior parte da camada de exibição do Magento é o layout. Funcionalmente, o layout é uma estrutura de página, representada por hierarquia de elementos (árvore de elementos), que pode ser de dois tipos: blocos e contêineres.

Tecnicamente, o layout é definido nos arquivos .xml, que contêm declarações de elementos e instruções de manipulação de elementos.

Vamos ao código..

Usando o diretório de um módulo como base crie o seguinte arquivo e pastas necessárias.

view//layout/wishlist_index_index.xml

Ficando:

Vendor/Module/view/frontend/layout/wishlist_index_index.xml

Conteúdo do wishlist_index_index.xml

Vendor_Module::view.phtml

Repare no caminho: Vendor_Module::view.phtml

Utilizando um argumento passamos o novo arquivo de template que desejamos utilizar.

Para concluir, vamos criar agora o arquivo view.phtml no seguinte diretório.

view/frontend/templates/view.phtml

Não esqueça de alterar Vendor_Module:: de acordo com seu módulo.

Esvazie o da loja e verifique se o novo template está sendo utilizado.

Outros templates

Para alterar outros templates você devera alterar o nome do bloco de referência e do arquivo de layout xml, exemplo:

Formulário de login:

...
  
    ...

E nome do arquivo de layout xml: customer_account_login.xml

Para versões antigas do Magento 2

Código obsoleto para sobrescrever um template nas primeiras versões do 2.0

Vendor_Module::view.phtml

Conclusão de como sobrescrever um template

Código acima não funcionou no seu ambiente de desenvolvimento? Testado nas versões 2.1.x e 2.0.x.

Dúvidas? Faça um comentário ou entre em contato.

Bom desenvolvimento!

Post Recentes

Por que devo sempre manter o Magento 2 atualizado?

Segurança: Atualizações frequentes geralmente incluem patches de segurança para corrigir vulnerabilidades identificadas. Ao manter o Magento atualizado, você reduz significativamente…

2 meses atrás

Adicionar uma mensagem de Alerta ou Aviso do Admin do Magento 2

Como adicionar uma mensagem de Alerta ou Aviso do Admin do Magento 2 Injete o Magento\Framework\Message\ManagerInterface no construtor da sua…

2 meses atrás

Exibir mensagens erro/sucesso da Classe: Magento\Framework\Message\ManagerInterface

Para exibir as mensagens adicionadas na classe Magento\Framework\Message\ManagerInterface em um arquivo .phtml, você pode usar o seguinte código: <?php $objectManager…

2 meses atrás

Exportar as categorias do Magento 2 em um XML

Para criar um script no Magento 2 que exporte as categorias para um arquivo XML com o nome da categoria,…

3 meses atrás

Colocar um video como Background utilizando HTML + CSS

Para definir um vídeo MP4 como plano de fundo em um <div> usando HTML e CSS, você pode seguir estas…

5 meses atrás

Desativar o “lastname” no Magento 2

Como desativar o "lastname" no Magento 2 e Adobe Commerce Desativando a obrigatoriedade do campo Execute a SQL abaixo diretamente…

5 meses atrás