Como exibir somente a categoria pai no loop de posts do WordPress

Deseja exibir apenas a categoria principal para suas postagens no WordPress?

Por padrão, a maioria dos temas do WordPress listará todas as categorias associadas a um post. No entanto, alguns usuários podem querer exibir apenas a categoria principal e excluir as categorias secundárias.

Neste artigo, mostraremos como modificar o loop de postagem do WordPress para exibir somente a categoria principal em uma única postagem.

Quando exibir somente a categoria principal no WordPress

Muitos proprietários de sites usam categorias pai e filho para criar uma estrutura para seus sites.

Por exemplo, um blog de viagens pode ter destinos de viagem organizados por categorias em que cada região é uma categoria principal e as cidades são categorias secundárias.

Da mesma forma, um blog de culinária pode publicar receitas organizadas em categorias principais e secundárias. Por exemplo, uma categoria principal pode ser o tipo de cozinha e uma categoria secundária pode ser o tipo de prato.

Agora, a maioria dos temas do WordPress usa a tag de modelo the_category() para listar todas as categorias associadas a um post.

Essa função é eficiente, mas exibirá todas as categorias em ordem alfabética e ignorará completamente a relação pai/filho.

Dito isso, vamos dar uma olhada em como alterar esse comportamento e exibir apenas a categoria principal no loop do WordPress.

Exibir somente a categoria pai no loop de postagem do WordPress

Para este tutorial, você precisará editar seus arquivos de tema do WordPress. Se você não tiver feito isso antes, consulte nosso artigo sobre como copiar e colar trechos de código no WordPress.

Primeiro, você precisa adicionar o seguinte código ao arquivo functions.php do seu tema ou usar um plug-in de snippets de código, como o WPCode (recomendado):

function wpb_get_parent_terms($taxonomy = 'category')
{
    $currentPost = get_post();
    $terms       = get_the_terms($currentPost->ID, $taxonomy);

    if (is_wp_error($terms)) {
        /** @var \WP_Error $terms */
        throw new \Exception($terms->get_error_message());
    }

    $map = array_map(
        function ($term) use ($taxonomy) {
            return '<a href="' . esc_url(get_term_link($term->term_id,
                    $taxonomy)) . '" title="' . esc_attr($term->name) . '">
                ' . $term->name . '
                </a>';
        },
        array_filter($terms, function ($term) {
            return $term->parent == 0;
        })
    );

    return implode(', ', $map);
}

Para obter mais detalhes, consulte nosso guia sobre como adicionar código personalizado no WordPress sem danificar seu site.

Esse código simplesmente cria uma nova função wpb_get_parent_terms(). Por padrão, essa função exibirá apenas as categorias pai.

Em seguida, você precisa colocar essa função nos arquivos de tema do WordPress onde deseja exibir apenas a categoria principal.

Para descobrir qual arquivo de modelo deve ser examinado, consulte nossa folha de dicas de hierarquia de modelos do WordPress para iniciantes.

Basicamente, você procurará a tag de modelo the_category(); dentro do loop do WordPress. Depois de encontrá-la, você precisará substituí-la pelo código a seguir:

<?php wpb_get_parent_terms(); ?> 

Esse código exibirá apenas sua categoria principal.

Se você tiver várias categorias que são as categorias pai ou autônomas, todas essas categorias também serão exibidas.

O snippet de código também funcionará para todas as outras taxonomias. Por exemplo, categorias de produtos do WooCommerce ou qualquer taxonomia personalizada que você possa ter.

Basta modificar o código da seguinte forma:

<?php wpb_get_parent_terms( 'product_cat '); ?>

Esse código exibirá categorias de produtos para uma loja WooCommerce.

Ele também exibirá apenas as categorias pai ou autônomas de um produto.

Se quiser exibir uma taxonomia personalizada, substitua product_cat pelo nome da taxonomia personalizada.

Guias especializados sobre a exibição de categorias no WordPress

Agora que você já sabe como exibir somente a categoria principal para as postagens do WordPress, talvez queira ver outros guias relacionados à exibição de categorias no WordPress:

• Como exibir apenas a categoria secundária em seu loop de postagem do WordPress
• Como exibir subcategorias em páginas de categoria no WordPress
• Como exibir descrições de categorias no WordPress
• Como alterar a ordem das categorias no WordPress
• Como exibir postagens recentes de uma categoria específica no WordPress
• Como mostrar/ocultar categorias no WordPress (guia definitivo)
• Como mostrar categorias vazias nos widgets do WordPress
• Como estilizar categorias individuais de forma diferente no WordPress
• Como ocultar ou estilizar suas subcategorias no WordPress
• Como adicionar imagens de taxonomia (ícones de categoria) no WordPress

Esperamos que este artigo tenha ajudado você a aprender como exibir somente a categoria pai para seus posts do WordPress. Talvez você também queira ver nosso guia sobre como exibir campos personalizados fora do loop ou nossa escolha especializada do melhor software de chatbot de IA para seu site.

Se você gostou deste artigo, inscreva-se em nosso canal do YouTube para receber tutoriais em vídeo sobre o WordPress. Você também pode nos encontrar no Twitter e no Facebook.