{"id":233916,"date":"2023-02-24T11:08:00","date_gmt":"2023-02-24T08:08:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=233916"},"modified":"2022-11-11T13:09:38","modified_gmt":"2022-11-11T10:09:38","slug":"guia-como-consultar-postagens-no-wordpress","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/pt-pt\/guia-como-consultar-postagens-no-wordpress\/","title":{"rendered":"Guia: Como consultar postagens no WordPress"},"content":{"rendered":"\n

Quais m\u00e9todos est\u00e3o dispon\u00edveis para fazer uma consulta de postagem personalizada e quando \u00e9 melhor us\u00e1-los? Este post visa estabelecer uma compreens\u00e3o s\u00f3lida de dois m\u00e9todos de consulta de postagens, como acessar os resultados, como construir argumentos e, finalmente, como limpar depois. Os dois m\u00e9todos que veremos s\u00e3o get_posts()<\/code>e WP_Query<\/code>.<\/p>\n

Quando se trata de fazer uma nova consulta de postagem, existem realmente duas op\u00e7\u00f5es (no momento da reda\u00e7\u00e3o). A escolha realmente depende da sua prefer\u00eancia (e de algum efeito menor no desempenho). Uma op\u00e7\u00e3o tem o potencial de atrapalhar o loop\/consulta global em que voc\u00ea est\u00e1 atualmente, a menos que voc\u00ea a manipule corretamente. Com uma op\u00e7\u00e3o voc\u00ea manipula objetos e na outra op\u00e7\u00e3o voc\u00ea manipula um array. Os argumentos para personalizar a consulta de postagem s\u00e3o, no entanto, id\u00eanticos.<\/p>\n

Consulta global?<\/h2>\n

Se voc\u00ea n\u00e3o tiver certeza do que quero dizer com "estragar a consulta global", \u00e9 isso. O WordPress sempre faz uma consulta global, dependendo da p\u00e1gina em que voc\u00ea est\u00e1. Se um visitante visitar um arquivo de categoria, o WordPress fez uma consulta de postagem para isso O tema normalmente acessaria os posts da consulta usando o “loop" Quando fazemos uma nova consulta com seu pr\u00f3prio loop dentro desse loop, precisamos garantir que a consulta global do WordPress e nossa consulta sejam tratadas separadamente.<\/p>\n

No entanto, se voc\u00ea deseja modificar a consulta de postagem do WordPress, isso \u00e9 outra hist\u00f3ria. Eu tenho outro post<\/a> que se aprofunda sobre como fazer isso.<\/p>\n

Vejamos as duas op\u00e7\u00f5es que temos e como lidamos com elas. Depois disso, veremos os argumentos para personalizar a consulta. Tenha em mente que os argumentos s\u00e3o id\u00eanticos para ambos.<\/p>\n

Os dois m\u00e9todos de consulta de postagens<\/strong><\/h2>\n

Voc\u00ea pode consultar posts com a fun\u00e7\u00e3o get_posts()<\/code>ou fazendo uma nova inst\u00e2ncia de WP_Query.<\/code>A primeira op\u00e7\u00e3o retorna um array de posts e na segunda voc\u00ea manipula um objeto. Como get_posts()<\/code>retorna uma matriz apenas das postagens, geralmente \u00e9 mais simples usar isso em qualquer lugar que voc\u00ea desejar. No entanto, se voc\u00ea deseja paginar sua consulta, definitivamente deve criar uma WP_Query<\/code>inst\u00e2ncia.<\/p>\n

A fun\u00e7\u00e3o get_posts<\/code>\u00e9 uma fun\u00e7\u00e3o wrapper, o WP_Query<\/code>que significa que ela aceita os mesmos argumentos, mas get_posts<\/code>tem alguns argumentos “alias” adicionais. A p\u00e1gina de documenta\u00e7\u00e3o do WordPress para get_posts<\/a> n\u00e3o lista os argumentos poss\u00edveis (exceto os argumentos de alias), mas se refere \u00e0 p\u00e1gina de documenta\u00e7\u00e3o para WP_Query<\/a> para os argumentos. Veremos mais de perto os argumentos mais adiante.<\/p>\n

Se o desempenho \u00e9 um problema (ou seja, o site tem muitos posts), get_posts<\/code>\u00e9 mais r\u00e1pido do que usar WP_Query<\/code>porque pula o c\u00e1lculo para pagina\u00e7\u00e3o.<\/p>\n

O m\u00e9todo de percorrer sua consulta de postagem personalizada difere dependendo do m\u00e9todo escolhido. Voc\u00ea deve estar familiarizado com o loop comum do WordPress usado em quase todos os modelos de tema:<\/p>\n

if (have_posts()) {\n    while (have_posts()): the_post();\n        \/\/ Access to each post; you can use template tags here\n    endwhile;\n}<\/code><\/pre>\n
Loop usando WP_Query<\/strong><\/h3>\n
Fazer um loop dos resultados de using WP_Query<\/code>\u00e9 exatamente o mesmo, exceto que nos referimos especificamente ao objeto de inst\u00e2ncia no loop. Tamb\u00e9m precisamos nos lembrar de “redefinir o estado” depois que terminarmos o loop para que o objeto global post volte ao que era antes. Para isso usamos wp_reset_postdata()<\/code>.<\/p>\n
$custom_query = new WP_Query([\/ Arguments here \/]);\nif ($custom_query->have_posts()) {\n    while ($custom_query->have_posts()): $custom_query->the_post();\n        \/\/ Access to each post; you can use template tags here\n    endwhile;\n    wp_reset_postdata();\n}<\/code><\/pre>\n
Se voc\u00ea despejar o objeto instanciado por WP_Query<\/code>( $custom_query<\/code>no exemplo acima), voc\u00ea encontrar\u00e1 a consulta completa e os argumentos usados. As partes interessantes aqui s\u00e3o as propriedades ‘ found_posts<\/code>‘ e ‘ posts<\/code>‘. A posts<\/code>propriedade ‘ ‘ cont\u00e9m o resultado dos objetos post pelos quais o loop ser\u00e1 executado. O n\u00famero de postagens que corresponderam \u00e0 sua consulta \u00e9 retornado em ‘ found_posts<\/code>‘ e \u00e9 \u00fatil se voc\u00ea deseja fazer uma pagina\u00e7\u00e3o personalizada. Divida este valor com a configura\u00e7\u00e3o do WordPress para o n\u00famero de posts por p\u00e1gina para descobrir quantas p\u00e1ginas voc\u00ea precisa para sua consulta, ou simplesmente consulte a propriedade ‘ max_num_pages<\/code>‘.<\/p>\n
Nota: Quando voc\u00ea usa o get_posts<\/code>WordPress retorna apenas a posts<\/code>propriedade ‘ ‘ (que \u00e9 um array) do WP_Query<\/code>objeto.<\/p>\n
Loop usando get_posts<\/strong><\/h3>\n
Ao usar get_posts<\/code>, n\u00e3o usamos o usual “loop do WordPress”, em vez disso, usamos um loop de array PHP normal. Cada elemento no array s\u00e3o objetos post, e nenhuma redefini\u00e7\u00e3o \u00e9 necess\u00e1ria depois que voc\u00ea terminar o loop. Tenha em mente que as tags de modelo (como the_title()<\/code>, the_permalink()<\/code>etc) n\u00e3o est\u00e3o dispon\u00edveis dentro deste loop. Voc\u00ea precisar\u00e1 consultar as propriedades do objeto post (por exemplo $custom_post->ID<\/code>, ).<\/p>\n
$custom_query = get_posts([\/ Arguments here \/]);\nforeach ($custom_query as $custom_post) {\n    \/\/ Template tags are not available here, refer to the post object properties, for example:\n    echo $custom_post->post_title;\n}<\/code><\/pre>\n
Eu recomendo que voc\u00ea nomeie seus objetos de postagem com algo diferente de $post<\/code>. Voc\u00ea pode encontrar problemas ao tentar acessar as propriedades do post (pode se referir ao objeto global do post e n\u00e3o ao post no loop).<\/p>\n
Se voc\u00ea quiser usar tags de modelo<\/a> para facilitar o acesso \u00e0s informa\u00e7\u00f5es da postagem (como the_title()<\/code>e the_permalink()<\/code>), poder\u00e1 faz\u00ea-lo. Fa\u00e7a isso dizendo ao WordPress para configurar o objeto de postagem global dentro do loop com setup_postdata()<\/code>. Se voc\u00ea fizer isso, precisar\u00e1 redefinir o estado wp_reset_postdata()<\/code>ap\u00f3s o loop.<\/p>\n
$custom_query = get_posts([\/ Arguments here \/]);\nforeach ($custom_query as $post) {\n    setup_postdata($post);\n    \/\/ Template tags are available here, for example:\n    the_title();\n}\nwp_reset_postdata();<\/code><\/pre>\n
Tenha em mente que setup_postdata<\/code>requer que os objetos pelos quais voc\u00ea est\u00e1 fazendo o loop (a as<\/code>parte ” ” no loop foreach) sejam nomeados $post<\/code>! No primeiro exemplo eu nomeei os objetos post $custom_post<\/code>e isso n\u00e3o funcionaria com setup_postdata()<\/code>.<\/p>\n
No entanto, se voc\u00ea s\u00f3 precisa de acesso \u00e0s informa\u00e7\u00f5es b\u00e1sicas do post, voc\u00ea pode pular a configura\u00e7\u00e3o do objeto global do post e usar as get_<\/code>tags " "-template correspondentes e o ID do post. Por exemplo, a tag the_permalink()<\/code>s\u00f3 funciona corretamente se o objeto de postagem global estiver configurado, mas voc\u00ea pode solicitar o link permanente de postagem sem o objeto de postagem global simplesmente usando echo get_the_permalink($custom_post->ID)<\/code>.<\/p>\n
Argumentos da consulta<\/strong><\/h2>\n
Voc\u00ea pode encontrar a lista completa de todos os argumentos poss\u00edveis na p\u00e1gina de documenta\u00e7\u00e3o do WP_Query<\/a>. Exemplos de par\u00e2metros s\u00e3o postagens com termo(s) espec\u00edfico(s) de uma taxonomia, meta valores de postagem, tipos de postagem, inclus\u00e3o ou exclus\u00e3o de postagens espec\u00edficas e toda uma gama de op\u00e7\u00f5es para ordenar os resultados. H\u00e1 muitos para analisar cada um em detalhes, mas aqui est\u00e3o alguns exemplos comuns de argumentos para consultar postagens.<\/p>\n
Exemplo 1: postagens relacionadas da mesma categoria<\/h3>\n
Digamos que voc\u00ea queira mostrar “posts relacionados” no final de um \u00fanico post. Deve mostrar uma sele\u00e7\u00e3o aleat\u00f3ria de 3 posts que est\u00e3o na mesma categoria do post atual e deve excluir o post atual do resultado.<\/p>\n
$post_id = get_the_ID();  \/\/ current post ID\n$custom_query = new WP_Query([\n    'post_type' => 'post',\n    'posts_per_page' => 3,\n    'category__in' => wp_get_post_categories($post_id),\n    'post__not_in' => [$post_id],\n    'orderby' => 'rand'\n]);<\/code><\/pre>\n
Os argumentos s\u00e3o bastante autoexplicativos. Pe\u00e7o apenas ‘ post<\/code>‘ em ‘ post_type<\/code>e no m\u00e1ximo 3 posts em ‘ posts_per_page'<\/code>.<\/p>\n
Para consultar posts em categorias, voc\u00ea pode construir uma tax_query<\/a> ou usar o mais simples ‘ category__in<\/code>‘ (NB: S\u00f3 funciona para categoria de post). No exemplo acima eu uso wp_get_post_categories()<\/code>para obter uma matriz de IDs de termo atribu\u00eddos ao post fornecido e uso isso para o argumento ‘ category__in<\/code>‘.<\/p>\n
Voc\u00ea pode excluir IDs de postagem com ‘ post__not_in<\/code>‘ enquanto eu forneci o ID de postagem atual. Por fim, pedi uma ordem aleat\u00f3ria de posts configurando ‘ rand<\/code>‘em’ orderby<\/code>‘. Voc\u00ea pode fornecer, por exemplo, ‘ title<\/code>‘ ou ‘ date<\/code>‘ para orden\u00e1-los de maneira diferente. D\u00ea uma olhada na documenta\u00e7\u00e3o para encomendar<\/a> para ver o que \u00e9 poss\u00edvel.<\/p>\n
Exemplo 2: todas as postagens de um tipo de postagem personalizado com v\u00e1rios argumentos de ordena\u00e7\u00e3o<\/h3>\n
Neste exemplo, assumimos que voc\u00ea tem um tipo de postagem personalizado ‘ book<\/code>‘ e em um modelo de p\u00e1gina personalizado voc\u00ea deseja exibir todos os livros publicados. Voc\u00ea deseja ordenar as postagens principalmente por menu_order (o atributo da p\u00e1gina, \u00e9 um n\u00famero que voc\u00ea pode definir por postagem) e, em segundo lugar, pelo t\u00edtulo da postagem.<\/p>\n
$custom_query = new WP_Query([\n    'post_type' => 'book',\n    'posts_per_page' => -1,\n    'orderby' => ['meny_order' => 'ASC', 'title' => 'DESC']\n]);<\/code><\/pre>\n
Novamente, os argumentos s\u00e3o bastante autoexplicativos. Solicito o tipo de postagem ‘ book<\/code>‘ como ‘ post_type<\/code>‘. Quando voc\u00ea definir ‘ posts_per_page<\/code>‘ para -1 ele ir\u00e1 buscar todos (posts publicados, a menos que voc\u00ea especifique algo diferente no post_status<\/code>argumento ‘ ). Finalmente, forne\u00e7o um array para ‘ orderby<\/code>‘ para dizer ao WordPress para classificar as postagens principalmente por ordem de menu em ordem crescente e, em segundo lugar, t\u00edtulo de postagem em ordem decrescente.<\/p>\n
Exemplo 3: postagens com metadados personalizados<\/h3>\n
Vamos supor que voc\u00ea tenha um tipo de postagem personalizado ‘ book<\/code>‘ e deseja consultar todos os livros in\u00e9ditos ou um livro publicado entre os anos de 1990 e 2019.<\/p>\n
$custom_query = new WP_Query([\n    'post_type' => 'book',\n    'posts_per_page' => -1,\n    'meta_query' => [\n        'relation' => 'OR',\n        [\n            'key' => 'book_status',\n            'value' => 'unpublished',\n            'compare' => '='\n        ],\n        [\n            'key' => 'year_published',\n            'value' => [1990, 2019],\n            'type' => 'numeric',\n            'compare' => 'BETWEEN'\n        ]\n    ]\n]);<\/code><\/pre>\n
Construir uma consulta usando post meta \u00e9 melhor feito com meta_query<\/code>(para argumentos meta muito simples, voc\u00ea pode usar meta_key<\/code>e meta_value<\/code>diretamente). O meta_query<\/code>argumento ‘ ‘ requer um array, onde cada argumento \u00e9 um array. Voc\u00ea pode controlar a rela\u00e7\u00e3o entre cada argumento com ‘ relation<\/code>‘, que eu configurei para ‘ OR<\/code>‘ no exemplo acima.<\/p>\n
Eu forne\u00e7o dois argumentos de metadados para ‘ meta_query<\/code>‘. A primeira simplesmente compara a meta-chave ‘ book_status<\/code>‘ com o texto ‘ unpublished<\/code>, e se for igual ela ser\u00e1 inclu\u00edda. No segundo argumento eu digo ao WordPress para obter qualquer valor na meta-chave ‘ year_published<\/code>‘ que esteja entre os n\u00fameros 1990 e 2019.<\/p>\n
Conclus\u00e3o<\/h2>\n
Agora voc\u00ea deve ter uma compreens\u00e3o b\u00e1sica dos dois m\u00e9todos de consulta de postagens. N\u00e3o h\u00e1 uma grande diferen\u00e7a, pois voc\u00ea pode criar a mesma consulta usando os dois, mas a maneira de lidar com os dois \u00e9 diferente. Os tr\u00eas exemplos fornecidos de argumentos de consulta apenas tocam na superf\u00edcie de quais consultas voc\u00ea pode criar. Consulte a documenta\u00e7\u00e3o do WP_Query<\/a> para obter uma vis\u00e3o geral completa com muitos exemplos.<\/p>\n
Se voc\u00ea est\u00e1 curioso sobre como modificar a consulta global que o WordPress executa, tenho um post separado<\/a> detalhando isso.<\/p>\n
Fonte de grava\u00e7\u00e3o:  awhitepixel.com<\/a><\/div><\/p>\n","protected":false},"excerpt":{"rendered":"
Neste guia, veremos dois m\u00e9todos de consulta de posts no WordPress (get_posts e WP_Query), como acessar cada post e construir argumentos.<\/p>\n","protected":false},"author":1,"featured_media":224094,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":"","_wp_rev_ctl_limit":""},"categories":[930,898,898,722,722,920,1110,920,806,806,930,846,846,867,867],"tags":[1170],"class_list":["post-233916","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-assuntos","category-codigo-2","category-desenvolvedor","category-outro","category-n-a","category-php-8","category-tutoriais","category-wordpress-8","tag-affiai-pt-pt"],"_links":{"self":[{"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/posts\/233916","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/comments?post=233916"}],"version-history":[{"count":0,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/posts\/233916\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/media\/224094"}],"wp:attachment":[{"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/media?parent=233916"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/categories?post=233916"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/tags?post=233916"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}