Taxonomias e termos

As taxonomias ajudam a organizar o conteúdo com termos compartilhados que podem ser aplicados a muitas entradas.

Alguns exemplos comuns:

• categorias
• tags
• tópicos
• seções
• autores
• tipos de conteúdo

Quando usar uma taxonomia

Use uma taxonomia quando o mesmo rótulo ou classificação precisar ser reutilizado em várias entradas.

Por exemplo, em vez de digitar o nome de uma categoria manualmente em cada entrada, você pode defini-lo uma vez como termo de taxonomia e selecioná-lo onde for necessário. Isso mantém o conteúdo mais consistente e facilita filtrar, agrupar e consultar depois.

Criar uma taxonomia

Para criar uma taxonomia:

1. Vá em Modelos → Taxonomias.
2. Clique em Criar taxonomia.
3. Digite um nome para a taxonomia.
4. Revise o ID de API gerado, se precisar.
5. Salve a taxonomia.

Adicionar termos

Depois que a taxonomia for criada, adicione os termos que quem edita deve poder escolher.

Por exemplo, se você criar uma taxonomia Categoria, pode adicionar termos como Notícias, Opinião e Guias.

O fluxo exato para gerenciar termos pode variar conforme a configuração do projeto, mas o objetivo é o mesmo: definir opções reutilizáveis uma vez e aplicá-las de forma consistente no conteúdo.

Usar uma taxonomia em um modelo de conteúdo

No editor da taxonomia, configure Aplica-se a para que a taxonomia fique disponível em modelos de conteúdo específicos, ou deixe vazio para permitir todos os modelos de conteúdo (o mesmo comportamento da barra lateral do editor de entradas).

Quem edita atribui termos na barra lateral da entrada no Studio. Você não adiciona um campo de referência separado no modelo de conteúdo.

Consultar os termos atribuídos (GraphQL)

Quando uma taxonomia se aplica a um modelo, o tipo Entry_* do GraphQL de entrega inclui um campo de lista cujo nome vem do ID de API plural da taxonomia (camelCase). Para os IDs de API Tag / Tags em BlogPost, solicite tags:

query {
  blogPost(id: "entry-id-here") {
    _id
    title
    tags {
      _id
      name
    }
  }
}

Você pode listar os termos da taxonomia na raiz (tags, tag) e filtrar coleções de entradas com where nas consultas plurais (ID de API singular da taxonomia, por exemplo where: { tag: { … } }). Consulte a API GraphQL.

Próximos passos

• Modelos de conteúdo
• Componentes