T\u00e4ll\u00e4 viimeisell\u00e4 oppitunnilla opimme kirjoittamaan oman kyselysi viesteist\u00e4 ja kiert\u00e4m\u00e4\u00e4n niit\u00e4 keskeytt\u00e4m\u00e4tt\u00e4 mallin yl\u00e4silmukkaa. Teemme yksitt\u00e4isille viesteille malliosan, jossa n\u00e4kyv\u00e4t samaan kategoriaan liittyv\u00e4t viestit.<\/p>\n
T\u00e4ll\u00e4 oppitunnilla teemme aiheeseen liittyv\u00e4n viestikyselyn yksitt\u00e4isess\u00e4 viestin\u00e4kym\u00e4ss\u00e4mme, joka n\u00e4ytt\u00e4\u00e4 enint\u00e4\u00e4n 3 viesti\u00e4, viestityyppist\u00e4 viesti\u00e4, samassa kategoriassa tai samassa kategoriassa kuin viesti, jossa olemme. Sulje pois itse nykyinen viesti, ja satunnaisesti n\u00e4ytetyt viestit. Tutkimme my\u00f6s strategioita, joilla sis\u00e4kk\u00e4ist\u00e4 silmukkaa ei sotketa.<\/p>\n
Tehd\u00e4\u00e4n aiheeseen liittyvist\u00e4 viesteist\u00e4 malliosa, josta opimme osassa 10<\/a>. N\u00e4in emme monimutkaise liikaa Tehd\u00e4\u00e4n nyt uusi tyhj\u00e4 tiedosto teemakansioomme ja nimet\u00e4\u00e4n se Jos haluat tehd\u00e4 mukautetun kyselyn viesteist\u00e4, sinulla on joitain vaihtoehtoja, mutta suosittelen tottumaan luokkaan Jos haluat oppia lis\u00e4\u00e4 viestien tekemisest\u00e4, minulla on viesti<\/a>, joka k\u00e4sittelee perusteellisesti juuri sit\u00e4.<\/p>\n Mukautetun viestikyselyn tekemiseksi kutsumme, v\u00e4lit\u00e4mme Silmukka n\u00e4ytt\u00e4\u00e4 t\u00e4lt\u00e4, kun se lis\u00e4t\u00e4\u00e4n mukautettuun kyselyyn:<\/p>\n Kuten n\u00e4et, silmukka on t\u00e4sm\u00e4lleen sama, k\u00e4ytt\u00e4m\u00e4ll\u00e4 Saatat my\u00f6s huomata funktiokutsun Selv\u00e4, aloitetaan mukautetun silmukan k\u00e4ytt\u00f6\u00f6notto Nyt n\u00e4emme uudelleenk\u00e4ytett\u00e4vyyden voiman mallin osissa. Oletetaan, ett\u00e4 t\u00e4m\u00e4n mukautetun silmukan sis\u00e4ll\u00e4 haluamme n\u00e4ytt\u00e4\u00e4 t\u00e4sm\u00e4lleen saman sis\u00e4ll\u00f6n kuin Nyt j\u00e4ljell\u00e4 on vain argumenttien lis\u00e4\u00e4minen viestikyselyymme varmistaen, ett\u00e4 haemme haluamamme. K\u00e4yd\u00e4\u00e4n argumentit yksitellen l\u00e4pi.<\/p>\n Haluamme hakea enint\u00e4\u00e4n 3 viesti\u00e4. Dokumentaatiossa (osio "Sivutusparametrit") argumentti t\u00e4lle on Haluamme varmistaa, ett\u00e4 WordPress hakee viestit, ei sivuja tai jotain muuta. Kohdasta "Viestityyppiparametrit" l\u00f6yd\u00e4mme:<\/p>\n Haluamme est\u00e4\u00e4 sen, ett\u00e4 yksitt\u00e4inen viesti, jossa olemme, ei n\u00e4y aiheeseen liittyvien viestien kyselyss\u00e4mme, koska siin\u00e4 ei ole mit\u00e4\u00e4n j\u00e4rke\u00e4, eik\u00f6 niin? Dokumentaatiossa kerrotaan "Viesti- ja sivuparametrit" -kohdassa, ett\u00e4 voimme lis\u00e4t\u00e4 viestitunnuksen taulukkoon Haluamme my\u00f6s satunnaistaa viestit; koska oletuksena se hakee viimeisimm\u00e4t julkaistut viestit, ja siit\u00e4 voi nopeasti tulla melko toistuvaa, kun k\u00e4yt viestej\u00e4 l\u00e4pi. Onneksi WordPressill\u00e4 on t\u00e4h\u00e4n toiminto, miten se j\u00e4rjest\u00e4\u00e4 viestit; "Tilaa ja j\u00e4rjestele parametrien mukaan" l\u00f6yd\u00e4mme:<\/p>\n Lopuksi haluamme kysy\u00e4 viesteist\u00e4, jotka kuuluvat samoihin luokkiin kuin viesti, jossa olemme. T\u00e4t\u00e4 varten meid\u00e4n on ensin, ennen kyselyargumentteja, saatava luokat yhteen viestiin, jossa olemme. Kohdassa "Luokkaparametrit" n\u00e4emme, ett\u00e4 voimme tarjota joukon luokkatunnuksia T\u00e4ss\u00e4 viimeinen kysely ja sen argumentit:<\/p>\n P\u00e4ivit\u00e4 ja sinun pit\u00e4isi n\u00e4hd\u00e4 3 viesti\u00e4 yhden n\u00e4kym\u00e4n alareunassa. P\u00e4ivit\u00e4 useita kertoja n\u00e4hd\u00e4ksesi, ett\u00e4 ne muuttuvat, koska k\u00e4skimme WordPressi\u00e4 satunnaistaa ne. Huomautus: Jos sinulla on v\u00e4hemm\u00e4n kuin 3 viesti\u00e4 samassa kategoriassa, saat alle 3 viesti\u00e4.<\/p>\n Se siit\u00e4! Nyt tied\u00e4t kuinka kysy\u00e4 mit\u00e4 tahansa haluamiasi viestej\u00e4. WP_Query -dokumentaatiosivu<\/a> on eritt\u00e4in hy\u00f6dyllinen kyselysi s\u00e4\u00e4t\u00e4misess\u00e4, koska siell\u00e4 on todella rajattomat mahdollisuudet. Kehotan sinua leikki\u00e4 parametrien kanssa ja ehk\u00e4 yritt\u00e4\u00e4 tehd\u00e4 erillisen malliosan k\u00e4ytett\u00e4v\u00e4ksi aiheeseen liittyville viesteille.<\/p>\nsingle.php<\/code>ja tee koodistamme uudelleenk\u00e4ytett\u00e4vyytt\u00e4. Aseta t\u00e4m\u00e4n uuden malliosan pyynt\u00f6 minne haluat. Laitan sen juuri ennen kommenttimallin pyyt\u00e4mist\u00e4:<\/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>. T\u00e4m\u00e4n tiedoston avulla olemme valmiita sukeltamaan mukautetun viestikyselyn luomiseen.<\/p>\nMukautettu viestikysely<\/h2>\n
WP_Query<\/code>. Merkitse t\u00e4m\u00e4 dokumentaatiosivu<\/a> kirjanmerkkeihin, koska tulet k\u00e4ytt\u00e4m\u00e4\u00e4n sit\u00e4 usein, koska vaihtoehtoja on niin monia. N\u00e4yt\u00e4n sinulle k\u00e4yt\u00e4nn\u00f6n esimerkin kyselyn m\u00e4\u00e4ritt\u00e4misest\u00e4 viittaamalla kunkin lis\u00e4tt\u00e4v\u00e4n spesifikaation dokumentaatioon.<\/p>\nnew WP_Query()<\/code>sille joukon argumentteja ja tallennamme sen tuloksen muuttujaan. Ja sitten k\u00e4yt\u00e4mme t\u00e4sm\u00e4lleen samaa silmukkaa kuin olemme k\u00e4ytt\u00e4neet aiemmin malleissamme (kurkista alkuper\u00e4ist\u00e4 silmukkaa t\u00e4st\u00e4<\/a> vertaillaksesi). Mutta meid\u00e4n on kerrottava silmukalle, ett\u00e4 se k\u00e4y l\u00e4pi muuttujan globaalin (joka on yksitt\u00e4inen viesti) sijaan.<\/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>ja the_post<\/code>. Erona on, ett\u00e4 kutsumme niit\u00e4 $related_posts<\/code>esineeseen. Jos ohitamme $related_posts<\/code>osan, WordPress olettaa sen automaattisesti olevan viestien globaali kysely.<\/p>\nwp_reset_postdata()<\/code>heti silmukan j\u00e4lkeen. N\u00e4in "siivoamme j\u00e4lkemme" mukautetun kyselyn j\u00e4lkeen WP_Query<\/code>. Muista, ett\u00e4 se the_post()<\/code>asettaa globaalin post-objektin, jotta voimme k\u00e4ytt\u00e4\u00e4 the_title()<\/code>jne. Ja koska olemme jo silmukan sis\u00e4ll\u00e4 (jossa on single.php<\/code>), meid\u00e4n on varmistettava, ett\u00e4 puhdistamme ja nollaamme viestin takaisin yksitt\u00e4iseksi viestiksi, kun olemme valmiita. Jos emme nollaa j\u00e4lkitietoja, kaikki t\u00e4m\u00e4n j\u00e4lkeen viittaavat viimeisimp\u00e4\u00e4n aiheeseen liittyv\u00e4\u00e4n viestiin, jonka k\u00e4vimme l\u00e4pi. T\u00e4m\u00e4 voi olla suuri ongelma! Esimerkiss\u00e4mme on kommenttimalli, joka seuraa t\u00e4t\u00e4. Jos nollaus j\u00e4tet\u00e4\u00e4n pois, kommenttimalli n\u00e4ytt\u00e4\u00e4 kommentit silmukan viimeisest\u00e4 aiheeseen liittyv\u00e4st\u00e4 viestist\u00e4. Eik\u00e4 ainoatakaan viesti\u00e4, jota tarkastelemme!<\/p>\nToteutamme mukautetun silmukamme<\/h3>\n
related-posts.php<\/code>. Lis\u00e4sin k\u00e4\u00e4reen ja otsikon, mutta tavalliseen tapaan voit muokata HTML:\u00e4\u00e4 haluamallasi tavalla:<\/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>, jota k\u00e4yt\u00e4mme arkistomalleissamme. Meid\u00e4n tarvitsee vain pyyt\u00e4\u00e4 t\u00e4m\u00e4 malliosa mukautetussa silmukassamme, olemmeko valmiita k\u00e4sittelem\u00e4\u00e4n jokaisen viestin tulosteen!<\/p>\n...\n while ($related_posts->have_posts()): $related_posts->the_post();\n get_template_part('content-loop');\n endwhile;\n...<\/code><\/pre>\nMuokatun viestikyselymme argumenttien rakentaminen<\/h2>\n
posts_per_page<\/code>. Joten lis\u00e4\u00e4mme array-elementin:<\/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>. Onneksi WordPressiss\u00e4 on toiminto luokkatunnusten hankkimiseksi viestille; wp_get_post_categories()<\/code>jota voimme k\u00e4ytt\u00e4\u00e4 suoraan parametrin arvona. T\u00e4ydellinen!<\/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