Dans cette derni\u00e8re le\u00e7on, nous apprenons \u00e0 \u00e9crire votre propre requ\u00eate de messages et \u00e0 les parcourir sans interrompre la boucle parent dans le mod\u00e8le. Nous allons cr\u00e9er une partie de mod\u00e8le pour les articles uniques qui affiche les articles associ\u00e9s dans la m\u00eame cat\u00e9gorie.<\/p>\n
Ce que nous allons faire dans cette le\u00e7on est une requ\u00eate de publications associ\u00e9es dans notre vue de publication unique, montrant un maximum de 3 publications, de type publication, dans la ou les m\u00eames cat\u00e9gories que la publication dans laquelle nous nous trouvons, exclure la publication actuelle elle-m\u00eame, et randomiser les messages affich\u00e9s. Nous examinerons \u00e9galement des strat\u00e9gies pour ne pas g\u00e2cher la boucle imbriqu\u00e9e.<\/p>\n
Faisons des articles associ\u00e9s une partie du mod\u00e8le, dont nous avons entendu parler dans la partie 10<\/a>. De cette fa\u00e7on, nous ne compliquons pas trop Maintenant, cr\u00e9ons un nouveau fichier vide dans notre dossier de th\u00e8me et nommons-le Si vous souhaitez effectuer une requ\u00eate personnalis\u00e9e de messages, vous avez quelques options, mais je vous recommande de vous habituer \u00e0 la classe Si vous voulez en savoir plus sur la fa\u00e7on d’interroger les messages, j’ai un article<\/a> qui va en profondeur \u00e0 ce sujet.<\/p>\n Afin de cr\u00e9er une requ\u00eate de publication personnalis\u00e9e, nous appellerons Voici \u00e0 quoi ressemblera la boucle lors de son ajout \u00e0 une requ\u00eate personnalis\u00e9e\u00a0:<\/p>\n Comme vous pouvez le voir, la boucle est exactement la m\u00eame, en utilisant Vous remarquerez peut-\u00eatre \u00e9galement l’appel de la fonction Tr\u00e8s bien, commen\u00e7ons \u00e0 impl\u00e9menter la boucle personnalis\u00e9e dans notre fichier Nous allons maintenant voir la puissance de la r\u00e9utilisation dans les pi\u00e8ces de mod\u00e8le. Disons qu’\u00e0 l’int\u00e9rieur de cette boucle personnalis\u00e9e, nous voulons afficher exactement le m\u00eame contenu que dans notre Il ne reste plus qu’\u00e0 ajouter les arguments \u00e0 notre requ\u00eate post, en s’assurant que nous r\u00e9cup\u00e9rons ce que nous voulons. Passons en revue les arguments un par un.<\/p>\n Nous ne voulons pas r\u00e9cup\u00e9rer plus de messages que 3. Dans la documentation (section "Param\u00e8tres de pagination"), l’argument pour cela est Nous voulons nous assurer que WordPress r\u00e9cup\u00e8re les publications, et non les pages ou autre chose. Dans \u00abPost type parameters\u00bb on trouve :<\/p>\n Nous voulons emp\u00eacher que la publication unique \u00e0 laquelle nous nous trouvons n’apparaisse dans notre requ\u00eate de publications connexes, car cela n’a aucun sens, n’est-ce pas\u00a0? La documentation nous indique dans \u00abPost & Page parameters\u00bb que l’on peut ajouter l’ID de publication dans un tableau pour Nous voulons \u00e9galement randomiser les messages\u00a0; car par d\u00e9faut, il r\u00e9cup\u00e9rera les derniers messages publi\u00e9s et cela peut rapidement devenir assez r\u00e9p\u00e9titif au fur et \u00e0 mesure que vous parcourez les messages. Heureusement, WordPress a une fonction pour cela dans la fa\u00e7on dont il ordonne les publications ; dans \u00abOrdre et ordre par param\u00e8tres\u00bb on trouve :<\/p>\n Enfin, nous souhaitons interroger les publications appartenant aux m\u00eames cat\u00e9gories que la publication dans laquelle nous nous trouvons. Pour ce faire, nous devons d’abord, avant les arguments de requ\u00eate, obtenir les cat\u00e9gories au poste unique o\u00f9 nous nous trouvons. Dans "Param\u00e8tres de cat\u00e9gorie", nous voyons que nous pouvons fournir un tableau d’ID de cat\u00e9gorie \u00e0 Voici la requ\u00eate finale et ses arguments\u00a0:<\/p>\n Actualisez et vous devriez voir 3 messages r\u00e9pertori\u00e9s au bas de la vue unique. Actualisez plusieurs fois pour voir qu’ils changent parce que nous avons dit \u00e0 WordPress de les randomiser. Remarque: Si vous avez moins de 3 messages dans la m\u00eame cat\u00e9gorie, vous obtiendrez moins de 3 messages.<\/p>\n C’est \u00e7a! Vous savez maintenant comment interroger les messages que vous souhaitez. La page de documentation WP_Query<\/a> est extr\u00eamement utile pour peaufiner votre requ\u00eate, car ce sont vraiment des possibilit\u00e9s illimit\u00e9es ici. Je vous encourage \u00e0 jouer avec les param\u00e8tres et peut-\u00eatre \u00e0 essayer de cr\u00e9er une partie de mod\u00e8le distincte \u00e0 utiliser pour les publications connexes.<\/p>\nsingle.php<\/code>et rendons notre code plus r\u00e9utilisable. Placez la demande de cette nouvelle partie de mod\u00e8le o\u00f9 vous le souhaitez. Je le placerai juste avant de demander le mod\u00e8le de commentaires\u00a0:<\/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>. Avec ce fichier, nous sommes pr\u00eats \u00e0 plonger dans la cr\u00e9ation d’une requ\u00eate de publication personnalis\u00e9e.<\/p>\nRequ\u00eate de publication personnalis\u00e9e<\/h2>\n
WP_Query<\/code>. Ajoutez cette page de documentation<\/a> \u00e0 vos favoris car vous y ferez fr\u00e9quemment r\u00e9f\u00e9rence, car il y a tellement d’options. Je vais vous montrer un exemple pratique de mise en place d’une requ\u00eate en me r\u00e9f\u00e9rant \u00e0 la documentation de chaque sp\u00e9cification que nous voulons ajouter.<\/p>\nnew WP_Query()<\/code>, lui transmettrons un tableau d’arguments et stockerons son r\u00e9sultat dans une variable. Et ensuite, nous utiliserons exactement la m\u00eame boucle que celle que nous avons utilis\u00e9e auparavant dans nos mod\u00e8les (jetez un coup d’\u0153il \u00e0 la boucle d’origine ici<\/a> pour comparer). Mais nous devons dire \u00e0 la boucle de passer par la variable, au lieu de la globale (qui est le poste unique).<\/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>et the_post<\/code>. La diff\u00e9rence est que nous les appelons sur l’ $related_posts<\/code>objet. Si nous sautons la $related_posts<\/code>partie, WordPress suppose automatiquement qu’il s’agit de la requ\u00eate globale des publications.<\/p>\nwp_reset_postdata()<\/code>juste apr\u00e8s la boucle. C’est ainsi que nous "nettoyons apr\u00e8s nous-m\u00eames" apr\u00e8s une requ\u00eate personnalis\u00e9e avec WP_Query<\/code>. N’oubliez pas que cela configure l’objet de publication global afin que the_post()<\/code>nous puissions utiliser the_title()<\/code>etc. single.php<\/code>nous nettoyons et r\u00e9initialisons la publication \u00e0 la publication unique une fois que nous avons termin\u00e9. Si nous ne r\u00e9initialisons pas les donn\u00e9es post\u00e9es, tout ce qui suit fera r\u00e9f\u00e9rence \u00e0 la derni\u00e8re publication connexe que nous avons parcourue. Cela peut \u00eatre un gros probl\u00e8me\u00a0! Dans notre exemple, nous avoir un mod\u00e8le de commentaires qui suit ceci. En omettant la r\u00e9initialisation, le mod\u00e8le de commentaire affichera les commentaires du dernier message associ\u00e9 dans la boucle. Et pas le seul message que nous examinons r\u00e9ellement\u00a0!<\/p>\nImpl\u00e9mentation de notre boucle personnalis\u00e9e<\/h3>\n
related-posts.php<\/code>. J’ai ajout\u00e9 un wrapper et un titre, mais comme d’habitude vous pouvez ajuster le HTML comme vous le souhaitez :<\/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 nous utilisons dans nos mod\u00e8les d’archive. Tout ce que nous avons \u00e0 faire est de demander cette partie de mod\u00e8le dans notre boucle personnalis\u00e9e, nous sommes tous pr\u00eats \u00e0 g\u00e9rer la sortie de chaque publication\u00a0!<\/p>\n...\n while ($related_posts->have_posts()): $related_posts->the_post();\n get_template_part('content-loop');\n endwhile;\n...<\/code><\/pre>\nConstruire les arguments de notre requ\u00eate de publication personnalis\u00e9e<\/h2>\n
posts_per_page<\/code>. Nous ajoutons donc l’\u00e9l\u00e9ment de tableau\u00a0:<\/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>. Heureusement, WordPress a une fonction pour obtenir les identifiants de cat\u00e9gorie pour un article ; wp_get_post_categories()<\/code>que nous pouvons utiliser directement comme valeur du param\u00e8tre. Parfait!<\/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