Como usar a função get_posts do WordPress

A função get_posts pesquisa seu site do WordPress e retorna as pu­bli­ca­ções que cor­res­pon­dem aos critérios es­pe­ci­fi­ca­dos. Isso ajuda a manter o controle do conteúdo e a se­le­ci­o­nar melhor os artigos.

O que é WP get_posts?

Você já tem seu website em fun­ci­o­na­mento e os vi­si­tan­tes estão acessando o conteúdo. Parece que a maior parte do trabalho está concluída, mas a cada novo artigo, postagem ou subpágina que você adiciona, fica mais difícil manter o controle de tudo. Se você usa o WordPress, a função get_posts pode ser de grande ajuda. Você pode usá-la para pesquisar e compilar posts ou páginas com precisão. Para essa fi­na­li­dade, estão dis­po­ní­veis vários critérios de pesquisa. Não são ne­ces­sá­rios plugins do WordPress adi­ci­o­nais.

Como funciona o WP get_posts?

A função get_posts do WordPress usa critérios de pesquisa para filtrar e recuperar postes, sub­pá­gi­nas ou ca­te­go­rias do seu banco de dados. Há várias opções de critérios de pesquisa para que você possa obter o conteúdo desejado sem precisar clas­si­ficá-lo ma­nu­al­mente. Depois que você define os critérios, o get_posts usa o WP_Query para converter o código PHP em uma consulta SQL. O resultado é uma matriz na forma de objetos WP_Posts. Ex­pli­ca­re­mos exa­ta­mente o que isso significa a seguir.

Como e quando usar get_posts no WordPress

O get_posts do WordPress é uma poderosa função de pesquisa que você pode usar sempre que quiser filtrar e exibir posts es­pe­cí­fi­cos. Isso não é útil apenas para você, mas também permite agregar valor aos vi­si­tan­tes. Você pode fazer isso exibindo postagens de um autor es­pe­cí­fico, sugerindo postagens re­la­ci­o­na­das a um de­ter­mi­nado tópico ou listando seus artigos mais populares.

Qual é a diferença entre as funções get_posts e get_pages do WordPress?

As funções get_posts e get_pages do WP são bastante se­me­lhan­tes. Ambas são usadas para pesquisar o banco de dados e recuperar posts. No entanto, a principal diferença está nos valores e nomes de seus pa­râ­me­tros. get_pages, ao contrário de get_posts, não usa WP_Query, mas executa a pesquisa di­re­ta­mente via SQL. get_pages também não consegue filtrar posts pelos pa­râ­me­tros meta_key e meta_value.

Exemplos de get_posts no WordPress

No exemplo a seguir, mos­tra­re­mos a você como usar get_posts no WordPress. Primeiro, vamos ver como executar uma consulta de pesquisa simples e obter as últimas dez postagens de uma de­ter­mi­nada categoria:

<?php
$args = array(
"numberposts" => 10,
"category" => 5
);
$posts_array = get_posts($args);
?>

Se você quiser usar a função get_posts do WordPress para exibir as pu­bli­ca­ções mais populares, ela fun­ci­o­nará da seguinte forma:

<?php
$args = array(
"numberposts" => 10,
"orderby" => "comment_count"
);
$posts_array = get_posts($args);
foreach($posts_array as $post)
{
echo "<h1>" . $post->post_title . "</h1><br>";
echo "<p>" . $post->post_content . "</p><br>";
}
?>

Neste exemplo, você pode ver que os re­sul­ta­dos são colocados em loop usando o método foreach do tutorial MySQL.

Quais são os pa­râ­me­tros para get_posts no WordPress?

o get_posts no WordPress tem muitos pa­râ­me­tros di­fe­ren­tes que você pode usar. Ao definir os pa­râ­me­tros com precisão, você pode obter re­sul­ta­dos de pesquisa que reflitam com exatidão a consulta pre­ten­dida. Os pa­râ­me­tros mais im­por­tan­tes incluem os seguintes:

• exclude: Esse parâmetro permite que você exclua de­ter­mi­na­dos re­sul­ta­dos de pesquisa. A exclusão é feita por meio do ID do post.
• meta_key: Esse parâmetro só fornecerá re­sul­ta­dos que tenham a chave cor­res­pon­dente.
• meta_value: Pode ser es­pe­ci­fi­cado além de meta_key e es­pe­ci­fi­car o valor da chave.
• num­ber­posts: esse parâmetro es­pe­ci­fica quantos re­sul­ta­dos serão for­ne­ci­dos. Se você o definir como -1, todos os re­sul­ta­dos serão exibidos. Seu valor padrão é 5.
• order: es­pe­ci­fica se os re­sul­ta­dos serão exibidos em ordem crescente ou de­cres­cente. Os valores possíveis são ASC (as­cen­dente) ou DESC (des­cen­dente).
• orderby: Com “order by”, você pode clas­si­fi­car os re­sul­ta­dos que get_posts mostra a você no WordPress de forma ainda mais precisa. “date” (para clas­si­fi­car por data) e “rand” (para ren­de­ri­za­ção aleatória) estão entre os mais populares.
• post_status: es­pe­ci­fica quais postagens devem ser exibidas. Os valores possíveis incluem “draft” (para rascunhos), “publish” (para postagens pu­bli­ca­das) ou “pending” (para pu­bli­ca­ções pla­ne­ja­das).

Resumo: get_posts é uma função do WordPress com muito potencial

A função get_posts é uma fer­ra­menta poderosa para que os usuários do WordPress não apenas tenham uma visão geral de seu próprio conteúdo, mas também forneçam melhores re­sul­ta­dos aos vi­si­tan­tes. A função oferece muitas pos­si­bi­li­da­des e di­fe­ren­tes pa­râ­me­tros para que você possa acessar ra­pi­da­mente o conteúdo que está pro­cu­rando.