Como obter o nome da categoria sem link no WordPress (get_the_category)

A função padrão do WordPress the_category() é ótima, mas tem uma desvantagem: gera sempre links HTML (<a href="...">...</a>) para a página de arquivo. E se estás a construir um layout personalizado (como um cartão de portfólio ou slider) onde a categoria deve ser apenas texto puro, não um elemento clicável?

A solução é usar get_the_category(), que retorna um array dé objetos em vez de HTML pronto.

#Código (snippet)

Aqui está um snippet pronto a usar que podes colar no teu single.php ou content.php:

<?php
// Obter todas as categorias atribuídas ao post atual
$categories = get_the_category();

if ( ! empty( $categories ) ) {
    // Mostrar o nome da primeira categoria encontrada
    echo esc_html( $categories[0]->name );
}
?>

#Mostrar lista separada por vírgulas

Sé o teu post tem várias categorias e queres listá-las como texto separado por vírgulas:

<?php
$categories = get_the_category();
$output     = array();

if ( ! empty( $categories ) ) {
    foreach ( $categories as $category ) {
        // Adicionar nomé ao array
        $output[] = esc_html( $category->name );
    }
    // Juntar o array numa string com separador
    echo implode( ', ', $output );
}
?>

#Porquê get_the_category()?

Está função dá-té acesso ao objeto completo da categoria. Para além do nome (->name), podes extrair:

• ->slug (útil para classes CSS, ex: <span class="cat-<?php echo $cat->slug; ?>">)
• ->term_id (ID da categoria)
• ->description (descrição da categoria)
• ->count (número de posts nestá categoria)

#Aplicação prática

Um caso de uso comum é estilizar etiquetas em cartões de blog.

// Dentro do loop do WordPress
$cats = get_the_category();
$first_cat = !empty($cats) ? $cats[0] : null;

if ($first_cat) : ?>
    <span class="badge badge-<?php echo esc_attr($first_cat->slug); ?>">
        <?php echo esc_html($first_cat->name); ?>
    </span>
<?php endif; ?>

Destá forma, se tens a categoria “Notícias”, obténs a classe .badge-noticias, que podes fácilmente colorir em CSS. Este nível de controlo é algo que the_category() simplesmente não oferece.

Exploré os nossos desenvolvimento profissional WordPress para levar o seu projeto mais longe.