Trusted WordPress tutorials, when you need them most.
Beginner’s Guide to WordPress
WPB Cup
25 Million+
Websites using our plugins
16+
Years of WordPress experience
3000+
WordPress tutorials
by experts

What is: WP_Query

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.

Additional Reading

Avatar

Editorial Staff at WPBeginner is a team of WordPress experts led by Syed Balkhi with over 16 years of experience in WordPress, Web Hosting, eCommerce, SEO, and Marketing. Started in 2009, WPBeginner is now the largest free WordPress resource site in the industry and is often referred to as the Wikipedia for WordPress.

The Ultimate WordPress Toolkit

Get FREE access to our toolkit - a collection of WordPress related products and resources that every professional should have!