Joissakin tapauksissa saatat joutua muokkaamaan yleist\u00e4 viestikysely\u00e4, jota WordPress suorittaa mill\u00e4 tahansa vierailemallasi sivulla \u2013 sek\u00e4 j\u00e4rjestelm\u00e4nvalvojana ett\u00e4 k\u00e4ytt\u00f6liittym\u00e4ss\u00e4. T\u00e4ss\u00e4 oppaassa tarkastelemme, mit\u00e4 koukkua kannattaa k\u00e4ytt\u00e4\u00e4 ja kuinka muuttaa kyselyn argumentteja mieleiseksesi.<\/p>\n
Ensin sinun on tiedett\u00e4v\u00e4, mihin koukkuun haluat lis\u00e4t\u00e4 koodisi. Tarvitsemme koukun, joka tapahtuu heti sen j\u00e4lkeen, kun WordPress on asettanut kaikki argumentit, mutta ennen kuin varsinainen kysely suoritetaan. T\u00e4t\u00e4 varten k\u00e4yt\u00e4mme toimintoa T\u00e4ss\u00e4 koukussa saat yhden parametrin; joka on Kyselyn muokkaaminen vaatii todenn\u00e4k\u00f6isesti joitain ehdollisia tunnisteita m\u00e4\u00e4ritt\u00e4m\u00e4\u00e4n tapaukset, joita haluat muuttaa. Voit esimerkiksi kohdistaa kyselyyn vain hakutuloksissa tai luokkan\u00e4kymiss\u00e4.<\/p>\n WordPressiss\u00e4 on joukko ehdollisia tageja<\/a>, joiden avulla voit m\u00e4\u00e4ritt\u00e4\u00e4, miss\u00e4 tapauksissa haluat lis\u00e4t\u00e4 koodisi. Ehdollinen tagi on yksinkertaisesti funktio, joka palauttaa tosi tai ep\u00e4tosi sen mukaan, miss\u00e4 tilassa WordPress on. Esimerkkej\u00e4 yleisist\u00e4 ehdollisista tunnisteista on Muista, ett\u00e4 koukkua Ehdolliset tunnisteet ovat loistavia ja kaikki, mutta joitain asioita on pidett\u00e4v\u00e4 mieless\u00e4, kun k\u00e4yt\u00e4t n\u00e4it\u00e4 sis\u00e4ll\u00e4 Ensin sinun on tutustuttava tagiin Toiseksi, sinun on oltava tietoinen tapauksista, joissa sinun on tarkistettava ehdolliset tunnisteet tarjotulle objektille sen sijaan, ett\u00e4 kutsuisit funktiota "itsen\u00e4isesti". Yleens\u00e4 kun k\u00e4yt\u00e4t ehdollisia tunnisteita, kirjoitat sen seuraavasti:<\/p>\n Kuitenkin k\u00e4ytett\u00e4ess\u00e4 Tarkista aina T\u00e4m\u00e4 on esimerkki tarkistamisesta, jos emme ole j\u00e4rjestelm\u00e4nvalvojassa ja olemmeko p\u00e4\u00e4viestikyselyss\u00e4:<\/p>\n Koska ty\u00f6skentelemme K\u00e4yt\u00e4t Tapauksissa, joissa haluat liitt\u00e4\u00e4 tai muuttaa olemassa olevan argumentin, teet t\u00e4m\u00e4n yleens\u00e4 tallentamalla ensin olemassa olevan argumentin muuttujaan. Voit k\u00e4ytt\u00e4\u00e4 menetelm\u00e4\u00e4 T\u00e4ss\u00e4 on nopea esimerkki k\u00e4yt\u00f6st\u00e4 WordPressiss\u00e4 on erilliset alaluokat taksonomian ( Lis\u00e4\u00e4m\u00e4si tai muuttamasi argumentit riippuvat t\u00e4ysin siit\u00e4, mit\u00e4 haluat tehd\u00e4, mutta sinulla pit\u00e4isi nyt olla jonkinlainen k\u00e4sitys strategioista, joiden avulla p\u00e4\u00e4set k\u00e4siksi maailmanlaajuiseen kyselyyn. Jos haluat saada jonkinlaista k\u00e4sityst\u00e4 pre_get_posts<\/code>.<\/p>\nWP_Query<\/code>objekti, jonka kanssa WordPress suorittaa kyselyn my\u00f6hemmin. Teet muutoksia objektiin \u2013 mutta sinun ei tarvitse palauttaa sit\u00e4, koska WordPress suorittaa kyselyn muokatun objektin kanssa.<\/p>\nadd_action('pre_get_posts', function($query) {\n \/\/ Add your code here\n});<\/code><\/pre>\nEhdolliset tunnisteet<\/h2>\n
is_admin()<\/code>tarkoitus tarkistaa, olemmeko t\u00e4ll\u00e4 hetkell\u00e4 j\u00e4rjestelm\u00e4nvalvojassa vai k\u00e4ytt\u00f6liittym\u00e4ss\u00e4, is_singular()<\/code>olemmeko yhdell\u00e4 viestill\u00e4 tai sivulla k\u00e4ytt\u00f6liittym\u00e4ss\u00e4 ja is_search()<\/code>jos olemme hakutulossivulla.<\/p>\npre_get_posts<\/code>k\u00e4ytet\u00e4\u00e4n sek\u00e4 j\u00e4rjestelm\u00e4nvalvojalle ett\u00e4 k\u00e4ytt\u00f6liittym\u00e4lle. Jos haluat vaikuttaa vain yleiseen kyselyyn k\u00e4ytt\u00f6liittym\u00e4ss\u00e4, sinun on k\u00e4\u00e4ritt\u00e4v\u00e4 koodisi ehdollisen tagin if-tarkistuksen sis\u00e4\u00e4n is_admin()<\/code>.<\/p>\nHuomautus ehdollisista tunnisteista
pre_get_posts<\/code><\/h3>\npre_get_posts<\/code>.<\/p>\nis_main_query()<\/code>. Toiminto pre_get_posts<\/code>suoritetaan itse asiassa useita kertoja jokaisella sivulatauksella. Esimerkiksi pre_get_posts<\/code>suoritetaan luotaessa kutakin valikkoa (mukaan lukien widgetien valikot). Jotta voit muokata varsinaista globaalia kysely\u00e4, esim. luokka-arkiston viestej\u00e4 tai hakutuloksia, sinun on kohdistettava "p\u00e4\u00e4kyselyyn" k\u00e4ytt\u00e4m\u00e4ll\u00e4 is_main_query()<\/code>.<\/p>\nif (is_main_query()) {\n \/\/ Do stuff\n}<\/code><\/pre>\npre_get_posts<\/code>, objektiin on lis\u00e4tt\u00e4v\u00e4 joitain ehdollisia tunnisteita. Esimerkiksi:<\/p>\nadd_action('pre_get_posts', function($query) {\n if ($query->is_main_query()) {\n \/\/ Add your code here\n }\n});<\/code><\/pre>\nis_main_query()<\/code>kohdassa annettu esine pre_get_posts<\/code>. Lue lis\u00e4\u00e4 pre_get_posts-dokumentaatiosta<\/a>.<\/p>\nadd_action('pre_get_posts', function($query) {\n if (!is_admin() && $query->is_main_query()) {\n \/\/ Add your code here\n }\n});<\/code><\/pre>\nArgumenttien muuttaminen tai lis\u00e4\u00e4minen<\/h2>\n
WP_Query<\/code>objektin kanssa, voit katsoa WP_Queryn dokumentaatiosta<\/a>, kuinka voit rakentaa argumentteja viestikyselyn mukauttamiseksi. Muista, ett\u00e4 argumentit on jo t\u00e4ytetty. Siin\u00e4 tapauksessa sinun on liitett\u00e4v\u00e4 tai muutettava olemassa olevia arvoja. Tai poista ne, jotka haluat poistaa.<\/p>\nset()<\/code>funktiota WP_Query<\/code>objektiin argumenttien asettamiseen. Menetelm\u00e4 hyv\u00e4ksyy kaksi argumenttia, argumenttiavaimen ja toiseksi arvon. Esimerkiksi posts_per_page<\/code>argumentin asettaminen tapahtuisi n\u00e4in:<\/p>\nadd_action('pre_get_posts', function($query) {\n if (!is_admin() && $query->is_main_query()) {\n $query->set('posts_per_page', 20);\n }\n});<\/code><\/pre>\nget()<\/code>t\u00e4h\u00e4n. Sitten muokkaat muuttujaa lis\u00e4\u00e4m\u00e4ll\u00e4 tai yhdist\u00e4m\u00e4ll\u00e4 taulukoita tai mit\u00e4 tahansa. Ja lopuksi k\u00e4yt\u00e4t set()<\/code>korvaamaan muokatun muuttujan takaisin kyselyobjektiin. Suosittelen k\u00e4ytt\u00e4m\u00e4\u00e4n var_dump()<\/code>objektia n\u00e4hd\u00e4ksesi, mit\u00e4 se sis\u00e4lt\u00e4\u00e4, ja t\u00e4m\u00e4 on my\u00f6s mukava tapa tarkistaa, ovatko ehdolliset tagit oikein.<\/p>\nget()<\/code>(tarkistaa vain, onko se tyhj\u00e4), ja jos on, lis\u00e4\u00e4 omat argumenttisi set()<\/code>.<\/p>\nadd_action('pre_get_posts', function($query) {\n if (!is_admin() && $query->is_main_query()) {\n if (!$query->get('meta_query')) {\n $query->set('meta_query', [\/ your arguments here \/]);\n }\n }\n});<\/code><\/pre>\nHuomautus verokyselyst\u00e4<\/h3>\n
WP_Tax_Query<\/code>) -osan k\u00e4sittelemiseksi sis\u00e4ll\u00e4 WP_Query<\/code>. Jos sinun on teht\u00e4v\u00e4 monimutkaisempia taksonomiakyselyn muutoksia, pre_get_posts<\/code>toiminto saattaa olla liian aikaista. Jotkut arvot voivat olla tyhji\u00e4, koska ne t\u00e4ytet\u00e4\u00e4n my\u00f6hemmin. T\u00e4ss\u00e4 tapauksessa saatat olla parempi k\u00e4ytt\u00e4\u00e4 parse_tax_query<\/code>toimintoa pre_get_posts<\/code>. Lue t\u00e4m\u00e4n koukun dokumentaatio<\/a> n\u00e4hd\u00e4ksesi, sopiiko t\u00e4m\u00e4 sinulle.<\/p>\nJohtop\u00e4\u00e4t\u00f6s<\/h2>\n
WP_Query<\/code>objektista ja sen argumenttien k\u00e4yt\u00f6st\u00e4, postaukseni viestien kyselyst\u00e4<\/a> saattaa olla kiinnostava.<\/p>\n