{"id":234231,"date":"2023-02-17T12:48:00","date_gmt":"2023-02-17T09:48:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=234231"},"modified":"2022-11-12T01:18:54","modified_gmt":"2022-11-11T22:18:54","slug":"creer-des-types-de-publication-personnalises-et-des-taxonomies-personnalisees-dans-wordpress-par-code","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/fr\/creer-des-types-de-publication-personnalises-et-des-taxonomies-personnalisees-dans-wordpress-par-code\/","title":{"rendered":"Cr\u00e9er des types de publication personnalis\u00e9s et des taxonomies personnalis\u00e9es dans WordPress par code"},"content":{"rendered":"\n

Il s’agit d’un tutoriel sur la fa\u00e7on de cr\u00e9er un type de publication personnalis\u00e9 et une taxonomie personnalis\u00e9e dans WordPress par code. Nous verrons les pi\u00e8ges courants et les arguments \u00e0 utiliser pour une cr\u00e9ation minimale mais suffisante. Exemple complet inclus \u00e0 la fin.<\/p>\n

O\u00f9 ajouter le code<\/h2>\n

La cr\u00e9ation de types de publication personnalis\u00e9s (CPT) et de taxonomies personnalis\u00e9es dans WordPress peut \u00eatre effectu\u00e9e dans le fichier d’un th\u00e8me functions.php<\/code>ou dans un plugin. Gardez \u00e0 l’esprit que le type de publication personnalis\u00e9 et la taxonomie personnalis\u00e9e dispara\u00eetront si vous changez de th\u00e8me ou d\u00e9sactivez le plug-in. Il est donc s\u00fbr de supprimer temporairement l’enregistrement CPT du th\u00e8me et de le d\u00e9placer dans un plugin – tant que vous conservez le m\u00eame type de message personnalis\u00e9 ou le m\u00eame slug\/ID d’identifiant de taxonomie.<\/p>\n

Pour cr\u00e9er (et modifier) \u200b\u200bun CPT ou une taxonomie, utilisez toujours<\/strong> le init<\/code>crochet. Le placer \u00e0 la racine de functions.php<\/code>(\u00e0 l’ext\u00e9rieur d’un crochet) ou de tout autre crochet causera des probl\u00e8mes.<\/p>\n

Cr\u00e9ation d’un type de publication personnalis\u00e9<\/h2>\n

Pour cr\u00e9er un type de publication personnalis\u00e9, vous utilisez la register_post_type<\/code>fonction. Il accepte deux param\u00e8tres\u00a0; d’abord l’identifiant du type de publication et ensuite un tableau avec tous les arguments.<\/p>\n

L’identifiant du type de publication est un nom de version slug de votre type de publication. Par exemple, les articles et les pages des types de publication int\u00e9gr\u00e9s de WordPress sont identifi\u00e9s par ‘ post<\/code>‘ et ‘ page<\/code>‘. L’identifiant doit \u00eatre unique, il doit suivre un ensemble de r\u00e8gles (minuscules, pas d’espaces, etc.) et ne pas \u00eatre l’un des slugs r\u00e9serv\u00e9s de WordPress.<\/p>\n

C’est ce que j’ai appris pour \u00eatre les arguments minimum mais parfaitement suffisants pour enregistrer un type de publication; \u00e9tant donn\u00e9 qu’il s’agit d’un CPT public normal et que vous souhaitez remplacer tous les libell\u00e9s indiquant "post" ou "page" par le nom r\u00e9el de votre CPT\u00a0:<\/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
Un aper\u00e7u des arguments<\/h3>\n
Sachez que certains des arguments h\u00e9ritent des valeurs d’autres arguments. \u00c0 moins qu’ils ne soient explicitement d\u00e9finis, ils peuvent avoir par d\u00e9faut la m\u00eame valeur ou l’oppos\u00e9 d’un autre. Plusieurs arguments h\u00e9ritent de la m\u00eame valeur ou de la valeur oppos\u00e9e de l’argument public<\/code>. Lisez la documentation<\/a> pour voir quelle est la valeur par d\u00e9faut pour chaque argument et si vous devez la remplacer.<\/p>\n
Si vous \u00eates d’accord pour avoir des textes dans l’administration qui font r\u00e9f\u00e9rence \u00e0 votre type de message comme "post" ou "page", vous pouvez ignorer la d\u00e9finition des arguments d’\u00e9tiquette. Vous serez probablement d’accord avec seulement label<\/code>(nom au pluriel) et \u00e0 l’int\u00e9rieur du labels<\/code>tableau juste singular_name<\/code>(nom au singulier).<\/p>\n
Si vous ne d\u00e9finissez pas explicitement la show_in_rest<\/code>valeur true, votre type pos personnalis\u00e9 utilisera l’ancien \u00e9diteur classique. Si vous souhaitez utiliser l’\u00e9diteur Gutenberg pour votre type de publication personnalis\u00e9, vous devez d\u00e9finir show_in_rest<\/code>sur true<\/strong>.<\/p>\n
L’ supports<\/code>argument indique quels \u00e9l\u00e9ments sont disponibles lors de la modification d’un article dans votre type d’article. Au minimum, vous voulez probablement le titre, l’\u00e9diteur et l’image de publication en vedette.<\/p>\n
L’ rewrite<\/code>argument avec le minimum d’\u00e9l\u00e9ment de tableau slug<\/code>indique \u00e0 WordPress de r\u00e9\u00e9crire tous les articles singuliers de votre type d’article pour utiliser ce slug de pr\u00e9fixe. Dans l’exemple ci-dessus, un article de livre singulier obtiendrait une URL du type\u00a0; " http:\/\/example.com\/book\/i-robot\/<\/a> ". Si vous souhaitez savoir comment ajouter un param\u00e8tre de r\u00e8gle de permalien dans l’administrateur pour permettre aux utilisateurs du th\u00e8me de d\u00e9cider eux-m\u00eames de ce slug, consultez cet article<\/a>.<\/p>\n
L’argument de l’ic\u00f4ne de menu (menu_icon<\/code>) peut \u00eatre l’un des Dashicons<\/a> suivants, ou vous pouvez le laisser vide pour conserver la valeur par d\u00e9faut. La valeur par d\u00e9faut est la m\u00eame ic\u00f4ne que les publications. C’est cependant une bonne id\u00e9e de s\u00e9parer clairement vos types de publication personnalis\u00e9s.<\/p>\n
La position du menu (menu_position<\/code>) vous permet de d\u00e9cider de la position de votre type de message personnalis\u00e9 dans le menu admin. La documentation r\u00e9pertorie toutes les positions du menu d’administration, vous pouvez donc vous ajuster. la position 5 est juste apr\u00e8s ‘Messages’.<\/p>\n
Il y a un autre argument (taxonomies<\/code>) pour attacher une taxonomie au type de publication. Nous verrons comment ajouter une taxonomie personnalis\u00e9e plus loin dans cet article. Pour ajouter des taxonomies \u00e0 votre type de publication, ajoutez cet argument au tableau ci-dessus\u00a0;<\/p>\n
'taxonomies' => ['book_author'],<\/code><\/pre>\n
Une note sur les permaliens et les erreurs 404 introuvables<\/h3>\n
Apr\u00e8s avoir ajout\u00e9 votre code pour enregistrer un type de message personnalis\u00e9, vous remarquerez que l’affichage d’un seul message renverra l’erreur "404 introuvable". C’est parce que vous devez "rafra\u00eechir les permaliens".<\/p>\n
Allez dans Param\u00e8tres > Permaliens, et cliquez simplement sur le bouton "Enregistrer les modifications" (pas besoin de changer quoi que ce soit).<\/p>\n
Gardez \u00e0 l’esprit que chaque fois que vous modifiez l’ rewrite<\/code>attribut, vous devrez \u00e0 nouveau actualiser les permaliens.<\/p>\n
Cr\u00e9ation d’une taxonomie personnalis\u00e9e<\/h2>\n
Une taxonomie personnalis\u00e9e peut \u00eatre attach\u00e9e \u00e0 l’un des types de publication de WordPress (publications, pages) ou \u00e0 un type de publication personnalis\u00e9. Vous pouvez \u00e9galement attacher plusieurs taxonomies \u00e0 un type de publication. Lorsque vous enregistrez une taxonomie, vous devez fournir le ou les types de publication auxquels vous souhaitez qu’elle soit jointe.<\/p>\n
Une taxonomie peut \u00eatre hi\u00e9rarchique (comme les cat\u00e9gories de publication o\u00f9 vous pouvez cr\u00e9er une structure arborescente) ou bas\u00e9e sur des balises (comme les balises de publication). C’est vraiment la seule consid\u00e9ration que vous devez conna\u00eetre au pr\u00e9alable, \u00e0 l’exception de son identifiant slug. Comme pour les CPT, la limace d’identification d’une taxonomie doit \u00eatre unique et suivre un ensemble de r\u00e8gles.<\/p>\n
Pour enregistrer une taxonomie personnalis\u00e9e, vous utilisez la register_taxonomy<\/code>fonction. Le register_taxonomy<\/code>accepte le slug d’identifiant unique de taxonomie comme premier argument, un tableau de types de publication auquel l’attacher en second, et enfin un tableau avec tout le reste des arguments. Il y a beaucoup d’arguments, mais c’est ce que j’ai v\u00e9cu comme \u00e9tant le minimum mais suffisant pour enregistrer une taxonomie personnalis\u00e9e (cela ajoute une taxonomie de type balise\/non hi\u00e9rarchique):<\/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
Il est recommand\u00e9 d’ajouter un appel de fonction juste apr\u00e8s le register_taxonomy<\/code>, pour s’assurer qu’il est correctement \u00abattach\u00e9\u00bb au CPT: register_taxonomy_for_object_type<\/code>. D\u00e9finissez votre taxonomie comme premier argument et le CPT comme second\u00a0:<\/p>\n
register_taxonomy_for_object_type('book_author', 'book');<\/code><\/pre>\n
De m\u00eame que le type de message ci-dessus, register_taxonomy<\/code>accepte beaucoup plus d’arguments, et beaucoup d’entre eux h\u00e9ritent ou d\u00e9pendent de la valeur d’autres arguments. Lisez la documentation<\/a> pour voir quelle est la valeur par d\u00e9faut pour chaque argument et si vous devez la remplacer.<\/p>\n
Un aper\u00e7u des arguments<\/h3>\n
Si vous \u00eates d’accord pour avoir des textes qui font r\u00e9f\u00e9rence \u00e0 votre taxonomie en tant que "tag" (si hi\u00e9rarchique est faux) ou "cat\u00e9gorie" (si hi\u00e9rarchique est vrai), vous pouvez probablement ignorer tout le labels<\/code>tableau \u00e0 l’exception peut-\u00eatre de singular_name<\/code>.<\/p>\n
Le show_admin_column<\/code>est pratique pour ajouter une colonne montrant les termes associ\u00e9s dans votre taxonomie dans votre \u00e9cran d’administration CPT. Tout comme dans les publications, vous voyez une colonne affichant les cat\u00e9gories associ\u00e9es. Cet argument est d\u00e9fini par d\u00e9faut sur false<\/code>(ne pas afficher la colonne), donc j’aime le remplacer.<\/p>\n
La d\u00e9finition show_in_rest<\/code>sur true est n\u00e9cessaire pour que votre taxonomie soit visible dans Post edit dans l’\u00e9diteur Gutenberg, car Gutenberg s’appuie sur l’API REST.<\/p>\n
De m\u00eame qu’avec les types de publication personnalis\u00e9s, vous obtiendrez probablement des erreurs "404 introuvables" sur votre taxonomie personnalis\u00e9e. Allez dans Param\u00e8tres> Permaliens et cliquez simplement sur le bouton "Enregistrer les modifications".<\/p>\n
Exemple de code complet<\/h2>\n
Voici un exemple complet de cr\u00e9ation d’un CPT pour les livres et d’association de deux taxonomies personnalis\u00e9es\u00a0; genre (hi\u00e9rarchique) et auteur du livre (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
Source d’enregistrement:  awhitepixel.com<\/a><\/div><\/p>\n","protected":false},"excerpt":{"rendered":"
Un guide pour cr\u00e9er des types de publication personnalis\u00e9s et des taxonomies personnalis\u00e9es dans WordPress par code. Couvre les arguments \u00e0 utiliser pour une cr\u00e9ation minimale mais suffisante.<\/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":[915,893,893,717,717,915,1110,801,801,925,925,841,841,862,862],"tags":[1167],"class_list":{"0":"post-234231","1":"post","2":"type-post","3":"status-publish","4":"format-standard","5":"has-post-thumbnail","6":"hentry","7":"category-autre","8":"category-code-2","10":"category-developpeur","13":"category-n-a","14":"category-php-3","16":"category-sujets","18":"category-tutoriels","20":"category-wordpress-3","22":"tag-affiai-fr"},"_links":{"self":[{"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/posts\/234231","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/comments?post=234231"}],"version-history":[{"count":0,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/posts\/234231\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/media\/152888"}],"wp:attachment":[{"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/media?parent=234231"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/categories?post=234231"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/tags?post=234231"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}