{"id":233917,"date":"2023-02-24T11:20:00","date_gmt":"2023-02-24T08:20:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=233917"},"modified":"2022-11-11T13:11:31","modified_gmt":"2022-11-11T10:11:31","slug":"opas-viestien-kyselyn-tekeminen-wordpressissae","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/fi\/opas-viestien-kyselyn-tekeminen-wordpressissae\/","title":{"rendered":"Opas: Viestien kyselyn tekeminen WordPressiss\u00e4"},"content":{"rendered":"\n

Mit\u00e4 menetelmi\u00e4 on k\u00e4ytett\u00e4viss\u00e4 mukautetun viestikyselyn tekemiseen, ja milloin niit\u00e4 on parasta k\u00e4ytt\u00e4\u00e4? T\u00e4m\u00e4n postauksen tavoitteena on saada vankka k\u00e4sitys kahdesta menetelm\u00e4st\u00e4 kyselyiden tekemiseen viesteihin, miten p\u00e4\u00e4st\u00e4 k\u00e4siksi tuloksiin, kuinka rakentaa argumentteja ja lopuksi kuinka siivota sen j\u00e4lkeen. Tarkastelemme kaksi menetelm\u00e4\u00e4 get_posts()<\/code>ja WP_Query<\/code>.<\/p>\n

Kun kyse on uuden viestikyselyn tekemisest\u00e4, on todella kaksi vaihtoehtoa (kirjoituksen aikaan). Valinta riippuu todella vain mieltymyksist\u00e4si (ja pienest\u00e4 tehokkuudesta). Yksi vaihtoehto voi sotkea maailmanlaajuisen silmukan\/kyselyn, jossa olet t\u00e4ll\u00e4 hetkell\u00e4, ellet k\u00e4sittele sit\u00e4 oikein. Yhdell\u00e4 vaihtoehdolla k\u00e4sittelet objekteja ja toisessa taulukossa. Viestikyselyn mukauttamisen argumentit ovat kuitenkin samat.<\/p>\n

Globaali kysely?<\/h2>\n

Jos olet ep\u00e4varma, mit\u00e4 tarkoitan "maailmanlaajuisen kyselyn sotkemisella", se on t\u00e4m\u00e4. WordPress tekee aina yhden globaalin kyselyn riippuen siit\u00e4, mill\u00e4 sivulla olet. Jos vierailija vierailee kategoria-arkistossa, WordPress on tehnyt t\u00e4lle postauskyselyn Teema p\u00e4\u00e4see normaalisti kyselyn viesteihin k\u00e4ytt\u00e4m\u00e4ll\u00e4 "silmukkaa". Kun teemme uuden kyselyn omalla silmukalla t\u00e4m\u00e4n silmukan sis\u00e4ll\u00e4, meid\u00e4n on varmistettava, ett\u00e4 WordPressin globaali kysely ja kyselymme k\u00e4sitell\u00e4\u00e4n erikseen.<\/p>\n

Jos kuitenkin haluat muokata WordPressin viestikysely\u00e4, se on toinen tarina. Minulla on toinen postaus<\/a>, jossa k\u00e4sitell\u00e4\u00e4n perusteellisesti, miten se tehd\u00e4\u00e4n.<\/p>\n

Katsotaanpa kahta meill\u00e4 olevaa vaihtoehtoa ja miten k\u00e4sittelemme niit\u00e4. Sen j\u00e4lkeen tarkastelemme argumentteja kyselyn mukauttamiseen. Muista, ett\u00e4 argumentit ovat samat molemmille.<\/p>\n

Kaksi tapaa tehd\u00e4 kyselyit\u00e4 viesteist\u00e4<\/strong><\/h2>\n

Voit kysy\u00e4 viestej\u00e4 joko funktiolla get_posts()<\/code>tai tekem\u00e4ll\u00e4 uusi esiintym\u00e4 WP_Query.<\/code>. Ensimm\u00e4inen vaihtoehto palauttaa joukon viestej\u00e4 ja toisessa k\u00e4sittelet objektia. Koska get_posts()<\/code>se palauttaa joukon vain viestej\u00e4, sit\u00e4 on yleens\u00e4 helpompi k\u00e4ytt\u00e4\u00e4 miss\u00e4 tahansa. Jos kuitenkin haluat sivuuttaa kyselysi, sinun kannattaa ehdottomasti luoda WP_Query<\/code>ilmentym\u00e4.<\/p>\n

Funktio get_posts<\/code>on k\u00e4\u00e4refunktio, WP_Query<\/code>mik\u00e4 tarkoittaa, ett\u00e4 se hyv\u00e4ksyy samat argumentit, mutta get_posts<\/code>sill\u00e4 on muutama ylim\u00e4\u00e4r\u00e4inen "alias"-argumentti. WordPressin get_posts<\/a> -dokumentaatiosivu ei luettele mahdollisia argumentteja (paitsi alias-argumentteja), mutta viittaa argumenttien WP_Query<\/a> -dokumentaatiosivulle. Tarkastelemme argumentteja tarkemmin my\u00f6hemmin.<\/p>\n

Jos suorituskyky on ongelma (eli sivustolla on paljon viestej\u00e4), get_posts<\/code>se on nopeampi kuin k\u00e4ytt\u00f6, WP_Query<\/code>koska se ohittaa sivutuslaskelman.<\/p>\n

Mukautetun viestikyselyn silmukoiden selaaminen vaihtelee valitsemasi menetelm\u00e4n mukaan. Sinun pit\u00e4isi tuntea yleinen WordPress-silmukka, jota k\u00e4ytet\u00e4\u00e4n melkein kaikissa teemamalleissa:<\/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
Silmukoita k\u00e4ytt\u00e4m\u00e4ll\u00e4 WP_Querya<\/strong><\/h3>\n
K\u00e4yt\u00f6n tulosten silmukka WP_Query<\/code>on t\u00e4sm\u00e4lleen sama, paitsi ett\u00e4 viittaamme erityisesti silmukan ilmentym\u00e4objektiin. Meid\u00e4n on my\u00f6s muistettava "resetoida tila" silmukan j\u00e4lkeen, jotta globaali post-objekti palautetaan siihen, mik\u00e4 se oli ennen. T\u00e4t\u00e4 varten k\u00e4yt\u00e4mme 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
Jos tyhjenn\u00e4t objektin, jonka instantoi WP_Query<\/code>( $custom_query<\/code>yll\u00e4 olevassa esimerkiss\u00e4), l\u00f6yd\u00e4t koko kyselyn ja k\u00e4ytetyt argumentit. Mielenkiintoisia osia t\u00e4ss\u00e4 ovat ominaisuudet " found_posts<\/code>" ja " posts<\/code>". Ominaisuus posts<\/code>sis\u00e4lt\u00e4\u00e4 tuloksen post-objekteista, joiden l\u00e4pi silmukka kulkee. Hakuasi vastaavien viestien m\u00e4\u00e4r\u00e4 palautetaan muodossa " found_posts<\/code>", ja se on hy\u00f6dyllinen, jos haluat tehd\u00e4 mukautetun sivutuksen. Jaa t\u00e4m\u00e4 arvo WordPressin asetuksilla sivukohtaisten viestien m\u00e4\u00e4r\u00e4lle selvitt\u00e4\u00e4ksesi, kuinka monta sivua tarvitset kyselyyn, tai viittaa yksinkertaisesti ominaisuuteen " max_num_pages<\/code>".<\/p>\n
Huomautus: Kun k\u00e4yt\u00e4t get_posts<\/code>WordPressi\u00e4, se palauttaa vain posts<\/code>ominaisuuden (joka on taulukko) WP_Query<\/code>objektista.<\/p>\n
Silmukoita k\u00e4ytt\u00e4m\u00e4ll\u00e4 get_posts<\/strong><\/h3>\n
K\u00e4ytt\u00e4m\u00e4ll\u00e4 get_posts<\/code>emme k\u00e4yt\u00e4 tavallista "WordPress-silmukkaa", vaan k\u00e4yt\u00e4mme normaalia PHP-taulukkosilmukkaa. Jokainen taulukon elementti on post-objekteja, eik\u00e4 nollausta tarvita silmukan suorittamisen j\u00e4lkeen. Muista, ett\u00e4 mallitunnisteet (kuten the_title()<\/code>, the_permalink()<\/code>jne.) eiv\u00e4t ole k\u00e4ytett\u00e4viss\u00e4 t\u00e4ss\u00e4 silmukassa. Sinun on viitattava post-objektin ominaisuuksiin (esim $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
Suosittelen, ett\u00e4 nime\u00e4t viestiobjekteillesi jotain muuta kuin $post<\/code>. Saatat kohdata ongelmia yritt\u00e4ess\u00e4si k\u00e4ytt\u00e4\u00e4 viestin ominaisuuksia (se saattaa viitata yleiseen post-objektiin eik\u00e4 silmukan viestiin).<\/p>\n
Jos haluat k\u00e4ytt\u00e4\u00e4 mallitunnisteita<\/a> helpottaaksesi viestitietojen (kuten the_title()<\/code>ja the_permalink()<\/code>) k\u00e4ytt\u00f6\u00e4, voit tehd\u00e4 niin. Tee t\u00e4m\u00e4 k\u00e4skem\u00e4ll\u00e4 WordPressi\u00e4 m\u00e4\u00e4ritt\u00e4m\u00e4\u00e4n globaali viestiobjekti silmukan sis\u00e4ll\u00e4 setup_postdata()<\/code>. Jos teet t\u00e4m\u00e4n, sinun on palautettava tila wp_reset_postdata()<\/code>silmukan j\u00e4lkeen.<\/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
Muista, ett\u00e4 setup_postdata<\/code>objektit, joiden l\u00e4pi k\u00e4yt l\u00e4pi (as<\/code>foreach-silmukan " "-osa), on nimett\u00e4v\u00e4 $post<\/code>! Ensimm\u00e4isess\u00e4 esimerkiss\u00e4 nimesin viestiobjektit $custom_post<\/code>ja t\u00e4m\u00e4 ei toiminut setup_postdata()<\/code>.<\/p>\n
Jos kuitenkin tarvitset vain p\u00e4\u00e4syn perustietoihin, voit yht\u00e4 hyvin ohittaa globaalin post-objektin asettamisen ja k\u00e4ytt\u00e4\u00e4 mieluummin vastaavia " get_<\/code>"-mallitunnisteita ja viestitunnusta. Esimerkiksi tagi the_permalink()<\/code>toimii oikein vain, jos yleinen post-objekti on asetettu, mutta voit pyyt\u00e4\u00e4 postin pysyv\u00e4\u00e4 linkki\u00e4 ilman yleist\u00e4 post-objektia yksinkertaisesti k\u00e4ytt\u00e4m\u00e4ll\u00e4 echo get_the_permalink($custom_post->ID)<\/code>.<\/p>\n
Kysele argumentteja<\/strong><\/h2>\n
L\u00f6yd\u00e4t t\u00e4ydellisen luettelon kaikista mahdollisista argumenteista WP_Queryn dokumentaatiosivulta<\/a>. Esimerkkej\u00e4 parametreista ovat postaukset, joissa on tietyt termit taksonomiasta, post-meta-arvot, viestityypit, tiettyjen viestien sis\u00e4llytt\u00e4minen tai poissulkeminen sek\u00e4 useita vaihtoehtoja tulosten j\u00e4rjest\u00e4miseen. Niit\u00e4 on liian monta k\u00e4yd\u00e4kseen l\u00e4pi jokaisen yksityiskohtaisesti, mutta t\u00e4ss\u00e4 on joitain yleisi\u00e4 esimerkkej\u00e4 argumenteista kyselyjen tekemiseen.<\/p>\n
Esimerkki 1: Saman kategorian aiheeseen liittyv\u00e4t viestit<\/h3>\n
Oletetaan, ett\u00e4 haluat n\u00e4ytt\u00e4\u00e4 "aiheeseen liittyv\u00e4t viestit" yksitt\u00e4isen viestin lopussa. Sen pit\u00e4isi n\u00e4ytt\u00e4\u00e4 satunnaisesti valittu 3 viesti\u00e4, jotka ovat samassa kategoriassa kuin nykyinen viesti, ja sen pit\u00e4isi sulkea nykyinen viesti pois tuloksesta.<\/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
Argumentit ovat melko itsest\u00e4\u00e4nselvi\u00e4. Pyyd\u00e4n vain " post<\/code>" in " post_type<\/code>" ja enint\u00e4\u00e4n 3 viesti\u00e4 " posts_per_page'<\/code>.<\/p>\n
Luokkien viestien kysely\u00e4 varten voit rakentaa tax_query<\/a> -kyselyn tai k\u00e4ytt\u00e4\u00e4 yksinkertaisempaa " category__in<\/code>" (Huom. Toimii vain viestikategoriassa). Yll\u00e4 olevassa esimerkiss\u00e4 k\u00e4yt\u00e4n wp_get_post_categories()<\/code>joukon termitunnuksia, jotka on m\u00e4\u00e4ritetty annetulle viestille, ja k\u00e4yt\u00e4n t\u00e4t\u00e4 argumentissa " category__in<\/code>".<\/p>\n
Voit sulkea pois viestitunnukset merkinn\u00e4ll\u00e4 " post__not_in<\/code>", kun taas min\u00e4 annoin nykyisen viestitunnuksen. Lopuksi pyysin satunnaista viestien j\u00e4rjestyst\u00e4 asettamalla " rand<\/code>" kohtaan orderby<\/code>". Voit tilata ne eri tavalla antamalla esim. " title<\/code>" tai " ". date<\/code>Tutustu tilausasiakirjoihin<\/a> n\u00e4hd\u00e4ksesi, mik\u00e4 on mahdollista.<\/p>\n
Esimerkki 2: Kaikki mukautetun viestityypin viestit, joissa on useita j\u00e4rjestysargumentteja<\/h3>\n
T\u00e4ss\u00e4 esimerkiss\u00e4 oletetaan, ett\u00e4 sinulla on mukautettu viestityyppi " book<\/code>" ja mukautetussa sivumallissa haluat n\u00e4ytt\u00e4\u00e4 kaikki julkaistut kirjat. Haluat j\u00e4rjest\u00e4\u00e4 postaukset ensisijaisesti menu_order (sivu-attribuutti, se on numero, jonka voit asettaa postausta kohti) ja toiseksi julkaisun otsikon mukaan.<\/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
Argumentit ovat j\u00e4lleen melko itsest\u00e4\u00e4nselvi\u00e4. Pyyd\u00e4n viestityyppi\u00e4 ’ book<\/code>’ nimell\u00e4 ’ post_type<\/code>’. Kun asetat posts_per_page<\/code>arvoksi -1, se hakee kaikki (julkaistut viestit, ellet m\u00e4\u00e4rit\u00e4 jotain muuta post_status<\/code>argumentissa " "). Lopuksi tarjoan taulukon orderby<\/code>WordPressille, jotta se lajittelee viestit ensisijaisesti valikon j\u00e4rjestyksen mukaan nousevaan j\u00e4rjestykseen ja toiseksi postauksen otsikon laskevaan j\u00e4rjestykseen.<\/p>\n
Esimerkki 3: Viestit, joissa on mukautettuja metatietoja<\/h3>\n
Oletetaan, ett\u00e4 sinulla on mukautettu postaustyyppi book<\/code>ja haluat tehd\u00e4 kyselyn kaikista kirjoista, jotka ovat joko julkaisemattomia tai kirjoja, jotka on julkaistu vuosina 1990\u20132019.<\/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
Kyselyn rakentaminen post-metalla on parasta tehd\u00e4 meta_query<\/code>(hyvin yksinkertaisille meta-argumenteille voit k\u00e4ytt\u00e4\u00e4 meta_key<\/code>ja meta_value<\/code>suoraan). Argumentti meta_query<\/code>vaatii taulukon, jossa jokainen argumentti on taulukko. Voit hallita kunkin argumentin v\u00e4list\u00e4 suhdetta ’ relation<\/code>’:ll\u00e4, jonka asetin OR<\/code>yll\u00e4 olevassa esimerkiss\u00e4 arvoon ’ ’.<\/p>\n
Annan kaksi metatietoargumenttia kohteelle " meta_query<\/code>". Ensimm\u00e4inen vertaa metaavainta ’ book_status<\/code>’ tekstiin ’ unpublished<\/code>’, ja jos se on yht\u00e4 suuri, se sis\u00e4llytet\u00e4\u00e4n. Toisessa argumentissa kerron WordPressille, ett\u00e4 se saa mink\u00e4 tahansa arvon metaavaimeen ’ year_published<\/code>’, joka on numeroiden 1990 ja 2019 v\u00e4lill\u00e4.<\/p>\n
Johtop\u00e4\u00e4t\u00f6s<\/h2>\n
Sinulla pit\u00e4isi nyt olla perustiedot kahdesta viestien kyselymenetelm\u00e4st\u00e4. Sill\u00e4 ei ole suurta eroa, koska voit rakentaa saman kyselyn molemmilla, mutta tapa k\u00e4sitell\u00e4 n\u00e4it\u00e4 kahta on erilainen. Kolme annettua esimerkki\u00e4 kyselyargumenteista koskettavat vain niiden kyselyjen pintaa, joita voit rakentaa. Katso WP_Query-dokumentaatiosta<\/a> t\u00e4ydellinen yleiskatsaus ja runsaasti esimerkkej\u00e4.<\/p>\n
Jos olet utelias kuinka muokata WordPressin suorittamaa globaalia kysely\u00e4, minulla on erillinen viesti<\/a>, jossa k\u00e4sitell\u00e4\u00e4n sit\u00e4.<\/p>\n
:  awhitepixel.com<\/a><\/div><\/p>\n","protected":false},"excerpt":{"rendered":"
T\u00e4ss\u00e4 oppaassa tarkastellaan kahta tapaa tehd\u00e4 kyselyit\u00e4 viesteist\u00e4 WordPressiss\u00e4 (get_posts ja WP_Query), kuinka p\u00e4\u00e4st\u00e4 jokaiseen viestiin ja rakentaa argumentteja.<\/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":[927,895,719,719,895,917,917,1110,843,803,803,927,843,864,864],"tags":[1166],"class_list":["post-233917","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-aiheita","category-koodi","category-kehittaejae","category-muut","category-n-a","category-opetusohjelmia","category-php-5","category-wordpress-5","tag-affiai-fi"],"_links":{"self":[{"href":"https:\/\/wordpress.mediadoma.com\/fi\/wp-json\/wp\/v2\/posts\/233917","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.mediadoma.com\/fi\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wordpress.mediadoma.com\/fi\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fi\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fi\/wp-json\/wp\/v2\/comments?post=233917"}],"version-history":[{"count":0,"href":"https:\/\/wordpress.mediadoma.com\/fi\/wp-json\/wp\/v2\/posts\/233917\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fi\/wp-json\/wp\/v2\/media\/224094"}],"wp:attachment":[{"href":"https:\/\/wordpress.mediadoma.com\/fi\/wp-json\/wp\/v2\/media?parent=233917"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fi\/wp-json\/wp\/v2\/categories?post=233917"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fi\/wp-json\/wp\/v2\/tags?post=233917"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}