Configuração de metacampos e metaobjetos

Os recursos para móveis do Tenora leem dados de produto em metacampos e metaobjetos. Esta página mostra, passo a passo, como criá-los com os nomes e tipos exatos que o tema espera.

• Um metacampo é um campo extra em um produto, por exemplo "Largura".
• Um metaobjeto é uma entrada reutilizável com campos próprios, por exemplo um material chamado "Carvalho maciço" com uma imagem e instruções de cuidados.

Você configura as definições uma única vez. Depois, preenche os valores de cada produto.

Antes de começar

• Digite cada namespace e chave exatamente como mostrado, em letras minúsculas e com sublinhados. O tema lê esses nomes exatos. Uma pequena diferença, como specs.Width ou spec.width, faz com que o tema não encontre o valor.
• Crie primeiro a definição do metaobjeto "Material". O metacampo specs.materials depende dela.
• Se um valor estiver vazio, o bloco correspondente fica oculto na página do produto. Você pode preencher seus produtos aos poucos.

Recurso	Metacampos que ele lê
Dimensões	specs.width, specs.depth, specs.height, specs.seat_height, specs.weight
Será que cabe?	specs.width, specs.depth, specs.height (os três são necessários)
Materiais e cuidados	specs.materials e o metaobjeto "Material"
Pedir uma amostra	specs.sample_product (ou a configuração Produto de amostra do bloco)
Entrega e montagem	delivery.lead_time, delivery.method, delivery.assembly_required, delivery.assembly_guide

Confira primeiro o sistema de unidades da loja

Os metacampos de dimensão e de peso usam o sistema de unidades da sua loja como unidade padrão.

1. No admin da Shopify, acesse Configurações (Settings) → Geral (General).
2. Encontre Padrões da loja (Store defaults) → Sistema de unidades (Unit system).
3. Confira se está definido como métrico ou imperial.

Se a sua loja usa o sistema imperial, o admin seleciona polegadas e onças por padrão. Um valor digitado como 220 é salvo como 220 in, a menos que você mude a unidade ao lado do campo. O tema converte as unidades corretamente, mas os números não serão o que você pretendia.

Dica: sempre confira a unidade ao lado do valor antes de salvar um produto.

O bloco Dimensões sempre mostra centímetros e polegadas, e quilogramas e libras, qualquer que seja a unidade compatível usada no admin (mm, cm, m, in, ft ou yd para comprimentos; g, kg, lb ou oz para peso). Os clientes podem trocar de unidade, e a escolha fica salva no dispositivo deles.

Etapa 1: criar a definição do metaobjeto "Material"

1. No admin da Shopify, acesse Configurações → Dados personalizados (Custom data).

2. Em Metaobjetos (Metaobjects), selecione Adicionar definição (Add definition).

3. Insira o Nome (Name): Material.

4. Confira o Tipo (Type). A Shopify o preenche a partir do nome. Ele precisa ser exatamente material.

5. Selecione Adicionar campo (Add field) e adicione estes quatro campos:

   Nome do campo	Chave	Tipo	Opções
   Name	name	Texto de linha única (Single line text)	Marcar como obrigatório
   Image	image	Arquivo (File), permitindo apenas Imagens	Um arquivo
   Description	description	Texto com várias linhas (Multi-line text)
   Care instructions	care_instructions	Texto com várias linhas

6. Nas opções de acesso, ative o acesso de Vitrines (Storefronts). Sem isso, o tema não consegue ler o material.

7. Deixe a opção Status ativo/rascunho (Active-draft status) desativada. Se você ativá-la, precisa definir cada entrada de material como Ativo (Active), ou ela não aparece na loja.

8. Opcional: defina Name como nome de exibição, para encontrar as entradas facilmente nas listas.

9. Selecione Salvar.

Etapa 2: adicionar seus materiais

1. No admin da Shopify, acesse Conteúdo (Content) → Metaobjetos (Metaobjects).

