WordPressi teemaõpetus algajatele – 4. osa: postitustsükkel
Selles algajatele mõeldud WordPressi teemaõpetuse õppetükis käsitleme üksikasjalikult WordPressi "postitussilmust"; mis see on, kuidas see välja näeb, miks me seda kasutame ja kuidas postitustele juurde pääseda. Seejärel hakkame juurutama silmus meie teemas.
Postisilmus
Kui olete PHP-ga tuttav, võite aru saada, et "silmus" on tehnika massiivi või objekti iga elemendi läbimiseks for, foreachvõi while. WordPressi silmus töötab täpselt nii. Kuid täiendavate eeliste ja lihtsustuste saamiseks kasutame silmuse loomiseks WordPressi enda funktsioone.
WordPress on alati teie eest postitusi pärinud – olenevalt sellest, millisel lehel te viibite. Kui olete kategoorialehel, on WordPress juba uurinud kõiki selle kategooriaga seotud postitusi ja kui olete ühel postituse lehel, on WordPress selle ühe postituse teie jaoks juba toonud.
Kui tahame pääseda juurde postitustele, mida WordPress on meie mallides küsinud, lisame tsükli. Silmuse sees on meil juurdepääs igale postitusele. Ja iga postituse puhul otsustame, mida näidata või teha.
Märkus. Isegi ühe postituse või ühe lehe mallidesse lisate tsükli, kuigi teame, et see sisaldab ainult ühte postitust! Silmus jookseb lihtsalt ühe korra.
Siin on WordPressi silmus kogu oma hiilguses:
while (have_posts()): the_post();
// Access to each post here
endwhile;See koodilõik teeb kahte asja. See whileosa (kaasa arvatud endwhile) on silmusosa, mis tsüklib olenemata sellest, kui kaua postitusi on järel. Teine osa the_post()loob lihtsustatud ja intuitiivse juurdepääsu tsükli sees olevale postitusobjektile. Sellest saame hiljem rohkem teada.
Hea tava on mähkida silmus iftšeki sisse, mis kontrollib, kas seal on tõesti postitusi, millest silmust läbida. Siis saame soovi korral ka sõnumit kuvada, kui seda poleks olnud. Postituspäring võib olla tühi, kui lähete tühja kategooriaarhiivi või proovite otsida midagi, millel pole tabamust. See on silmuse parem versioon:
Tutvuge selle koodiosaga, kuna kordate seda alati, kui soovite postitustele juurde pääseda! Rakendame tsüklit oma teemas.
Silmuse rakendamine meie teemas
Lisame tsükli meie index.php, asendades näiva teksti.
Lisasin funktsiooni nimega the_title()silmuse sees, mis kajastab postituse pealkirja. See on lihtsalt selleks, et me näeme tsüklit praktikas. Ärge muretsege, järgmises etapis saame teada, kuidas pääseda juurde kogu tegelikule postitusteabele.
Vaatame, mis WordPressis nüüd juhtub. Värskenda esilehte. Sõltuvalt teie seadetest ja sisust peaksite nägema mõningaid pealkirju. Minu WordPressis on vaikepostitus "Tere maailm!" ja veel üks minu loodud postitus pealkirjaga "See on teine postitus". See on see, mida saan esilehel:
Kui proovite külastada ühte postituse lehte, peaksite nägema ainult ühte pealkirja, mis on vaadatava postituse pealkiri. Tore!
Uudishimulike jaoks…
Kui teid huvitab, mida silmus läbib ja milliseid parameetreid WordPress selle päringu jaoks kasutas, saate seda kontrollida. Globaalset muutujat, millele tsükkel viitab, nimetatakse $wp_query. Sellele juurdepääsuks peate selle globaalselt määratlema. Proovige var_dump()selle täieliku sisu välja printimiseks kasutada. Silmus käib läbi $wp_query->postskinnistu.
global $wp_query;
var_dump($wp_query);Lisame oma tsüklisse ühe olulise detaili index.php; viis, kuidas kasutaja saab liikuda järgmisele ja eelmisele postituste lehele.
Pidage meeles, et tsükkel hangib teie WordPressi seadetes > Lugemine määratud arvu postitusi alati, kui olete mitut postitust kuvaval lehel. Kui tsüklis on saadaval rohkem postitusi kui siin määratletud arv, vajame võimalust lehtede vahel navigeerimiseks. Selleks saame kasutada funktsiooni the_posts_pagination().
See funktsioon aktsepteerib mõningaid parameetreid oma väljundi kohandamiseks. Saate määrata ellipside vahele jäävate lehtede arvu (kui lehti on palju). Samuti saate määrata, millised peaksid olema lehe „Eelmine" ja „Järgmine” linkide tekstid. Lisan selle ilma parameetriteta, et teha vaikeseadeid, kuid soovi korral saate seda kohandada.
...
while (have_posts()): the_post();
the_title();
endwhile;
the_posts_pagination();
} else {
...See funktsioon ei väljasta absoluutselt midagi, kui postitusi on lehekülje seadistuste arvuga vähem või võrdne. Nii et ärge muretsege, kui arvate, et eksite, sest te ei näe väljundit. Kui ühel lehel on postitusi rohkem kui postitusi, väljastab see funktsioon divi, ekraanilugejate päise (mida tavaliselt CSS-iga peidate) ja hulga lehekülgede linke.
Nüüd, kui me teame, kuidas saada juurdepääs mis tahes postitusele, mille WordPress on meie jaoks leidnud, on järgmine samm õppida, kuidas näidata, mida me igast postitusest tahame. silmuse sees.