{"id":233572,"date":"2023-02-17T12:28:00","date_gmt":"2023-02-17T09:28:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=233572"},"modified":"2022-11-11T00:24:22","modified_gmt":"2022-11-10T21:24:22","slug":"luo-mukautettuja-viestityyppejae-ja-mukautettuja-taksonomioita-wordpressissae-koodin-mukaan","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/fi\/luo-mukautettuja-viestityyppejae-ja-mukautettuja-taksonomioita-wordpressissae-koodin-mukaan\/","title":{"rendered":"Luo mukautettuja viestityyppej\u00e4 ja mukautettuja taksonomioita WordPressiss\u00e4 koodin mukaan"},"content":{"rendered":"\n

T\u00e4m\u00e4 on opetusohjelma mukautetun viestityypin ja mukautetun taksonomian luomiseen WordPressiss\u00e4 koodin perusteella. Tarkastellaan yleisi\u00e4 sudenkuoppia ja sit\u00e4, mit\u00e4 argumentteja tulisi k\u00e4ytt\u00e4\u00e4 minimiin mutta riitt\u00e4v\u00e4\u00e4n luomiseen. Koko esimerkki lopussa.<\/p>\n

Mihin koodi lis\u00e4t\u00e4\u00e4n<\/h2>\n

Mukautettujen viestityyppien (CPT) ja mukautettujen taksonomioiden luominen WordPressiss\u00e4 voidaan tehd\u00e4 teematiedoston functions.php<\/code>tai laajennuksen sis\u00e4ll\u00e4. Muista, ett\u00e4 mukautettu viestityyppi ja mukautettu taksonomia katoavat, jos vaihdat teemaa tai poistat laajennuksen k\u00e4yt\u00f6st\u00e4. Joten on turvallista poistaa v\u00e4liaikaisesti CPT-rekister\u00f6inti teemasta ja siirt\u00e4\u00e4 se laajennukseen \u2013 kunhan s\u00e4ilyt\u00e4t saman mukautetun viestityypin tai taksonomiatunnisteen slug\/ID:n.<\/p>\n

K\u00e4yt\u00e4 aina<\/strong>init<\/code> koukkua CPT: n tai taksonomian luomiseen (ja muokkaamiseen). Sen asettaminen juureen functions.php<\/code>(koukun ulkopuolelle) tai mihin tahansa muuhun koukkuun aiheuttaa ongelmia.<\/p>\n

Muokatun viestityypin luominen<\/h2>\n

K\u00e4yt\u00e4 register_post_type<\/code>toimintoa mukautetun viestityypin luomiseen. Se hyv\u00e4ksyy kaksi parametria; ensin viestityypin tunniste ja toiseksi taulukko, jossa on kaikki argumentit.<\/p>\n

Viestityypin tunniste on viestityyppisi slug-versionimi. Esimerkiksi WordPressin sis\u00e4\u00e4nrakennetut postaustyyppiset viestit ja sivut tunnistetaan " post<\/code>" ja " page<\/code>". Tunnisteen on oltava yksil\u00f6llinen, sen on noudatettava tiettyj\u00e4 s\u00e4\u00e4nt\u00f6j\u00e4 (pienet kirjaimet, ei v\u00e4lily\u00f6ntej\u00e4 jne.), eik\u00e4 se saa olla WordPressin varattu slugs.<\/p>\n

T\u00e4m\u00e4n olen oppinut olemaan minimi, mutta riitt\u00e4v\u00e4n hyv\u00e4 argumentti viestityypin rekister\u00f6imiseksi; Ottaen huomioon, ett\u00e4 kyseess\u00e4 on normaali julkinen CPT ja haluat ohittaa kaikki tunnisteet, joissa lukee "julkaisu" tai "sivu" CPT:si todellisella nimell\u00e4:<\/p>\n

add_action('init', function() {\n    register_post_type('book', [\n        'label' => __('Books', 'txtdomain'),\n        'public' => true,\n        'menu_position' => 5,\n        'menu_icon' => 'dashicons-book',\n        'supports' => ['title', 'editor', 'thumbnail', 'author', 'revisions', 'comments'],\n        'show_in_rest' => true,\n        'rewrite' => ['slug' => 'book'],\n        'labels' => [\n            'singular_name' => __('Book', 'txtdomain'),\n            'add_new_item' => __('Add new book', 'txtdomain'),\n            'new_item' => __('New book', 'txtdomain'),\n            'view_item' => __('View book', 'txtdomain'),\n            'not_found' => __('No books found', 'txtdomain'),\n            'not_found_in_trash' => __('No books found in trash', 'txtdomain'),\n            'all_items' => __('All books', 'txtdomain'),\n            'insert_into_item' => __('Insert into book', 'txtdomain')\n        ],      \n    ]);\n});<\/code><\/pre>\n
Yleiskatsaus v\u00e4itteisiin<\/h3>\n
Huomaa, ett\u00e4 jotkin argumentit periv\u00e4t arvot toisista argumenteista. Ellei niit\u00e4 ole nimenomaisesti asetettu, ne saattavat olla oletusarvoisesti samat tai p\u00e4invastoin kuin toiset. Useat argumentit periv\u00e4t argumentin saman tai p\u00e4invastaisen arvon public<\/code>. Lue dokumentaatio<\/a> n\u00e4hd\u00e4ksesi, mik\u00e4 kunkin argumentin oletusarvo on ja jos sinun on ohitettava se.<\/p>\n
Jos j\u00e4rjestelm\u00e4nvalvojassa on tekstej\u00e4, jotka viittaavat viestityyppiisi "viesti" tai "sivu", voit ohittaa tunnisteargumenttien m\u00e4\u00e4ritt\u00e4misen. Luultavasti p\u00e4rj\u00e4\u00e4t vain label<\/code>(monikkonimi) ja labels<\/code>taulukon sis\u00e4ll\u00e4 vain singular_name<\/code>(yksikk\u00f6nimi).<\/p>\n
Jos et nimenomaisesti aseta show_in_rest<\/code>arvoksi tosi, mukautettu pos-tyyppisi k\u00e4ytt\u00e4\u00e4 vanhaa klassista editoria. Jos haluat k\u00e4ytt\u00e4\u00e4 Gutenberg-editoria mukautetulle viestityypille, sinun on asetettava show_in_rest<\/code>arvoksi tosi<\/strong>.<\/p>\n
Argumentti supports<\/code>kertoo, mitk\u00e4 elementit ovat k\u00e4ytett\u00e4viss\u00e4, kun muokkaat viestityyppi\u00e4si olevaa viesti\u00e4. Haluat luultavasti v\u00e4hint\u00e4\u00e4n otsikon, editorin ja esitellyn viestin kuvan.<\/p>\n
V\u00e4himm\u00e4istaulukkoelementti\u00e4 rewrite<\/code>sis\u00e4lt\u00e4v\u00e4 argumentti slug<\/code>k\u00e4skee WordPressin kirjoittamaan uudelleen kaikki viestityyppisi yksikk\u00f6viestit k\u00e4ytt\u00e4m\u00e4\u00e4n t\u00e4t\u00e4 etuliitett\u00e4. Yll\u00e4 olevassa esimerkiss\u00e4 yksitt\u00e4inen kirjaviesti saisi URL-osoitteen, kuten; " http:\/\/example.com\/book\/i-robot\/<\/a> ". Jos olet kiinnostunut siit\u00e4, kuinka voit lis\u00e4t\u00e4 pysyv\u00e4n linkin s\u00e4\u00e4nt\u00f6asetuksen j\u00e4rjestelm\u00e4nvalvojaan, jotta teeman k\u00e4ytt\u00e4j\u00e4t voivat p\u00e4\u00e4tt\u00e4\u00e4 itse t\u00e4st\u00e4 h\u00e4iri\u00f6st\u00e4, katso t\u00e4m\u00e4 viesti<\/a>.<\/p>\n
Valikkokuvakkeen (menu_icon<\/code>) argumentti voi olla mik\u00e4 tahansa seuraavista Dashiconeista<\/a> tai voit j\u00e4tt\u00e4\u00e4 sen tyhj\u00e4ksi s\u00e4ilytt\u00e4\u00e4ksesi oletusarvon. Oletus on sama kuvake kuin Viestit. On kuitenkin hyv\u00e4 idea erottaa mukautetut viestityypit selke\u00e4sti.<\/p>\n
Valikon sijainti (menu_position<\/code>) antaa sinun p\u00e4\u00e4tt\u00e4\u00e4 mukautetun viestityypin sijainnin j\u00e4rjestelm\u00e4nvalvojan valikossa. Dokumentaatiossa luetellaan kaikki j\u00e4rjestelm\u00e4nvalvojan valikon paikat, jotta voit s\u00e4\u00e4t\u00e4\u00e4; paikka 5 on heti "Viestit" j\u00e4lkeen.<\/p>\n
On toinenkin argumentti (taxonomies<\/code>) taksonomian liitt\u00e4miselle viestityyppiin. K\u00e4ymme l\u00e4pi, kuinka mukautettu taksonomia lis\u00e4t\u00e4\u00e4n my\u00f6hemmin t\u00e4ss\u00e4 viestiss\u00e4. Jos haluat lis\u00e4t\u00e4 taksonomioita viestityyppiisi, lis\u00e4\u00e4 t\u00e4m\u00e4 argumentti yll\u00e4 olevaan taulukkoon;<\/p>\n
'taxonomies' => ['book_author'],<\/code><\/pre>\n
Huomautus pysyvist\u00e4 linkeist\u00e4 ja 404 ei l\u00f6ytynyt -virheist\u00e4<\/h3>\n
Kun olet lis\u00e4nnyt koodin mukautetun viestityypin rekister\u00f6inti\u00e4 varten, huomaat, ett\u00e4 yksitt\u00e4isen viestin tarkastelu palauttaa "404 ei l\u00f6ytynyt" -virheen. T\u00e4m\u00e4 johtuu siit\u00e4, ett\u00e4 sinun on "p\u00e4ivitett\u00e4v\u00e4 pysyv\u00e4t linkit".<\/p>\n
Siirry kohtaan Asetukset> Pysyv\u00e4t linkit ja napsauta "Tallenna muutokset" -painiketta (ei tarvitse muuttaa mit\u00e4\u00e4n).<\/p>\n
Muista, ett\u00e4 aina kun muutat rewrite<\/code>m\u00e4\u00e4ritett\u00e4, sinun on p\u00e4ivitett\u00e4v\u00e4 pysyv\u00e4t linkit uudelleen.<\/p>\n
Muokatun taksonomian luominen<\/h2>\n
Mukautettu taksonomia voidaan liitt\u00e4\u00e4 johonkin WordPressin viestityypeist\u00e4 (viestit, sivut) tai mukautettuun viestityyppiin. Voit my\u00f6s liitt\u00e4\u00e4 viestityyppiin useita taksonomioita. Kun rekister\u00f6it taksonomian, sinun on annettava viestityypit, joihin haluat sen liitett\u00e4v\u00e4n.<\/p>\n
Taksonomia voi olla joko hierarkkinen (kuten viestiluokat, joissa voit luoda puupohjaisen rakenteen) tai tunnistepohjainen (kuten viestitunnisteet). T\u00e4m\u00e4 on oikeastaan \u200b\u200bainoa seikka, joka sinun on tiedett\u00e4v\u00e4 etuk\u00e4teen, lukuun ottamatta sen tunnisteetanaa. Kuten CPT:iss\u00e4, taksonomiaan tunnistavan etanan on oltava yksil\u00f6llinen ja noudatettava tiettyj\u00e4 s\u00e4\u00e4nt\u00f6j\u00e4.<\/p>\n
Mukautetun taksonomian rekister\u00f6imiseen k\u00e4yt\u00e4t register_taxonomy<\/code>toimintoa. Hyv\u00e4ksyy register_taxonomy<\/code>taksonomian yksil\u00f6llisen tunnisteen slug ensimm\u00e4isen\u00e4 argumenttina, joukon viestityyppej\u00e4, joihin se liitet\u00e4\u00e4n toiseksi, ja lopuksi taulukon, jossa on kaikki muut argumentit. Argumentteja on monia, mutta t\u00e4m\u00e4n olen kokenut v\u00e4himm\u00e4ism\u00e4\u00e4r\u00e4ksi mutta riitt\u00e4v\u00e4ksi mukautetun taksonomian rekister\u00f6imiseksi (t\u00e4m\u00e4 lis\u00e4\u00e4 tunnistetyyppisen\/ei-hierarkkisen taksonomian):<\/p>\n
add_action('init', function() {\n    register_taxonomy('book_author', ['book'], [\n        'label' => __('Authors', 'txtdomain'),\n        'hierarchical' => false,\n        'rewrite' => ['slug' => 'book-author'],\n        'show_admin_column' => true,\n        'show_in_rest' => true,\n        'labels' => [\n            'singular_name' => __('Author', 'txtdomain'),\n            'all_items' => __('All Authors', 'txtdomain'),\n            'edit_item' => __('Edit Author', 'txtdomain'),\n            'view_item' => __('View Author', 'txtdomain'),\n            'update_item' => __('Update Author', 'txtdomain'),\n            'add_new_item' => __('Add New Author', 'txtdomain'),\n            'new_item_name' => __('New Author Name', 'txtdomain'),\n            'search_items' => __('Search Authors', 'txtdomain'),\n            'popular_items' => __('Popular Authors', 'txtdomain'),\n            'separate_items_with_commas' => __('Separate authors with comma', 'txtdomain'),\n            'choose_from_most_used' => __('Choose from most used authors', 'txtdomain'),\n            'not_found' => __('No Authors found', 'txtdomain'),\n        ]\n    ]);\n});<\/code><\/pre>\n
On suositeltavaa lis\u00e4t\u00e4 funktiokutsu heti merkin j\u00e4lkeen register_taxonomy<\/code>varmistaaksesi, ett\u00e4 se "liittyy" oikein CPT:hen: register_taxonomy_for_object_type<\/code>. M\u00e4\u00e4rit\u00e4 taksonomiasi ensimm\u00e4iseksi argumentiksi ja CPT toiseksi:<\/p>\n
register_taxonomy_for_object_type('book_author', 'book');<\/code><\/pre>\n
Samoin kuin yll\u00e4 oleva viestityyppi, register_taxonomy<\/code>hyv\u00e4ksyy paljon enemm\u00e4n argumentteja, ja monet niist\u00e4 periv\u00e4t tai riippuvat muiden argumenttien arvosta. Lue dokumentaatio<\/a> n\u00e4hd\u00e4ksesi, mik\u00e4 kunkin argumentin oletusarvo on ja jos sinun on ohitettava se.<\/p>\n
Yleiskatsaus v\u00e4itteisiin<\/h3>\n
Jos sinun on hyv\u00e4 k\u00e4ytt\u00e4\u00e4 tekstej\u00e4, jotka viittaavat taksonomiaan "tunnisteella" (jos hierarkkinen on ep\u00e4tosi) tai "kategoria" (jos hierarkkinen on totta), voit luultavasti ohittaa koko labels<\/code>taulukon, paitsi ehk\u00e4 singular_name<\/code>.<\/p>\n
Se show_admin_column<\/code>on k\u00e4tev\u00e4 lis\u00e4tt\u00e4ess\u00e4 sarake, joka n\u00e4ytt\u00e4\u00e4 taksonomiaasi liittyv\u00e4t termit CPT-hallintan\u00e4yt\u00f6ss\u00e4. Aivan kuten Viesteiss\u00e4, n\u00e4et sarakkeen, joka n\u00e4ytt\u00e4\u00e4 liittyv\u00e4t luokat. T\u00e4m\u00e4n argumentin oletusasetuksena on false<\/code>(\u00e4l\u00e4 n\u00e4yt\u00e4 saraketta), joten haluan ohittaa sen.<\/p>\n
Tosi- asetuksen asettaminen show_in_rest<\/code>on v\u00e4ltt\u00e4m\u00e4t\u00f6nt\u00e4, jotta taksonomiasi n\u00e4kyy Post edit in Gutenberg -editorissa, koska Gutenberg luottaa REST API:han.<\/p>\n
Samoin kuin mukautetuissa viestityypeiss\u00e4, saat todenn\u00e4k\u00f6isesti "404 ei l\u00f6ytynyt" -virheit\u00e4 mukautetussa taksonomiassasi. Siirry kohtaan Asetukset> Pysyv\u00e4t linkit ja napsauta "Tallenna muutokset" -painiketta.<\/p>\n
T\u00e4ydellinen esimerkkikoodi<\/h2>\n
T\u00e4ss\u00e4 on t\u00e4ydellinen esimerkki CPT:n luomisesta kirjoille ja kahden mukautetun taksonomian liitt\u00e4misest\u00e4; genre (hierarkkinen) ja kirjan tekij\u00e4 (tunniste).<\/p>\n
add_action('init', function() {\n    register_post_type('book', [\n        'label' => __('Books', 'txtdomain'),\n        'public' => true,\n        'menu_position' => 5,\n        'menu_icon' => 'dashicons-book',\n        'supports' => ['title', 'editor', 'thumbnail', 'author', 'revisions', 'comments'],\n        'show_in_rest' => true,\n        'rewrite' => ['slug' => 'book'],\n        'taxonomies' => ['book_author', 'book_genre'],\n        'labels' => [\n            'singular_name' => __('Book', 'txtdomain'),\n            'add_new_item' => __('Add new book', 'txtdomain'),\n            'new_item' => __('New book', 'txtdomain'),\n            'view_item' => __('View book', 'txtdomain'),\n            'not_found' => __('No books found', 'txtdomain'),\n            'not_found_in_trash' => __('No books found in trash', 'txtdomain'),\n            'all_items' => __('All books', 'txtdomain'),\n            'insert_into_item' => __('Insert into book', 'txtdomain')\n        ],      \n    ]);\n\u00a0\n    register_taxonomy('book_genre', ['book'], [\n        'label' => __('Genres', 'txtdomain'),\n        'hierarchical' => true,\n        'rewrite' => ['slug' => 'book-genre'],\n        'show_admin_column' => true,\n        'show_in_rest' => true,\n        'labels' => [\n            'singular_name' => __('Genre', 'txtdomain'),\n            'all_items' => __('All Genres', 'txtdomain'),\n            'edit_item' => __('Edit Genre', 'txtdomain'),\n            'view_item' => __('View Genre', 'txtdomain'),\n            'update_item' => __('Update Genre', 'txtdomain'),\n            'add_new_item' => __('Add New Genre', 'txtdomain'),\n            'new_item_name' => __('New Genre Name', 'txtdomain'),\n            'search_items' => __('Search Genres', 'txtdomain'),\n            'parent_item' => __('Parent Genre', 'txtdomain'),\n            'parent_item_colon' => __('Parent Genre:', 'txtdomain'),\n            'not_found' => __('No Genres found', 'txtdomain'),\n        ]\n    ]);\n    register_taxonomy_for_object_type('book_genre', 'book');\n\u00a0\n    register_taxonomy('book_author', ['book'], [\n        'label' => __('Authors', 'txtdomain'),\n        'hierarchical' => false,\n        'rewrite' => ['slug' => 'book-author'],\n        'show_admin_column' => true,\n        'labels' => [\n            'singular_name' => __('Author', 'txtdomain'),\n            'all_items' => __('All Authors', 'txtdomain'),\n            'edit_item' => __('Edit Author', 'txtdomain'),\n            'view_item' => __('View Author', 'txtdomain'),\n            'update_item' => __('Update Author', 'txtdomain'),\n            'add_new_item' => __('Add New Author', 'txtdomain'),\n            'new_item_name' => __('New Author Name', 'txtdomain'),\n            'search_items' => __('Search Authors', 'txtdomain'),\n            'popular_items' => __('Popular Authors', 'txtdomain'),\n            'separate_items_with_commas' => __('Separate authors with comma', 'txtdomain'),\n            'choose_from_most_used' => __('Choose from most used Authors', 'txtdomain'),\n            'not_found' => __('No Authors found', 'txtdomain'),\n        ]\n    ]);\n    register_taxonomy_for_object_type('book_author', 'book');\n});<\/code><\/pre>\n
:  awhitepixel.com<\/a><\/div><\/p>\n","protected":false},"excerpt":{"rendered":"
Opas mukautettujen viestityyppien ja mukautettujen taksonomioiden luomiseen WordPressiss\u00e4 koodin mukaan. Kattaa argumentit, joita k\u00e4ytet\u00e4\u00e4n minimiin mutta riitt\u00e4v\u00e4\u00e4n luomiseen.<\/p>\n","protected":false},"author":1,"featured_media":152888,"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":{"0":"post-233572","1":"post","2":"type-post","3":"status-publish","4":"format-standard","5":"has-post-thumbnail","6":"hentry","7":"category-aiheita","8":"category-koodi","9":"category-kehittaejae","12":"category-muut","14":"category-n-a","15":"category-opetusohjelmia","16":"category-php-5","20":"category-wordpress-5","22":"tag-affiai-fi"},"_links":{"self":[{"href":"https:\/\/wordpress.mediadoma.com\/fi\/wp-json\/wp\/v2\/posts\/233572","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=233572"}],"version-history":[{"count":0,"href":"https:\/\/wordpress.mediadoma.com\/fi\/wp-json\/wp\/v2\/posts\/233572\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fi\/wp-json\/wp\/v2\/media\/152888"}],"wp:attachment":[{"href":"https:\/\/wordpress.mediadoma.com\/fi\/wp-json\/wp\/v2\/media?parent=233572"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fi\/wp-json\/wp\/v2\/categories?post=233572"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fi\/wp-json\/wp\/v2\/tags?post=233572"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}