{"id":233609,"date":"2023-02-17T12:54:00","date_gmt":"2023-02-17T09:54:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=233609"},"modified":"2022-11-11T00:37:22","modified_gmt":"2022-11-10T21:37:22","slug":"tworz-niestandardowe-typy-postow-i-niestandardowe-taksonomie-w-wordpress-wedlug-kodu","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/pl\/tworz-niestandardowe-typy-postow-i-niestandardowe-taksonomie-w-wordpress-wedlug-kodu\/","title":{"rendered":"Tw\u00f3rz niestandardowe typy post\u00f3w i niestandardowe taksonomie w WordPress wed\u0142ug kodu"},"content":{"rendered":"\n

To jest samouczek dotycz\u0105cy tworzenia niestandardowego typu postu i niestandardowej taksonomii w WordPress wed\u0142ug kodu. Przyjrzymy si\u0119 typowym pu\u0142apkom i argumentom, kt\u00f3rych nale\u017cy u\u017cy\u0107, aby stworzy\u0107 minimaln\u0105, ale wystarczaj\u0105c\u0105 kreacj\u0119. Pe\u0142ny przyk\u0142ad do\u0142\u0105czony na ko\u0144cu.<\/p>\n

Gdzie doda\u0107 kod?<\/h2>\n

Tworzenie niestandardowych typ\u00f3w post\u00f3w (CPT) i niestandardowych taksonomii w WordPressie mo\u017cna wykona\u0107 w functions.php<\/code>pliku motywu lub w wtyczce. Pami\u0119taj, \u017ce niestandardowy typ postu i niestandardowa taksonomia znikn\u0105, je\u015bli zmienisz motyw lub dezaktywujesz wtyczk\u0119. Mo\u017cna wi\u0119c tymczasowo usun\u0105\u0107 rejestracj\u0119 CPT z motywu i przenie\u015b\u0107 j\u0105 do wtyczki \u2014 o ile zachowasz ten sam niestandardowy typ postu lub identyfikator taksonomii slug\/ID.<\/p>\n

Do tworzenia (i modyfikowania) CPT lub taksonomii zawsze u\u017cywaj<\/strong> hooka init<\/code>. Umieszczenie go w korzeniu functions.php<\/code>(poza hakiem) lub innym haczyku spowoduje problemy.<\/p>\n

Tworzenie niestandardowego typu postu<\/h2>\n

Do tworzenia niestandardowego typu posta u\u017cywasz register_post_type<\/code>funkcji. Przyjmuje dwa parametry; po pierwsze identyfikator typu postu, a po drugie tablica ze wszystkimi argumentami.<\/p>\n

Identyfikator typu postu to nazwa wersji slugu typu posta. Na przyk\u0142ad posty i strony wbudowane w WordPress s\u0105 oznaczone jako \u201e post<\/code>" i \u201e page<\/code>„. Identyfikator musi by\u0107 unikalny, musi by\u0107 zgodny z zestawem regu\u0142 (ma\u0142e litery, bez spacji itp.) i nie mo\u017ce by\u0107 jednym z zastrze\u017conych slug WordPressa.<\/p>\n

Nauczy\u0142em si\u0119 tego, \u017ce s\u0105 minimalnymi, ale ca\u0142kowicie wystarczaj\u0105cymi argumentami do zarejestrowania typu postu; bior\u0105c pod uwag\u0119, \u017ce jest to normalny publiczny CPT i chcesz zast\u0105pi\u0107 wszelkie etykiety z napisem \u201epost” lub \u201estrona” rzeczywist\u0105 nazw\u0105 CPT:<\/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
Przegl\u0105d argument\u00f3w<\/h3>\n
Pami\u0119taj, \u017ce niekt\u00f3re argumenty dziedzicz\u0105 warto\u015bci z innych argument\u00f3w. O ile nie s\u0105 wyra\u017anie ustawione, mog\u0105 domy\u015blnie przyjmowa\u0107 t\u0119 sam\u0105 warto\u015b\u0107 lub przeciwnie do innej. Kilka argument\u00f3w dziedziczy t\u0119 sam\u0105 lub przeciwn\u0105 warto\u015b\u0107 argumentu public<\/code>. Przeczytaj dokumentacj\u0119,<\/a> aby zobaczy\u0107, jaka jest warto\u015b\u0107 domy\u015blna dla ka\u017cdego argumentu i czy musisz j\u0105 zast\u0105pi\u0107.<\/p>\n
Je\u015bli nie masz nic przeciwko posiadaniu w admin tekst\u00f3w, kt\u00f3re odnosz\u0105 si\u0119 do twojego typu postu jako \u201epost” lub \u201estrona”, mo\u017cesz pomin\u0105\u0107 definiowanie argument\u00f3w etykiet. Prawdopodobnie wystarczy tylko label<\/code>(nazwa w liczbie mnogiej) i tylko wewn\u0105trz labels<\/code>tablicy singular_name<\/code>(nazwa w liczbie pojedynczej).<\/p>\n
Je\u015bli nie ustawisz jawnie show_in_rest<\/code>warto\u015bci true, Tw\u00f3j niestandardowy typ pozycji b\u0119dzie u\u017cywa\u0142 starego klasycznego edytora. Je\u015bli chcesz u\u017cywa\u0107 edytora Gutenberg do niestandardowego typu postu, musisz ustawi\u0107 warto\u015b\u0107 show_in_rest<\/code>true<\/strong>.<\/p>\n
Argument supports<\/code>m\u00f3wi, kt\u00f3re elementy s\u0105 dost\u0119pne podczas edycji wpisu w Twoim typie wpisu. Jako minimum prawdopodobnie potrzebujesz tytu\u0142u, edytora i polecanego obrazu posta.<\/p>\n
Argument rewrite<\/code>z minimum elementu tablicy slug<\/code>m\u00f3wi WordPressowi, aby przepisa\u0142 wszystkie pojedyncze posty Twojego typu postu, aby u\u017cy\u0107 tego przedrostka. W powy\u017cszym przyk\u0142adzie pojedynczy wpis ksi\u0105\u017cki otrzyma adres URL podobny do; \u201e http:\/\/example.com\/ksi\u0105\u017cka\/i-robot\/<\/a> „. Je\u015bli interesuje Ci\u0119, jak doda\u0107 ustawienie regu\u0142y permalink w admin, aby umo\u017cliwi\u0107 u\u017cytkownikom motywu samodzielne decydowanie o tym slugu, sp\u00f3jrz na ten post<\/a>.<\/p>\n
Argumentem ikony menu (menu_icon<\/code>) mo\u017ce by\u0107 dowolny z nast\u0119puj\u0105cych Dashicons<\/a> lub mo\u017cesz pozostawi\u0107 go pustym, aby zachowa\u0107 warto\u015b\u0107 domy\u015bln\u0105. Domy\u015blnie jest to ta sama ikona co Posty. Dobrym pomys\u0142em jest jednak wyra\u017ane oddzielenie niestandardowych typ\u00f3w post\u00f3w.<\/p>\n
Pozycja menu (menu_position<\/code>) pozwala okre\u015bli\u0107 pozycj\u0119 niestandardowego typu postu w menu administratora. Dokumentacja zawiera list\u0119 wszystkich pozycji menu administratora, dzi\u0119ki czemu mo\u017cna dostosowa\u0107; pozycja 5 znajduje si\u0119 zaraz po \u201epostach”.<\/p>\n
Jest jeszcze jeden argument (taxonomies<\/code>) przemawiaj\u0105cy za do\u0142\u0105czeniem taksonomii do typu postu. W dalszej cz\u0119\u015bci tego postu om\u00f3wimy, jak doda\u0107 niestandardow\u0105 taksonomi\u0119. Aby doda\u0107 taksonomie do typu postu, dodaj ten argument do powy\u017cszej tablicy;<\/p>\n
'taxonomies' => ['book_author'],<\/code><\/pre>\n
Uwaga o permalinkach i b\u0142\u0119dach 404 nie znaleziono<\/h3>\n
Po dodaniu kodu do rejestracji niestandardowego typu posta zauwa\u017cysz, \u017ce wy\u015bwietlenie pojedynczego posta zwr\u00f3ci b\u0142\u0105d \u201e404 nie znaleziono”. Dzieje si\u0119 tak, poniewa\u017c musisz \u201eod\u015bwie\u017cy\u0107 permalinki”.<\/p>\n
Przejd\u017a do Ustawienia> Permalinki i po prostu kliknij przycisk \u201eZapisz zmiany” (nie musisz niczego zmienia\u0107).<\/p>\n
Pami\u0119taj, \u017ce za ka\u017cdym razem, gdy zmienisz rewrite<\/code>atrybut, b\u0119dziesz musia\u0142 ponownie od\u015bwie\u017cy\u0107 permalinki.<\/p>\n
Tworzenie niestandardowej taksonomii<\/h2>\n
Niestandardow\u0105 taksonomi\u0119 mo\u017cna do\u0142\u0105czy\u0107 do jednego z typ\u00f3w post\u00f3w WordPress (posty, strony) lub do niestandardowego typu post\u00f3w. Mo\u017cesz r\u00f3wnie\u017c do\u0142\u0105czy\u0107 wiele taksonomii do typu posta. Kiedy rejestrujesz taksonomi\u0119, musisz poda\u0107 typ stanowiska, do kt\u00f3rego ma by\u0107 do\u0142\u0105czona.<\/p>\n
Taksonomia mo\u017ce by\u0107 hierarchiczna (jak kategorie post\u00f3w, w kt\u00f3rych mo\u017cna utworzy\u0107 struktur\u0119 opart\u0105 na drzewie) lub opart\u0105 na znacznikach (takich jak tagi post\u00f3w). To naprawd\u0119 jedyna kwestia, kt\u00f3r\u0105 musisz wiedzie\u0107 wcze\u015bniej, z wyj\u0105tkiem jego identyfikatora slug. Podobnie jak w przypadku CPT, identyfikator identyfikuj\u0105cy taksonomi\u0119 musi by\u0107 unikalny i zgodny z zestawem regu\u0142.<\/p>\n
Do rejestracji niestandardowej taksonomii s\u0142u\u017cy register_taxonomy<\/code>funkcja. Akceptuje register_taxonomy<\/code>unikalny identyfikator taksonomii slug jako pierwszy argument, tablic\u0119 typ\u00f3w post\u00f3w do do\u0142\u0105czenia jako drugi, a na ko\u0144cu tablic\u0119 ze wszystkimi pozosta\u0142ymi argumentami. Jest wiele argument\u00f3w, ale to, czego do\u015bwiadczy\u0142em, jest minimalnym, ale wystarczaj\u0105cym do zarejestrowania niestandardowej taksonomii (to dodaje taksonomi\u0119 typu tag\/niehierarchiczn\u0105):<\/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
Zaleca si\u0119 dodanie wywo\u0142ania funkcji zaraz po register_taxonomy<\/code>, aby upewni\u0107 si\u0119, \u017ce zostanie poprawnie \u201edo\u0142\u0105czona” do CPT: register_taxonomy_for_object_type<\/code>. Zdefiniuj swoj\u0105 taksonomi\u0119 jako pierwszy argument, a CPT jako drugi:<\/p>\n
register_taxonomy_for_object_type('book_author', 'book');<\/code><\/pre>\n
Podobnie jak powy\u017cszy typ post, register_taxonomy<\/code>akceptuje znacznie wi\u0119cej argument\u00f3w, a wiele z nich dziedziczy lub zale\u017cy od warto\u015bci innych argument\u00f3w. Przeczytaj dokumentacj\u0119,<\/a> aby zobaczy\u0107, jaka jest warto\u015b\u0107 domy\u015blna dla ka\u017cdego argumentu i czy musisz j\u0105 zast\u0105pi\u0107.<\/p>\n
Przegl\u0105d argument\u00f3w<\/h3>\n
Je\u015bli nie masz nic przeciwko posiadaniu tekst\u00f3w, kt\u00f3re odnosz\u0105 si\u0119 do Twojej taksonomii jako \u201etag” (je\u015bli hierarchiczna jest fa\u0142szywa) lub \u201ekategoria” (je\u015bli hierarchiczna jest prawdziwa), prawdopodobnie mo\u017cesz pomin\u0105\u0107 ca\u0142\u0105 labels<\/code>tablic\u0119 z wyj\u0105tkiem by\u0107 mo\u017ce singular_name<\/code>.<\/p>\n
Jest show_admin_column<\/code>to przydatne przy dodawaniu kolumny pokazuj\u0105cej powi\u0105zane terminy w Twojej taksonomii na ekranie administratora CPT. Podobnie jak w Postach, widzisz kolumn\u0119 pokazuj\u0105c\u0105 powi\u0105zane kategorie. Ten argument jest domy\u015blnie ustawiony na false<\/code>(nie pokazuj kolumny), wi\u0119c lubi\u0119 go zast\u0105pi\u0107.<\/p>\n
Ustawienie show_in_rest<\/code>na true jest konieczne, aby Twoja taksonomia by\u0142a widoczna w edycji postu w edytorze Gutenberg, poniewa\u017c Gutenberg opiera si\u0119 na interfejsie API REST.<\/p>\n
Podobnie jak w przypadku niestandardowych typ\u00f3w post\u00f3w, prawdopodobnie otrzymasz b\u0142\u0119dy \u201e404 nie znaleziono” w niestandardowej taksonomii. Przejd\u017a do Ustawienia> Permalinki i po prostu kliknij przycisk "Zapisz zmiany".<\/p>\n
Pe\u0142ny przyk\u0142adowy kod<\/h2>\n
Oto pe\u0142ny przyk\u0142ad tworzenia CPT dla ksi\u0105\u017cek i do\u0142\u0105czania dw\u00f3ch niestandardowych taksonomii; gatunek (hierarchiczny) i autor ksi\u0105\u017cki (tag).<\/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
\u0179r\u00f3d\u0142o nagrywania:  awhitepixel.com<\/a><\/div><\/p>\n","protected":false},"excerpt":{"rendered":"
Przewodnik po tworzeniu niestandardowych typ\u00f3w post\u00f3w i niestandardowych taksonomii w WordPress wed\u0142ug kodu. Obejmuje argumenty do wykorzystania w celu stworzenia minimalnej, ale wystarczaj\u0105cej kreacji.<\/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":[897,721,721,919,897,919,1110,805,805,845,929,929,845,866,866],"tags":[1169],"class_list":{"0":"post-233609","1":"post","2":"type-post","3":"status-publish","4":"format-standard","5":"has-post-thumbnail","6":"hentry","7":"category-kod","8":"category-deweloper","10":"category-inny","13":"category-n-a","14":"category-php-7","16":"category-samouczki","17":"category-tematy","20":"category-wordpress-7","22":"tag-affiai-pl"},"_links":{"self":[{"href":"https:\/\/wordpress.mediadoma.com\/pl\/wp-json\/wp\/v2\/posts\/233609","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.mediadoma.com\/pl\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wordpress.mediadoma.com\/pl\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pl\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pl\/wp-json\/wp\/v2\/comments?post=233609"}],"version-history":[{"count":0,"href":"https:\/\/wordpress.mediadoma.com\/pl\/wp-json\/wp\/v2\/posts\/233609\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pl\/wp-json\/wp\/v2\/media\/152888"}],"wp:attachment":[{"href":"https:\/\/wordpress.mediadoma.com\/pl\/wp-json\/wp\/v2\/media?parent=233609"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pl\/wp-json\/wp\/v2\/categories?post=233609"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pl\/wp-json\/wp\/v2\/tags?post=233609"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}