2. Selecione Material.

3. Selecione Adicionar entrada (Add entry).

4. Preencha os campos. Por exemplo:

   Name	Description	Care instructions
   Carvalho maciço	Carvalho europeu com certificação FSC e acabamento em óleo natural.	Limpe com um pano macio e seco. Aplique óleo novamente uma vez por ano. Evite calor direto.
   Mistura de linho	55% linho, 45% algodão. Capas removíveis e pré-lavadas.	As capas podem ser lavadas a 30°C. Seque à sombra e passe ainda úmidas.
   Rattan natural	Rattan trançado à mão sobre estrutura de madeira maciça.	Tire o pó com uma escova macia. Mantenha longe de aquecedores e do sol direto.

5. Adicione uma Image para cada material, como um close da madeira ou do tecido. Uma imagem quadrada funciona melhor.

6. Selecione Salvar.

Dicas

• No layout Cartões, o bloco mostra apenas a primeira frase da descrição. Coloque a informação mais importante na primeira frase.
• As quebras de linha da descrição e das instruções de cuidados são mantidas.
• Um material sem nome não é exibido.

Etapa 3: criar as definições de metacampos de produto

1. No admin da Shopify, acesse Configurações → Dados personalizados.
2. Em Metacampos (Metafields), selecione Produtos.
3. Selecione Adicionar definição.
4. Insira o Nome e depois o Namespace e chave (Namespace and key) exatamente como mostrado abaixo, com o ponto (por exemplo specs.width).
5. Selecione o Tipo e as opções da tabela.
6. Confira se o acesso de Vitrines está ativado. Normalmente ele já vem ativado.
7. Selecione Salvar.
8. Repita para cada linha da tabela.

Nome	Namespace e chave	Tipo	Opções
Largura	specs.width	Dimensão (Dimension)	Um valor
Profundidade	specs.depth	Dimensão	Um valor
Altura	specs.height	Dimensão	Um valor
Altura do assento	specs.seat_height	Dimensão	Um valor
Peso	specs.weight	Peso (Weight)	Um valor
Materiais	specs.materials	Metaobjeto (Metaobject) e, em seguida, selecione Material	Lista de entradas
Produto de amostra	specs.sample_product	Produto (Product)	Um produto
Prazo de entrega	delivery.lead_time	Texto de linha única	Um valor
Forma de entrega	delivery.method	Texto de linha única	Um valor. Opcional: Limitar a opções predefinidas (Limit to preset choices), por exemplo Standard delivery, White-glove delivery, Flat-pack delivery
Montagem necessária	delivery.assembly_required	Verdadeiro ou falso (True or false)
Manual de montagem	delivery.assembly_guide	Arquivo	Permitir arquivos PDF (ou todos os tipos de arquivo)

Observações

• specs.materials também pode ser uma entrada única (Uma entrada) em vez de uma lista. O tema aceita as duas opções. Recomendamos uma lista, para que um produto possa ter vários materiais.
• Os nomes da coluna Nome aparecem apenas no admin. Você pode traduzi-los ou alterá-los. O namespace e a chave precisam ficar exatamente como mostrado.
• Dica: ative Fixar nas páginas de produto (Pin to product pages) ao criar uma definição. Assim, os campos aparecem diretamente em todas as páginas de produto do admin.

Etapa 4: preencher seus produtos

1. No admin da Shopify, acesse Produtos e abra um produto.

2. Role até Metacampos.

3. Preencha os campos deste produto. Por exemplo, para um sofá:

   Metacampo	Valor de exemplo
   Largura	220 cm
   Profundidade	95 cm
   Altura	82 cm
   Altura do assento	44 cm
   Peso	68 kg
   Materiais	Carvalho maciço, Mistura de linho
   Produto de amostra	Kit de amostras de tecido
   Prazo de entrega	Feito sob encomenda, enviado em 6 a 8 semanas
   Forma de entrega	Entrega especial (white glove)
   Montagem necessária	Falso
   Manual de montagem	Um arquivo PDF

