category_description( array $args = [] ): void
Exibe a descrição da categoria atual.
Parâmetros:
$args array (opcional)
-
tagstring
Define a tag HTML utilizada para renderizar a descrição.
Padrão: 'div' -
attrsarray
Define atributos HTML adicionais para o elemento renderizado.
Retorno: void
Imprime diretamente a descrição da categoria atual.
Exemplo de uso:
<?php category_description(); ?>
<?php
category_description([
'tag' => 'section',
'attrs' => [
'class' => 'cat-dscpt'
]
]);
?>
Notas:
- A função só executa em páginas identificadas pela condicional
is_category(). - O conteúdo da descrição é obtido através do método
content()da classeCategory. - Por padrão, o elemento gerado recebe o atributo
id="category-description". - O conteúdo exibido pode conter HTML formatado.
- A função não renderiza nenhum elemento caso a categoria atual não possua descrição cadastrada.