Personalizar widget

Widgets são componentes (blocos de código) independentes responsáveis por exercer uma função específica na loja.

Formas de customização

Você pode personalizar um Widget de três maneiras diferentes, são elas as seguintes:

Método template customizado

📘

Template Principal do Widget

  • Todos os Widgets possuem um parâmetro chamado Template que pode ser utilizado para chamar um template customizado.
  • Esta forma permite customizar o apenas Template Principal sobrescrevendo-o por outro arquivo armazenado no Tema Utilizado ou no Tema Shared.
  1. No Painel Administrativo, acesse o menu Aparência > Gerenciador de Arquivos.

  2. Na pasta do Tema escolhido, navegue até a pasta de Templates .

  1. Dentro da pasta de Templates, crie um novo aquivo do tipo template
  1. Verifique se o arquivo está dentro do template, conforme abaixo
  1. Agora insira na chamada do widget com o parâmetro Template e informe o caminho do novo template

Referenciando o arquivo no parâmetro template:

<!-- Indica que o arquivo está dentro da pasta principal do widget -->
{% meu_widget(Template=“meucustom.template” ) %}

<!-- Indica que o arquivo está dentro da pasta principal do tema em questão -->
{% meu_widget(Template=“/meucustom.template” ) %}

<!-- Indica um caminho absoluto no site. 
Utilizado, por exemplo, para informar um arquivo dentro do tema Shared. -->
{% meu_widget(Template=“~/Caminho-absoluto/meucustom.template” ) %}

Método cópia de pasta

📘

Método Cópia de Pasta

  • Esta opção permite que você edite qualquer template da pasta principal do Widget, independente se ele é ou não o principal.

  • Por exemplo: Editar o template wd.profile.register.addressdata.template do Widget profile_register:

  1. No Painel Administrativo, acesse o menu Aparência > Gerenciador de Arquivos e selecione a pasta do Tema utilizado.
  1. Encontre a pasta Widgets dentro da pasta do Tema, caso não existe crie uma nova pasta. Como criar pastas
  1. Em Aparência > Gerenciador de Widget procure o widget a ser cutomizado
  1. No arquivo manifest.xml procure pelo atributo folder, nele está o nome da pasta a ser copiada
  1. Na pasta Widgets dentro do Gerenciador de Arquivos crie uma pasta com o nome igual ao do manifest.xml
  1. Agora escolha o Template a ser customizado.
  1. Na pasta criada, crie o arquivo Template selecionado
  1. Recomenda-se que seja copiado o conteúdo original do Template do Widget como base, para não afetar o funcionamento.

🚧

Script do Widget

Apenas o método de Clonagem de Widget permite mudar o script do Widget

Método clonagem de widget

📘

Método Clonagem de Widget

  • Deve ser utilizado apenas caso os demais métodos não sejam efetivos.

  • Nesse método pode-se modificar todos os arquivos do widget.

  1. No Painel Administrativo, acesse o menu Aparência > Gerenciador de Widgets

  2. No campo tags, entre com a Tag do widget a ser clonado.

  3. Clique no botão "+" para clonar o widget.

  1. Para chamar o widget clonado utilize a nova tag disponível no manifesto

❗️

Atenção

O widget easy_checkout não deve ser clonado e o uso de templates customizados no mesmo deve ser evitado (com exceção do template do rodapé), isto porque ele recebe constantes atualizações que não são aplicadas em templates customizados, o que pode gerar erros no checkout.


Did this page help you?