4. Confira a unidade de cada dimensão e peso antes de salvar.

5. Selecione Salvar.

6. Abra o produto na sua loja virtual e confira os blocos Dimensões, Materiais e cuidados, Pedir uma amostra e Entrega e montagem.

O que acontece com dados parciais

Você não precisa preencher todos os campos. Por exemplo, se um produto tiver apenas largura, altura e prazo de entrega:

• A tabela de dimensões mostra apenas a largura e a altura.
• O desenho aparece, porque precisa apenas da largura e da altura.
• O "Será que cabe?" fica oculto, porque também precisa da profundidade.
• Os blocos Materiais e cuidados e Pedir uma amostra ficam ocultos (a menos que o bloco Pedir uma amostra tenha um Produto de amostra definido no editor de temas).
• O bloco Entrega e montagem mostra apenas o prazo de entrega.

Importar valores de metacampos com um arquivo CSV

Se você tiver muitos produtos, pode preencher os metacampos com a importação de produtos por CSV da Shopify. Crie as definições de metacampos (Etapa 3) antes de exportar ou importar. Assim, o CSV terá uma coluna para cada definição.

1. No admin da Shopify, acesse Produtos e selecione Exportar (Export) para obter um arquivo CSV com seus produtos atuais.

2. Abra o arquivo em um programa de planilhas. Encontre as colunas de metacampos. Os nomes delas incluem o namespace e a chave, por exemplo:

   • Width (product.metafields.specs.width)
   • Weight (product.metafields.specs.weight)
   • Materials (product.metafields.specs.materials)

3. Preencha os valores:

   Coluna	Valor de exemplo	Observação
   Width, Depth, Height, Seat height	180cm	Um número e uma unidade
   Weight	58 kg	Um número e uma unidade
   Materials	solid-oak; linen-blend	Identificadores das entradas de material, separados por ponto e vírgula e espaço
   Lead time	Made to order, ships in 6–8 weeks	Texto simples
   Assembly required	TRUE ou FALSE

4. Salve o arquivo como CSV (UTF-8).

5. Em Produtos, selecione Importar (Import), escolha o arquivo e siga as etapas.

6. Depois da importação, abra alguns produtos e confira os valores e as unidades.

Dicas

• Primeiro, importe um pequeno arquivo de teste com dois ou três produtos.
• O identificador (handle) de um material aparece na entrada do material em Conteúdo → Metaobjetos → Material. Normalmente é o nome em letras minúsculas com hifens, por exemplo solid-oak.
• Sempre inclua a unidade nos valores de dimensão e peso. Sem unidade, o valor pode ser lido na unidade padrão da sua loja.

Traduzir os dados de produto

Se a sua loja tiver mais de um idioma, traduza os valores de texto (materiais, prazos e formas de entrega) com as ferramentas de tradução da Shopify, da mesma forma que as descrições de produto. Os rótulos que o tema adiciona, como "Largura", "Cuidados" e "Requer alguma montagem", já estão traduzidos. Consulte Vendas internacionais.

Solução de problemas

Problema	O que conferir
Um bloco não aparece	O namespace e a chave estão exatamente como mostrado, o acesso de Vitrines está ativado e o produto tem um valor. O bloco também está no modelo de produto que o produto usa.
Os materiais não aparecem	A entrada do material tem um Name. Se a definição usar Status ativo/rascunho, a entrada está definida como Ativo.
Os tamanhos estão errados	A unidade ao lado de cada valor. Confira o sistema de unidades da sua loja.
O "Será que cabe?" não aparece	Largura, profundidade e altura têm valor, e Mostrar assistente de medidas está ativado no bloco Dimensões.
A amostra não aparece	O produto de amostra está ativo e disponível no canal de vendas Loja virtual. A amostra não é o próprio produto.

Para mais ajuda, consulte as Perguntas frequentes.