WP_Query é uma classe definida no WordPress. Ela permite que desenvolvedores escrevam consultas personalizadas e exibam posts usando diferentes parâmetros. É possível para os desenvolvedores consultarem diretamente o banco de dados do WordPress. No entanto, WP_Query é uma das maneiras recomendadas para consultar posts do banco de dados do WordPress.
Abaixo está um exemplo de um 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 posts automaticamente. 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();
?>
WP_Query é uma ferramenta poderosa, existem muitos parâmetros que podem ser usados para escrever consultas mais complexas e avançadas. WP_Query pode ser usada para criar loops aninhados (um loop do WordPress dentro de outro loop). Desenvolvedores do WordPress podem usá-la em seus plugins e temas para criar suas próprias exibições personalizadas de posts.
Uma lista completa de parâmetros do WP_Query está disponível no WordPress Codex.
