Nesta li\u00e7\u00e3o final, aprendemos como escrever sua pr\u00f3pria consulta de postagens e fazer um loop por elas sem interromper o loop pai no modelo. Faremos uma parte de modelo para postagens \u00fanicas que mostre postagens relacionadas na mesma categoria.<\/p>\n
O que faremos nesta li\u00e7\u00e3o \u00e9 uma consulta de postagens relacionadas em nossa visualiza\u00e7\u00e3o de postagem \u00fanica, mostrando no m\u00e1ximo 3 postagens, do tipo postagem, na mesma categoria ou categorias da postagem em que estamos, exclua a postagem atual em si, e randomize os posts mostrados. Tamb\u00e9m veremos estrat\u00e9gias para n\u00e3o atrapalhar o loop aninhado.<\/p>\n
Vamos fazer das postagens relacionadas uma parte do modelo, sobre a qual aprendemos na parte 10<\/a>. Dessa forma, n\u00e3o complicamos demais Agora, vamos criar um novo arquivo vazio em nossa pasta de temas e nome\u00e1-lo Se voc\u00ea quiser fazer uma consulta personalizada de posts, tem algumas op\u00e7\u00f5es, mas recomendo se acostumar com a classe Se voc\u00ea quiser saber mais sobre como consultar posts, eu tenho um post<\/a> que detalha exatamente isso.<\/p>\n Para fazer uma p\u00f3s-consulta personalizada, chamaremos \u00c9 assim que o loop ficar\u00e1 ao adicion\u00e1-lo a uma consulta personalizada:<\/p>\n Como voc\u00ea pode ver, o loop \u00e9 exatamente o mesmo, usando Voc\u00ea tamb\u00e9m pode notar a chamada da fun\u00e7\u00e3o Tudo bem, vamos come\u00e7ar a implementar o loop personalizado em nosso Agora veremos o poder da reutiliza\u00e7\u00e3o nas partes do modelo. Digamos que dentro desse loop personalizado queremos mostrar exatamente o mesmo conte\u00fado que fazemos em nosso Agora tudo o que resta \u00e9 adicionar os argumentos \u00e0 nossa consulta de postagem, certificando-se de buscar o que queremos. Vamos analisar os argumentos um por um.<\/p>\n N\u00e3o queremos buscar mais posts do que 3. Na documenta\u00e7\u00e3o (se\u00e7\u00e3o “Par\u00e2metros de pagina\u00e7\u00e3o") o argumento para isso \u00e9 Queremos garantir que o WordPress busque posts, e n\u00e3o p\u00e1ginas ou qualquer outra coisa. Em “Par\u00e2metros de tipo de postagem” encontramos:<\/p>\n Queremos evitar que a \u00fanica postagem em que estamos apare\u00e7a em nossa consulta de postagens relacionadas, porque isso n\u00e3o faz sentido, certo? A documenta\u00e7\u00e3o nos diz em “Par\u00e2metros de postagem e p\u00e1gina” que podemos adicionar o ID da postagem em uma matriz para Tamb\u00e9m queremos randomizar as postagens; porque, por padr\u00e3o, ele buscar\u00e1 as \u00faltimas postagens publicadas e isso pode rapidamente se tornar bastante repetitivo \u00e0 medida que voc\u00ea passa pelas postagens. Felizmente o WordPress tem uma fun\u00e7\u00e3o para isso na forma como ordena os posts; em “Ordenar e ordenar por par\u00e2metros” encontramos:<\/p>\n Por fim, queremos consultar postagens que estejam dentro das mesmas categorias da postagem em que estamos. Para fazer isso, precisamos primeiro, antes dos argumentos da consulta, obter as categorias para o \u00fanico post em que estamos. Em “Par\u00e2metros de categoria” vemos que podemos fornecer uma matriz de IDs de categoria para Aqui est\u00e1 a consulta final e seus argumentos:<\/p>\n Atualize e voc\u00ea ver\u00e1 3 postagens listadas na parte inferior da visualiza\u00e7\u00e3o \u00fanica. Atualize v\u00e1rias vezes para ver que eles mudam porque dissemos ao WordPress para randomiz\u00e1-los. Nota: Se voc\u00ea tiver menos de 3 postagens na mesma categoria, receber\u00e1 menos de 3 postagens.<\/p>\n \u00c9 isso! Agora voc\u00ea sabe como consultar as postagens que desejar. A p\u00e1gina de documenta\u00e7\u00e3o WP_Query<\/a> \u00e9 extremamente \u00fatil para ajustar sua consulta, porque h\u00e1 possibilidades realmente ilimitadas aqui. Eu encorajo voc\u00ea a brincar com os par\u00e2metros e talvez tentar fazer uma parte de modelo separada para usar em posts relacionados.<\/p>\nsingle.php<\/code>e tornamos nosso c\u00f3digo mais reutiliz\u00e1vel. Coloque o pedido desta nova pe\u00e7a de modelo onde desejar. Vou coloc\u00e1-lo logo antes de solicitar o modelo de coment\u00e1rios:<\/p>\n...\n <\/article>\n <?php \n get_template_part('related-posts');\n if (comments_open()) {\n comments_template();\n }\n endwhile;\n...<\/code><\/pre>\nrelated-posts.php<\/code>. Com este arquivo, estamos prontos para mergulhar na cria\u00e7\u00e3o de uma consulta de postagem personalizada.<\/p>\nConsulta de postagem personalizada<\/h2>\n
WP_Query<\/code>. Marque esta p\u00e1gina de documenta\u00e7\u00e3o<\/a> como favorita, pois voc\u00ea a consultar\u00e1 com frequ\u00eancia, pois h\u00e1 muitas op\u00e7\u00f5es. Mostrarei um exemplo pr\u00e1tico de como configurar uma consulta consultando a documenta\u00e7\u00e3o de cada especifica\u00e7\u00e3o que desejamos adicionar.<\/p>\nnew WP_Query()<\/code>, passaremos um array de argumentos para ela e armazenaremos seu resultado em uma vari\u00e1vel. E ent\u00e3o usaremos exatamente o mesmo loop que usamos antes em nossos modelos (d\u00ea uma olhada no loop original aqui<\/a> para comparar). Mas precisamos dizer ao loop para passar pela vari\u00e1vel, em vez da global (que \u00e9 o post \u00fanico).<\/p>\n$related_posts = new WP_Query([\n \/\/ Arguments here\n]);\nif ($related_posts->have_posts()) {\n while ($related_posts->have_posts()): $related_posts->the_post();\n \/\/ Access to each post here\n endwhile;\n wp_reset_postdata();\n}<\/code><\/pre>\nhave_posts<\/code>and the_post<\/code>. A diferen\u00e7a \u00e9 que n\u00f3s os chamamos para o $related_posts<\/code>objeto. Se pularmos a $related_posts<\/code>parte, o WordPress automaticamente assume que \u00e9 a consulta global de postagens.<\/p>\nwp_reset_postdata()<\/code>logo ap\u00f3s o loop. \u00c9 assim que "limpamos depois de n\u00f3s mesmos" depois de uma consulta personalizada com WP_Query<\/code>. Lembre-se que the_post()<\/code>configura o objeto global post para que possamos usar the_title()<\/code>etc. E como j\u00e1 estamos dentro de um loop (o de single.php<\/code>), precisamos ter certeza n\u00f3s limpamos e redefinimos a postagem de volta para a postagem \u00fanica depois de terminarmos. Se n\u00e3o redefinirmos os postdata, qualquer coisa depois disso se referir\u00e1 \u00e0 \u00faltima postagem relacionada que passamos. Isso pode ser um grande problema! Em nosso exemplo, tem um modelo de coment\u00e1rios que segue isso. Deixar de fora a redefini\u00e7\u00e3o far\u00e1 com que o modelo de coment\u00e1rio mostre coment\u00e1rios do \u00faltimo post relacionado no loop. E n\u00e3o o \u00fanico post que estamos vendo!<\/p>\nImplementando nosso loop personalizado<\/h3>\n
related-posts.php<\/code>. Eu adicionei um wrapper e um t\u00edtulo, mas como de costume voc\u00ea pode ajustar o HTML como desejar:<\/p>\n<div class=\"related-posts\">\n <h2><?php _e('Related posts', 'wptutorial'); ?><\/h2>\n <?php\n $related_posts = new WP_Query([\n ]);\n if ($related_posts->have_posts()) {\n while ($related_posts->have_posts()): $related_posts->the_post();\n\u00a0\n endwhile;\n wp_reset_postdata();\n }\n ?>\n<\/div><\/code><\/pre>\ncontent-loop.php<\/code>, que usamos em nossos modelos de arquivo. Tudo o que precisamos fazer \u00e9 solicitar essa parte do modelo dentro de nosso loop personalizado, se estamos prontos para lidar com a sa\u00edda de cada postagem!<\/p>\n...\n while ($related_posts->have_posts()): $related_posts->the_post();\n get_template_part('content-loop');\n endwhile;\n...<\/code><\/pre>\nCriando os argumentos para nossa consulta de postagem personalizada<\/h2>\n
posts_per_page<\/code>. Ent\u00e3o adicionamos o elemento array:<\/p>\n'posts_per_page' => 3<\/code><\/pre>\n'post_type' => 'post'<\/code><\/pre>\npost__not_in<\/code>:<\/p>\n'post__not_in' => [get_the_ID()]<\/code><\/pre>\n'orderby' => 'rand'<\/code><\/pre>\ncategory__in<\/code>. Felizmente, o WordPress tem uma fun\u00e7\u00e3o para obter IDs de categoria para um post; wp_get_post_categories()<\/code>que podemos usar diretamente como valor para o par\u00e2metro. Perfeito!<\/p>\n...\n<?php\n $post_cats = wp_get_post_categories(get_the_ID());\n $related_posts = new WP_Query([\n 'post_type' => 'post',\n 'posts_per_page' => 3,\n 'category__in' => $post_cats,\n 'post__not_in' => [get_the_ID()],\n 'orderby' => 'rand'\n ]);\n if ($related_posts->have_posts()) {\n...<\/code><\/pre>\n