WP_Query é uma classe definida no WordPress. Ela permite que os desenvolvedores escrevam consultas personalizadas e exibam posts usando parâmetros diferentes. É possível que os desenvolvedores consultem diretamente o banco de dados do WordPress. No entanto, a WP_Query é uma das formas recomendadas para consultar posts do banco de dados do WordPress.
Abaixo está um exemplo de uma WP_Query simples que exibe posts da categoria de filmes:
<?php // The Query $the_query = new WP_Query( 'category_name=movies' ); ?>
O código de exemplo acima não exibe automaticamente as postagens. Para exibir os resultados da consulta, o usuário precisaria usar o loop do WordPress. Assim:
<?php
// The Query
$the_query = new WP_Query( 'category_name=movies' );
// The Loop
if ( $the_query->have_posts() ) {
echo '<ul>';
while ( $the_query->have_posts() ) {
$the_query->the_post();
echo '<li>' . get_the_title() . '</li>';
}
echo '</ul>';
} else {
// no posts found
}
/* Restore original Post Data */
wp_reset_postdata();
?>
O WP_Query é uma ferramenta poderosa, pois há muitos parâmetros que podem ser usados para escrever consultas mais complexas e avançadas. O WP_Query pode ser usado para criar loops aninhados (um loop do WordPress dentro de um loop). Os desenvolvedores do WordPress podem usá-lo em seus plugins e temas para criar suas próprias exibições personalizadas de posts.
Uma lista completa dos parâmetros do WP_Query está disponível no WordPress Codex.
