Labpress

Lista de Categorias: Usando a tag wp_list_category

Publicado em 31.08.2007.
Por Alê Moreno

Como esse é o primeiro post sobre uma “template tags“, vale um pequeno prólogo: Template tags são “comandos” do WordPress que exibem informações dinâmicas em seu blog. Existem tags para quase tudo. Aqui você encontra a relação de todas, além de uma explicação mais detalhada.

A tag wp_list_category(), tema deste post, é responsável pela exibição de sua lista de categorias. É possível, através de alguns “parâmetros”, personalizar essa lista.

Por exemplo: Que tal exibir, junto ao nome de uma categoria, o número de posts da mesma? Simples! Basta usar o parâmetro show_cont:

<?php wp_list_category(show_count=1) ?>

E que tal , além de exibir o número de posts da categoria, esconder uma determinada categoria? Simples também. Basta usar o parâmetro exclude:

<?php wp_list_category(show_cont=1&exclude=3) ?>

…onde “3″ é o ID da categoria.

Outros parâmetros interessantes:

• orderby. Pode ser:
  • orderby=ID: Ordena pelo ID da Categoria (padrão).
  • orderby=name: Ordena pelo nome da Categoria.
• order:
  • order=asc: Ordena do maior para o menor (padrão).
  • order=desc: Ordena do menor para o maior.
• style:
  • style=list: Em formato de lista não ordenada (padrão).
  • style=none: Sem estilo. As categorias são separadas por um <br />
• show_count:
  • show_count=1: Exibe o número de posts publicados na categoria.
  • show_count=0: Não exibe (padrão).
• hide_empty. Pode ser:
  • hide_empty=1: Esconde categorias vazias (padrão).
  • hide_empty=0: Mostra tudo.
• use_desc_for_title
  • use_desc_for_title=1: Exibe a descrição da categoria dentro do title da tag <a> (padrão).
  • use_desc_for_title=0: No lugar da descrição da categoria, o WP devolve um texto padrão.

Existem outros parâmetros.
Se quiser conhecê-los, recomendo uma visita ao Codex.
Dúvidas?

Alê Moreno
São-paulino, 30 anos, arquiteto de informação e coordenador de produto da Globo.com. Trabalha com mídias interativas desde 1994, em empresas como UOL, AgênciaClick e Globo.com.