Bloco de consulta de termos

O bloco Consulta de termos exibe uma lista ou grade de termos de taxonomia (como Categorias, Tags ou taxonomias personalizadas). Ele é mais útil em modelos (por exemplo, um índice de “Categorias” ou uma página de diretório) onde você deseja listar termos e definir a aparência de cada termo.

Requisitos

• WordPress 6.9 ou posterior.
• Um tema de blocos para editar modelos no Editor do site.
• A taxonomia que você deseja exibir deve ser pública e estar disponível no editor (show_in_rest ativado).

Anatomia do bloco Consulta de termos

O inspetor de blocos fornece uma visão geral rápida da estrutura do bloco Consulta de termos. Cada parte dá acesso a diferentes configurações:

• Consulta de termos: Configure os parâmetros da consulta.
• Modelo de termo: Escolha como o conteúdo é exibido, em formato de lista ou grade.
• Nome do termo: Mostre o nome do termo.
• Descrição do termo: Mostre a descrição do termo.
• Contagem de termos: Mostre o número de resultados de cada termo.

Adicionar o bloco Consulta de termos a um modelo

1. Vá para Aparência > Editor.
2. Abra o modelo onde deseja que os termos apareçam (por exemplo, um modelo personalizado de “Categorias”).
3. Coloque o cursor no local desejado.
4. Abra o inseridor de blocos (+), pesquise por “Consulta de termos” e selecione-o.

Configuração do bloco

Depois de adicionar o bloco Consulta de termos você verá duas opções:

Essas variações oferecem duas opções diferentes de layout:

• Nome: mostra apenas o nome do termo.
• Nome & Contagem: mostra o nome e o número de itens nesse termo.

Como personalizar a aparência

Há várias maneiras de personalizar o bloco Consulta de termos, em parte porque ele é composto por blocos aninhados que podem ser reorganizados, adicionados e muito mais. Quando você personaliza um bloco no bloco Consulta de termos, as alterações serão aplicadas a todos os blocos do mesmo tipo. Ao personalizar este bloco, pode ser útil usar a Visualização em lista encontrada na barra de ferramentas superior. Aqui estão algumas ideias de personalização para começar:

• Você pode alterar a largura de vários aspectos do bloco Consulta de termos.
• Você pode alterar o alinhamento dos blocos dentro do bloco Consulta de termos.
• Você pode reorganizar os blocos como preferir, arrastando e soltando ou usando os controles de movimentação.
• Você pode alterar o número de termos listados selecionando o bloco Consulta de termos e ajustando a opção Número máximo de termos nas configurações do bloco.
• Você pode definir várias opções de cores para os blocos aninhados.
• Você pode alterar como o número de termos é exibido selecionando o bloco Número de termos e alterando o formato na barra de ferramentas do bloco.
• Você pode exibir a descrição do termo selecionando o bloco Descrição do termo e ajustando os estilos conforme necessário.

Barra de ferramentas do bloco

Para visualizar a barra de ferramentas do bloco, clique no bloco e a barra de ferramentas será exibida. Cada bloco possui ícones exclusivos na barra de ferramentas e controles de usuário específicos que permitem manipular o bloco diretamente no editor. O bloco Consulta de termos tem as seguintes opções:

• Transformar em.
• Alinhar à esquerda, largura ampla, largura total.
• Mover/arrastar para reposicionar no modelo.
• Mais opções (duplicar, bloquear, remover etc.).

Transformar em

Clique no botão “Transformar” para converter o bloco Loop de consulta em um bloco “Grupo” ou “Colunas”.  

Ícone de arrastar

Para arrastar e soltar o bloco em um novo local, clique e segure o retângulo de pontos e arraste-o até o novo local. A linha azul de separação indica onde o bloco será colocado. Solte o botão esquerdo do mouse quando encontrar o novo local para posicionar o bloco.

Setas de movimentação

Os ícones de seta para cima e para baixo podem ser usados para mover o bloco para cima e para baixo na página.

Instruções detalhadas sobre como mover um bloco dentro do editor podem ser encontradas aqui

Alinhar

Use a ferramenta de alteração de alinhamento para alinhar o bloco Loop de termos. Escolha uma das seguintes opções:

• Nenhum – mantém o bloco no tamanho atual.
• Largura ampla – aumenta a largura do bloco além do tamanho do conteúdo.
• Largura total – estende o bloco para cobrir toda a largura da tela.

As configurações de alinhamento “Largura ampla” e “Largura total” devem estar ativadas pelo seu tema do WordPress. 

Visualização em lista (padrão)

Exibe seus termos em uma lista empilhada. Selecione o bloco Modelo de termo para editá-lo.

Visualização em grade

Exibe seus termos em uma grade. Selecione o bloco Modelo de termo para editá-lo.

Opções

O botão Opções na barra de ferramentas de um bloco oferece mais recursos para personalizá-lo. 

Leia sobre estas e outras configurações.

Configurações do bloco

Blocos internos usam a largura do conteúdo

Esta opção permite configurar as definições de justificação, conteúdo e largura ampla para todos os blocos aninhados dentro do bloco ConsultaLoop.

Ordenar por

• Nome: A > Z
• Nome: Z > A
• Contagem: do maior para o menor
• Contagem: do menor para o maior

Termos selecionados

Esta opção permite escolher taxonomias específicas para exibir. Basta pesquisar e selecionar o que deseja adicionar.

Mostrar termos vazios

Esta opção permite exibir termos mesmo que estejam vazios. Ela fica desativada por padrão.

Mostrar termos aninhados

Esta opção permite exibir termos aninhados. Ela fica desativada por padrão.

Número máximo de termos

Esta opção permite limitar o número de termos que você deseja exibir. Para mostrar todos os termos, use 0 (zero).

Configurações avançadas

A aba avançada permite adicionar uma classe CSS ao bloco, possibilitando escrever CSS personalizado e estilizar o bloco como preferir. Ela também permite atribuir um elemento HTML.

Demonstração

Dicas

• Use Lista para taxonomias hierárquicas; use Grade para visualizar muitos termos rapidamente.
• Mantenha o Nome do termo em destaque; adicione a Descrição do termo para fornecer contexto nas páginas de destino.
• Use Ocultar vazios para evitar arquivos sem conteúdo e manter a lista relevante.
• Salve uma seção Consulta de termos configurada como um Padrão para reutilizá-la em diferentes modelos.

Perguntas frequentes

Posso mostrar apenas termos de nível superior?

• Sim. Deixe Pai sem definição e desative Incluir subtermos.

Posso exibir uma taxonomia personalizada?

• Sim, se ela for pública e estiver registrada para ser exibida no editor (show_in_rest true).

Posso vincular o nome do termo ao seu arquivo?

• O Nome do termo normalmente é vinculado ao arquivo do termo por padrão. Você pode controlar links adicionais (como a Contagem de termos) nas configurações do bloco.