Query Posts: personalizando as páginas do WordPress

September 23rd, 2006, 11:10 am Rodrigo P. Ghedin WordPress

Hoje abordarei um assunto complexo, mas que, quando entendido, expande o nível de personalização do WordPress a patamares inimagináveis. A mágica é conseguida através do recurso query posts. Não sei o porquê deste nome, nem como funciona tecnicamente; só sei que é útil, e ao contrário do que parece à primeira vista, é fácil de usar.

Aos que entendem o idioma do tio Sam, recomendo a leitura deste artigo da Codex, extremamente detalhado e que serviu de base para este que você está lendo.

Através da (ou seria do?) query posts, é possível fazer, diretamente no sistema, alterações possíveis através da URL e/ou das opções, porém sem mudá-las. Há inúmeras possibilidades de uso, graças às diversas variáveis suportadas. Destaco algumas:

• Exibir uma página ou um post na página inicial;
• Exibir todos os posts e páginas publicados em determinado período;
• Exibir apenas o último post na página inicial;
• Alterar a ordem de exibição dos posts;
• Exibir posts apenas de uma só categoria.

No decorrer do artigo, usarei exemplos práticos para ilustrar e facilitar a compreensão das hipóteses.

Antes de tudo, é necessário identificar o loop. O loop é um trecho existente nos arquivos que exibem diversos posts simultaneamente, como o index.php, category.php, archive.php e search.php. Este trecho é o responsável por ir ao banco de dados, e puxar os dados dos posts, exibindo-os ordenadamente e através do código escrito dentro dele. Veja um exemplo de loop:

Vamos tentar entendê-lo?

Encontrou as tags <ul> e </ul>? Abaixo da primeira tem início o loop (<?php if (have_posts()) : ?>), que termina exatamente acima da segunda (<?php endwhile; ?>). O que vem abaixo da tag <?php else : ?> é uma espécie de quebra-galho. Falando em bom português, caso nenhum artigo seja encontrado no banco de dados, a famigerada mensagem de desculpas aparecerá.

No navegador, o código acima retorna o seguinte resultado:

Porém, aquele código não é tudo. Nas configurações do blog, está marcado, no item Show at most, dez posts. Isso significa que o WordPress deve exibir, em cada página de índice, como a mostrada acima, dez textos, ou no caso, dez headlines. Além disso, no exemplo acima só estão listados posts de uma categoria; o blog em questão tem catorze. Sim, caro leitor, o responsável por essa customização é a query post.

Agora que você já sabe que o loop se inicia na linha <?php if (have_posts()) : ?> (ou qualquer coisa parecida com isso), abra o editor de temas do seu blog e navegue até uma das páginas já mencionadas que o contêm. Localizado o início do loop, insira, imediatamente antes dele, a seguinte tag:

<php query_posts() ?>

Simples, não? Sim, é simples mesmo. O uso de query post é exatamente este: inserir a tag antes do início do loop. Evidente que, do modo como ela está mostrada ali em cima, não produzirá efeito algum. É aí que entram os atributos da query post. Vejamos um exemplo prático, pegando o gancho explicado acima (vinte e cinco posts, e apenas a categoria 1); o código seria este:

<?php query_posts('posts_per_page=25&cat=1'); ?>

Entendeu o funcionamento? O atributo posts_per_page=25 diz ao sistema para que ele retorne os vinte e cinco últimos textos, e o cat=1 limita a exibição somente à categoria cuja ID é 1. O & não tem função definida, serve apenas para fazer com que dois ou mais atributos sejam interpretados simultaneamente.

Dito isto, e dentro dos atributos disponíveis, as possibilidades são inúmeras! Vejamos mais alguns exemplos:

• <?php query_posts('cat=3&year=2004'); ?>
  Este código exibirá posts da categoria cuja ID é 3 que foram publicados no ano de 2004.
• <?php query_posts('order=ASC&posts_per_page=12&author=3') ?>
  Exibirá os posts em ordem invertida, exibindo apenas doze por página, e apenas os de autoria do usuário cujo ID é 3.
• <?php query_posts('page_id=7') ?>
  Exibirá, ao invés de posts, apenas a página cujo ID é 7.

Lembrando que o ID é um número que é atribuído a todos os posts, páginas, categorias e autores. Na área Manage, do painel administrativo, é possível identificar o ID de tudo isso que foi citado.

Farei, brevemente, uma listagem dos atributos que conheço. Acompanhe:

• p=1
  Usado para exibir determinado post, através do ID;
• name=first-post
  A mesma função do anterior, mas obtém o post através do post slug (nome na URL; ainda abordarei este assunto num texto futuro);
• page_id=7
  Novamente, a mesma utilidade, mas ao invés de posts, este atributo busca uma página, pelo ID;
• pagename=about
  Idem, mas através do post slug da página;
• showposts=1
  Tem a mesma finalidade do atributo posts_per_page;
• author=3
  Exibe apenas posts do usuário cujo ID seja 3;
• author_name=Harriet
  Mesma função do atributo anterior, mas busca o usuário através do nome, e não do ID;
• hour=11
  Mostra apenas posts publicados em determinada hora;
• minute=59
  Mostra apenas posts publicados em determinado minuto;
• second=30
  Mostra apenas posts publicados em determinado segundo;
• day=15
  Mostra apenas posts publicados em determinado dia;
• monthnum=12
  Mostra apenas posts publicados em determinado mês;
• year=2005
  Mostra apenas posts publicados em determinado ano;
• order=ASC
  Mostra posts na ordem correta (para exibir ao contrário, substitua ASC por DESC).
• cat=1
  Limita a exibição de posts somente à categoria cuja ID é 1. Usando o número negativo, ou seja, precedido de um hífen (-1), exibe todas as categorias, menos a cuja ID é 1.

Ufa, é realmente bastante coisa. E há mais, acredite! Só com a ajuda das query posts é possível transformar o WordPress, nativamente um sistema de blogs, em um portal completo. Veja um exemplo.

O artigo original, já mencionado, se não for mais completo, é mais direto, e traz vários exemplos práticos, uns bem desenvolvidos, utilizando técnicas cujas quais eu não domino (e, portanto, não abordei aqui). Vale a pena dar uma olhada.

Este é um assunto muito procurado nos fóruns de suporte em que participo. Espero, com este texto, ter sanado o básico, e aberto caminho para seus estudos. Teste, erre, improvise, arrisque: o resultado vem, pode apostar.