Como sobrescrever um template “phtml” no Magento 2 utilizando um Módulo e arquivo xml de layout.
Uma das tarefas mais comuns para um desenvolvedor do Magento 2 é 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.
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”.
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.
Usando o diretório de um módulo como base crie o seguinte arquivo e pastas necessárias.
view/frontend/layout/wishlist_index_index.xml
Ficando:
Vendor/Module/view/frontend/layout/wishlist_index_index.xml
Conteúdo do wishlist_index_index.xml
<?xml version="1.0"?>
<page xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:View/Layout/etc/page_configuration.xsd">
<body>
<referenceBlock name="customer.wishlist">
<arguments>
<argument name="template" xsi:type="string">Vendor_Module::view.phtml</argument>
</arguments>
</referenceBlock>
</body>
</page> 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 cache da loja e verifique se o novo template está sendo utilizado.
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:
...
<referenceBlock name="customer_form_login">
... E nome do arquivo de layout xml: customer_account_login.xml
Código obsoleto para sobrescrever um template nas primeiras versões do 2.0
<?xml version="1.0"?>
<page xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:View/Layout/etc/page_configuration.xsd">
<body>
<referenceBlock name="customer.wishlist">
<action method="setTemplate">
<argument name="template" xsi:type="string">Vendor_Module::view.phtml</argument>
</action>
</referenceBlock>
</body>
</page> 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!
Módulo gratuito Roger_CnpjAlfanumerico que aplica máscara e validação do novo CNPJ alfanumérico no checkout e formulários do Magento 2 e…
A partir de 06/07/2026 a Receita passa a emitir CNPJ alfanumérico. Conheça o plugin grátis que aplica máscara e validação…
Para remover um módulo do Magento 2, siga os passos abaixo: 1. Desabilitar o módulo Primeiro, desabilite o módulo usando…
Para cancelar 100% do pedido e criar um crédito para todos os itens através da API REST do Magento 2,…
No Magento 2, a quantidade "reservada" na "Salable Quantity" é gerenciada principalmente pelos módulos MSI (Multi-Source Inventory). A "Salable Quantity"…
Como corrigir o erro ao acessar o Admin do Magento 2. Mesmo após fazer o login, permanece na tela de…