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:
1 2 3 4 5 | <?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:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 | <?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.