See on õpetus, kuidas luua WordPressis koodi järgi kohandatud postituse tüüp ja kohandatud taksonoomia. Vaatleme levinumaid lõkse ja milliseid argumente kasutada minimaalse, kuid piisava loomiseks. Lõpus on täielik näide.
Kuhu kood lisada
Kohandatud postitustüüpe (CPT) ja kohandatud taksonoomiaid saab WordPressis luua teema functions.phpfailis või pistikprogrammis. Pidage meeles, et kohandatud postituse tüüp ja kohandatud taksonoomia kaovad, kui vahetate teemat või desaktiveerite pistikprogrammi. Seega on CPT registreeringu ajutiselt teemast eemaldamine ja pistikprogrammi teisaldamine ohutu – seni, kuni säilitate sama kohandatud postituse tüübi või taksonoomia identifikaatori slug/ID.
CPT või taksonoomia loomiseks (ja muutmiseks) kasutage alati konksu init. Selle asetamine (väljapoole konksu) või mõne muu konksu juure functions.phppõhjustab probleeme.
Kohandatud postituse tüübi loomine
Kohandatud postitustüübi loomiseks kasutate register_post_typefunktsiooni. See aktsepteerib kahte parameetrit; esiteks postituse tüübi identifikaator ja teiseks massiiv kõigi argumentidega.
Postituse tüübi identifikaator on teie postituse tüübi slug-versiooni nimi. Näiteks WordPressi sisseehitatud postitustüüpide postitused ja lehed on tähistatud kui " post" ja " page". Identifikaator peab olema kordumatu, järgima reegleid (väikesed tähed, tühikud jne) ega tohi olla WordPressi reserveeritud näpunäide.
See on see, mida ma olen õppinud olema minimaalsed, kuid täiesti head argumendid postituse tüübi registreerimiseks; Arvestades, et see on tavaline avalik CPT ja soovite alistada kõik sildid, mis ütlevad "postitus" või "leht", oma CPT tegeliku nimega:
Ülevaade argumentidest
Pidage meeles, et mõned argumendid pärivad väärtusi teistelt argumentidelt. Kui need pole selgesõnaliselt määratud, võivad need vaikimisi olla samad või vastupidised. Mitmed argumendid pärivad argumendi sama või vastupidise väärtuse public. Lugege dokumentatsiooni, et näha, mis on iga argumendi vaikeväärtus ja kas peate selle alistama.
Kui teile sobib, kui administraatoris on tekstid, mis viitavad teie postituse tüübile "postitus" või "leht", võite sildiargumentide määratlemise vahele jätta. Tõenäoliselt sobib teile ainult label(mitmuse nimi) ja labelsmassiivi sees lihtsalt singular_name(ainsuse nimi).
Kui te ei määra olekuks show_in_restTõene, kasutab teie kohandatud pos.-tüüp vana klassikalist redaktorit. Kui soovite oma kohandatud postituse tüübi jaoks kasutada Gutenbergi redaktorit, peate määrama show_in_restväärtuseks Tõene.
Argument supportsütleb, millised elemendid on teie postituse tüüpi postituse muutmisel saadaval. Tõenäoliselt soovite vähemalt pealkirja, redaktorit ja esiletoodud postituse pilti.
Minimaalse rewritemassiivielemendiga argument slugkäsib WordPressil kõik teie postituse tüübi ainsuse postitused ümber kirjutada, et kasutada seda eesliidet. Ülaltoodud näites saaks ainsuse raamatupostitus URL-i nagu; http://example.com/book/i-robot/. _ Kui olete huvitatud sellest, kuidas lisada administraatorisse püsiva lingi reegli säte, et teemakasutajad saaksid ise otsustada, vaadake seda postitust.
Menüüikooni (menu_icon) argument võib olla mis tahes järgmistest Dashiconidest või vaikeväärtuse säilitamiseks võite selle tühjaks jätta. Vaikimisi on sama ikoon nagu Postitused. Siiski on hea mõte oma kohandatud postituste tüübid selgelt eraldada.
Menüüpositsioon (menu_position) võimaldab teil määrata oma kohandatud postituse tüübi asukoha administraatorimenüüs. Dokumentatsioonis on loetletud kõik administraatori menüü positsioonid, nii et saate neid kohandada; positsioon 5 on kohe pärast "Postitused".
taxonomiesPostitüübile taksonoomia lisamiseks on veel üks argument (). Selles postituses käsitleme kohandatud taksonoomia lisamist. Oma postituse tüübile taksonoomiate lisamiseks lisage see argument ülaltoodud massiivi;
Märkus püsilinkide ja 404 ei leitud vigade kohta
Kui olete kohandatud postituse tüübi registreerimiseks koodi lisanud, märkate, et ühe postituse vaatamisel kuvatakse viga "404 ei leitud". Seda seetõttu, et peate püsivaid linke värskendama.
Avage Seaded> Püsilingid ja klõpsake lihtsalt nuppu "Salvesta muudatused" (pole vaja midagi muuta).
Pidage meeles, et kui muudate rewriteatribuuti, peate püsilinke uuesti värskendama.
Kohandatud taksonoomia loomine
Kohandatud taksonoomia saab lisada ühele WordPressi postitustüübile (postitused, lehed) või kohandatud postituse tüübile. Postituse tüübile saate lisada ka mitu taksonoomiat. Taksonoomia registreerimisel peate esitama postituse tüübi(d), millele soovite selle lisada.
Taksonoomia võib olla kas hierarhiline (nt postituste kategooriad, kus saate luua puupõhise struktuuri) või sildipõhine (nt postitussildid). See on tõesti ainus asjaolu, mida peate eelnevalt teadma, välja arvatud selle identifikaatori nälkjas. Nagu CPT-de puhul, peab taksonoomiast tuvastav nälkjas olema kordumatu ja järgima reegleid.
Kohandatud taksonoomia registreerimiseks kasutate register_taxonomyfunktsiooni. Aktsepteerib register_taxonomytaksonoomia kordumatu identifikaatori slug esimese argumendina, postitustüüpide massiivi, millele see lisada teiseks, ja lõpuks massiivi kõigi ülejäänud argumentidega. Argumente on palju, kuid see on minu arvates minimaalne, kuid piisav kohandatud taksonoomia registreerimiseks (see lisab sildi tüüpi/mittehierarhilise taksonoomia):
Soovitatav on lisada funktsioonikutse kohe pärast register_taxonomy, veendumaks, et see on CPT-ga korralikult "kinnitatud": register_taxonomy_for_object_type. Määrake oma taksonoomia esimese argumendina ja CPT teise argumendina:
register_taxonomy_for_object_type('book_author', 'book');Sarnaselt ülaltoodud postituse tüübiga register_taxonomyaktsepteerib palju rohkem argumente ja paljud neist pärivad või sõltuvad teiste argumentide väärtusest. Lugege dokumentatsiooni, et näha, mis on iga argumendi vaikeväärtus ja kas peate selle alistama.
Ülevaade argumentidest
Kui teile sobivad tekstid, mis viitavad teie taksonoomiale kui "sildile" (kui hierarhia on vale) või "kategooriana" (kui hierarhia on tõene), võite tõenäoliselt kogu labelsmassiivi vahele jätta, välja arvatud võib-olla singular_name.
See show_admin_columnon mugav, et lisada CPT administraatori ekraanile veerg, mis näitab taksonoomia seotud termineid. Nii nagu postitustes, näete ka veergu, mis näitab seotud kategooriaid. Selle argumendi vaikeseadeks on false(ära kuva veergu), nii et mulle meeldib see alistada.
Tõene seadmine show_in_reston vajalik selleks, et teie taksonoomia oleks nähtav Gutenbergi redaktoris Postituse redigeerimisel, kuna Gutenberg tugineb REST API-le.
Sarnaselt kohandatud postitustüüpidega saate oma kohandatud taksonoomias tõenäoliselt veateate „404 ei leitud". Avage Seaded> Püsilingid ja klõpsake lihtsalt nuppu "Salvesta muudatused".
Täielik näidiskood
Siin on täielik näide raamatute jaoks CPT loomisest ja kahe kohandatud taksonoomia lisamisest; žanr (hierarhiline) ja raamatu autor (silt).