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.