Sempre fiz muito uso da função query_posts() para realizar novas solicitações de conteúdo customizadas e algumas vezes usando o objeto WP_Query(), mas pelo costume e comodismo sempre usei mais a função query_posts() para gerar as query’s que eu queria em temas de WordPress e pelo que já vi de outros desenvolvedores é de costume usar a função query_posts().

Bom, se os dois modos usando query_posts() ou o objeto WP_Query resovem nossas questões, porque existem duas maneiras. Fiz uma pesquisa pelo WordPress Codex e outros sites de desenvolvedores WordPress para saber a diferença destes dois modos de criar querys que são as solicitações que fazemos ao banco de dados do WordPress para nos retornar o conteúdo que queremos exibir.

query_posts()

A primeira e importante informação sobre a função query_posts() em que encontrei na sua descrição no site do WordPress Codex é: “A função query_posts é destinada a alterar a query principal do loop. Para a criação de query’s secundárias, você deve fazer uma nova instância do objeto WP_Query”. Isto quer dizer que, a função query_posts() não foi feita para criar várias querys dentro de um arquivo de template, a função dela é de ser usada uma vez somente em um arquivo de template quando você quer alterar a query padrão de um loop do WordPress onde ele realiza através dos parâmetros vindos da URL da página.

Um exemplo simples e prático é um loop simples de uma página principal de um blog onde o WordPress irá listar todos os posts de todas categorias do blog, paginados pelo número definido no painel do WordPress em Configurações > Leitura, que normalmente são de 10 posts por página.
O loop deste template seria como o exemplo abaixo.

<?php
if( have_posts() ): while( have_posts() ): the_post();
the_title();
the_content();
endwhile:
else:
echo 'Não foram encontrados posts.';
endif;
?>

Agora em que caso usaríamos a função query_posts() neste template? Vamos supor que na minha página principal eu não quero que sejam exibidos os posts da categoria de ID=5. É neste caso que faríamos o uso correto da função query_posts(). Nosso código ficaria assim:

<?php
if ( is_home() ) { query_posts( 'cat=-5' ); }
if( have_posts() ): while( have_posts() ): the_post();
the_title();
the_content();
endwhile:
else:
echo 'Não foram encontrados posts.';
endif;
?>

Dica: se você quiser preservar a query principal em que o WordPress gera através dos parâmetros vindo da URL e adicionar mais alguns parâmetros extras na query principal utilize como no exemplo abaixo:

<?php
global $query_string;
query_posts( $query_string . '&order=ASC&cat=-4' );

if( have_posts() ): while( have_posts() ): the_post();
the_title();
the_content();
endwhile:
else:
echo 'Não foram encontrados posts.';
endif;
?>

Você pode se perguntar, como eu me perguntei também: mas qual o porquê de ter que usar a função query_posts() somente uma vez em meu arquivo de template para alterar o loop principal se já usei várias vezes para poder criar mais de uma query em meus templates?

Resposta: Primeiro se o próprio site do WordPress Codex diz e recomenda que esta função seja usada apenas uma vez em por arquivo de template quando se quer mudar o loop principal, já é um bom argumento, mas mesmo assim não basta veja alguns dos argumentos que encontrei e que realmente me lembraram de experiências causadas pelo mau uso da função query_posts().

Segue alguns dos argumentos para que a função query_posts() seja usada da forma correta:

“Ela define uma série de variáveis ​​globais e por isso pode levar a erros obscuros e horríveis se usada em qualquer outro lugar e para qualquer outra finalidade”

“O uso de query_posts () em um loop que não seja o principal pode causar um resultado incorreto no seu ciclo e possivelmente exibir coisas que você não estava esperando.”

A grande diferença então entre a função query_posts() e o objeto WP_Query() é essa, a função query_posts() deve ser usada somente para alterar a query do loop principal e se o seu template necessitar de outras querys para exibir conteúdos diferentes em outros loops você deve criar uma nova instância do objeto WP_Query() para criar suas querys secundárias.

WP_Query()

Vamos falar agora o objeto WP_Query().
O WordPress Codex define o WP_Query() da seguinte maneira: “Para a criação de loops secundários, você deve fazer uma nova instância da WP_Query e usar em outros loops”

Segue abaixo um exemplo do uso da WP_Query() para se criar um loop secundário em um arquivo de template de um tema de WordPress.

<?php
$query_secundaria = new WP_Query( 'category_name=design&posts_per_page=5' );
while( $query_secundaria->have_posts() ) : $query_secundaria->the_post();
the_title();
the_excerpt();
endwhile;

wp_reset_postdata();
?>

Segue alguns argumentos sobre o uso correto do objeto WP_query:

“Para a criação de loops secundários, você deve fazer uma nova instância da WP_Query e usar neste loop: A razão importante disto é que você não acabe de alguma forma alterando ou interferindo com o loop principal utilizado nessa página”

“Um pouco mais complexa, mas com menos restrições e também seguro de usar em qualquer lugar.”

A WP_Query() não afeta de nenhuma maneira a query principal, por isso foi feita para  ser usada na criação de query’s secundárias dentro de um mesmo documento.

Importante: Trabalhe sempre com uma instância do objeto WP_Query() para criar suas query’s secundárias, para que não fiquem várias query’s abertas com o banco de dados, que pode prejudicar a performance do site.

Uma das maneiras muito usadas que não é a correta e melhor prática de se usar quando se quer usar a função query_posts() mais de uma vez em um mesmo documento é de usar a função wp_reset_query() que limpa a query anterior retornando com a original, eu já fiz isso várias vezes. Mas como em qualquer outra ferramenta cada objeto tem sua função específica e o melhor e mais seguro é usar cada objeto para sua finalidade real. Isto vai sempre tornar seu projeto final mais consistente e seguro.

Então vamos deixar o comodismo de lado e fazer bom uso das melhores práticas no desenvolvimento com o WordPress e vamos continuar sempre buscando as melhores práticas.

Artigo escrito por: Mateus Neves

Fontes de pesquisa:

Function Reference/query posts
Function Reference/WP Query
Understanding The Difference Between query_posts and WP_Query
When should you use WP_Query vs query_posts() vs get_posts()?