> ## Documentation Index
> Fetch the complete documentation index at: https://foliant-help.iforiti.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Metacampos nos modelos

> Imprima metacampos de encomendas, encomendas de rascunho, clientes, produtos e variantes num modelo e garanta que a Foliant carrega os de que precisa.

Os metacampos são dados personalizados que você ou as suas apps guardam na Shopify: uma mensagem de oferta numa encomenda, uma etiqueta de cuidados num produto, o número de conta de um cliente. Os modelos podem imprimi-los com Liquid. O separador **Metacampos** do editor de código mostra a sintaxe para cada tipo.

## Antes de começar: verifique que metacampos a Foliant carrega

A Foliant carrega os metacampos juntamente com a encomenda e não consegue carregá-los todos. Funciona assim:

* A sua loja precisa de pelo menos uma **definição de metacampo** (no admin da Shopify, **Definições › Dados personalizados**). Sem nenhuma definição, não são carregados metacampos.
* Para cada tipo (encomendas, encomendas de rascunho, clientes, produtos e variantes), a Foliant carrega as definições que **fixou**, até 10 por tipo, pela ordem em que as fixou.
* Se um tipo não tiver definições fixadas, a Foliant carrega os primeiros 10 metacampos que encontrar para esse tipo.

Por isso, para garantir que um metacampo é impresso, crie uma definição para ele e fixe-a em **Definições › Dados personalizados**. As alterações às definições podem demorar até uma hora a aparecer nos documentos.

## Imprimir um metacampo

Substitua `namespace` e `key` pelo namespace e pela chave do seu metacampo (por exemplo, `custom.gift_message`):

| Metacampo de | Liquid |
| - | - |
| A encomenda ou encomenda de rascunho | `{{ order.metafields.namespace.key }}` |
| O cliente | `{{ customer.metafields.namespace.key }}` |
| Um produto | `{{ line_item.product.metafields.namespace.key }}` |
| Uma variante | `{{ line_item.variant.metafields.namespace.key }}` |

Os metacampos de produtos e variantes são por artigo, por isso use-os dentro do ciclo dos itens de linha:

```liquid theme={null}
{% for line_item in line_items %}
  {{ line_item.title }}
  {% if line_item.product.metafields.custom.care_instructions != blank %}
    <br>{{ line_item.product.metafields.custom.care_instructions }}
  {% endif %}
{% endfor %}
```

## Como são impressos os tipos de metacampo

| Tipo | O que obtém |
| - | - |
| Texto, URL, data, cor… | O valor como texto |
| Número inteiro, decimal | Um número que pode comparar ou usar em cálculos |
| Verdadeiro ou falso | `true` ou `false`, para `{% if %}` |
| Texto formatado | O texto, sem formatação |
| Peso, dimensão, volume | `.value` e `.unit`, por exemplo `{{ … .weight.value }} {{ … .weight.unit }}` |
| Dinheiro | `.value` (como `23.00`) e `.unit` (o código da moeda). Não em cêntimos. |
| Classificação | `.value`, `.scale_min` e `.scale_max` |
| JSON, listas | Uma lista ou um objeto que pode percorrer num ciclo |

## Bom saber

* Um metacampo vazio ou inexistente não imprime nada. Use `!= blank` para omitir a respetiva etiqueta.
* Nos modelos visuais, imprima metacampos com um bloco **Liquid personalizado**.
* As listas de recolha podem mostrar metacampos de produtos ou variantes como colunas, nas definições de **Lista de recolha** do modelo.

## Artigos relacionados

* [Itens de linha nos modelos](https://foliant-help.iforiti.com/pt-PT/template-editor/liquid-line-items.md)
* [Atributos da encomenda e propriedades dos itens de linha](https://foliant-help.iforiti.com/pt-PT/template-editor/liquid-custom-fields.md)
* [O objeto da encomenda e variáveis comuns](https://foliant-help.iforiti.com/pt-PT/template-editor/liquid-order-variables.md)
* [Editar o código de um modelo](https://foliant-help.iforiti.com/pt-PT/template-editor/code-editor.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.