SEO

Breadcrumbs com metacampos no Shopify: o erro do namespace que impede o código de funcionar

Se seguiste um tutorial de breadcrumbs com metacampos e o caminho não aparece, confirma o namespace e a chave da definição: tem de ficar exatamente custom.breadcrumbs. Vê como criar a definição no painel atual e o que fazer se já guardaste com o nome errado.

Pedro Alfaiate·· 4 min de leitura
Capa Breadcrumbs com metacampos, com pequenas setas de papel alinhadas em fila.

Breadcrumbs são aquela linha no topo da página de produto que mostra o caminho: Início, depois a coleção, depois o produto. Ajudam quem chegou por um anúncio ou por uma pesquisa a perceber onde está e a subir um nível sem usar o menu. Alguns temas trazem-nos de origem; outros não, e é aí que entra a abordagem com metacampos.

A ideia é simples: cada produto guarda num metacampo o caminho que deve mostrar, e um pequeno código no tema lê esse metacampo e desenha a linha. Este artigo não repete o código; trata do ponto onde a maior parte das pessoas fica presa ao seguir um tutorial deste tipo: a definição do metacampo.

O que tem de ficar exatamente igual

O código lê o metacampo pelo seu identificador, composto por um namespace e uma chave. Nos tutoriais mais comuns, incluindo o da Academia Shopifyers, esse identificador é custom.breadcrumbs. Se a definição que crias no painel ficar com outro identificador, por exemplo custom.custom_breadcrumbs, o código procura um metacampo que não existe e a linha não aparece, sem mensagem de erro.

Este erro é fácil de cometer porque o painel de metacampos mudou desde que muitos tutoriais foram gravados. Ao criar a definição, se escreveres o identificador completo no campo do nome, o painel acrescenta o prefixo por cima e ficas com custom_ a mais. A solução, quando já aconteceu, é apagar a definição e criá-la de novo, escrevendo apenas breadcrumbs no nome.

Criar a definição no painel atual

Os passos abaixo seguem a documentação do Shopify sobre definições de metacampos; os nomes dos menus podem variar com o idioma do painel.

  1. Em Definições > Dados personalizados, escolhe Produtos e clica em Adicionar definição.
  2. No campo Nome, escreve apenas breadcrumbs. Não escrevas custom.breadcrumbs: o painel acrescenta o namespace sozinho, e se o incluíres no nome ficas com custom.custom_breadcrumbs.
  3. Confirma a linha mais pequena por baixo do nome, onde aparece o identificador gerado. Deve ler-se custom.breadcrumbs. A documentação indica que podes editar este identificador antes de guardar, se precisares.
  4. Escolhe o tipo de conteúdo indicado no tutorial que estás a seguir. O tipo tem de bater certo com o que o código espera ler.
  5. Guarda.

Se o identificador já estava errado quando guardaste, não insistas em editá-lo: depois de guardar, esse campo deixa de estar editável. Apaga a definição e cria-a de novo com o nome certo. Se já tinhas preenchido valores em produtos, vais ter de os voltar a preencher, por isso convém corrigir isto cedo.

Preencher e verificar

Depois da definição criada, cada produto passa a ter o campo na sua página em Produtos, na área de metacampos. Preenche um produto de teste com o caminho, no formato que o tutorial indica, e abre esse produto na loja.

  • Se a linha aparece, a definição está certa. Preenche os restantes produtos, ou trata os mais importantes primeiro.
  • Se não aparece, volta à definição e compara o identificador letra a letra. Depois confirma que o código foi colocado no modelo de produto que aquele produto usa; um produto ligado a outro modelo não mostra o bloco.
  • Se o teu tema já tem breadcrumbs próprios, decide qual das duas versões fica. Duas linhas de caminho na mesma página confundem mais do que ajudam.

Um cuidado com o conteúdo do caminho: se um produto pertence a várias coleções, o metacampo permite escolher qual delas aparece no caminho. Escolhe a coleção que melhor descreve o produto, a mesma que usarias no menu. Isto liga-se à forma como as coleções estão organizadas e à rede de ligações internas da loja: o caminho é mais uma ligação da página de produto para a coleção certa.

Sobre motores de pesquisa: o Google descreve na documentação sobre dados estruturados de breadcrumbs como pode usar esta informação nos resultados. Se o teu tutorial incluir esses dados estruturados, verifica-os com a ferramenta de teste que essa página indica. Se não incluir, a linha continua a servir quem visita; o efeito nos resultados não está garantido por nenhuma das duas versões.

Este artigo foi preparado a partir dos conteúdos da Academia Shopifyers, onde o tutorial completo de breadcrumbs com metacampos está disponível para os membros.

Uma dica de Shopify por semana, no teu email.

Sem pressa e sem spam. Podes sair quando quiseres.

Continua a explorar.

Todos os artigos