{"id":147246,"date":"2026-10-29T15:19:20","date_gmt":"2026-10-29T14:19:20","guid":{"rendered":"https:\/\/www.seopress.org\/fr\/?post_type=documentation&#038;p=147246"},"modified":"2026-10-29T15:19:20","modified_gmt":"2026-10-29T14:19:20","slug":"definir-une-categorie-ou-un-terme-principal-pour-nimporte-quelle-taxonomie","status":"publish","type":"documentation","link":"https:\/\/www.seopress.org\/fr\/support\/guides\/definir-une-categorie-ou-un-terme-principal-pour-nimporte-quelle-taxonomie\/","title":{"rendered":"D\u00e9finir une cat\u00e9gorie ou un terme principal pour n\u2019importe quelle taxonomie"},"content":{"rendered":"<p>Quand une publication appartient \u00e0 plusieurs cat\u00e9gories, ou \u00e0 plusieurs termes d\u2019une m\u00eame taxonomie, le <strong>terme principal<\/strong> indique \u00e0 SEOPress lequel utiliser dans vos permaliens, vos variables dynamiques et votre fil d\u2019Ariane.<\/p>\n<p>Depuis SEOPress 10.4, vous pouvez d\u00e9finir un terme principal pour toutes les taxonomies publiques et hi\u00e9rarchiques affich\u00e9es dans l\u2019administration WordPress\u00a0: les cat\u00e9gories, les cat\u00e9gories de produits WooCommerce, et vos propres taxonomies hi\u00e9rarchiques (par exemple une taxonomie \u00ab\u00a0Genre\u00a0\u00bb pour des livres, ou \u00ab\u00a0Ville\u00a0\u00bb pour des services). Avant la 10.4, seules les cat\u00e9gories et les cat\u00e9gories de produits en proposaient un.<\/p>\n<h2>\u00c0 quoi sert le terme principal<\/h2>\n<ul>\n<li><strong>Permaliens<\/strong>\u00a0: la cat\u00e9gorie principale remplace la premi\u00e8re cat\u00e9gorie dans la balise de permalien <code>%category%<\/code> de vos articles, et la cat\u00e9gorie de produit principale est utilis\u00e9e dans les permaliens de produits WooCommerce qui contiennent la cat\u00e9gorie de produit. Le terme principal des autres taxonomies ne modifie pas vos permaliens.<\/li>\n<li><strong>Variables dynamiques<\/strong>\u00a0: <code>%%post_category%%<\/code> renvoie la cat\u00e9gorie principale, et <code>%%_ct_&lt;taxonomie&gt;%%<\/code> (par exemple <code>%%_ct_genre%%<\/code>) le terme principal de cette taxonomie, dans vos titres, m\u00e9ta descriptions, balises sociales et sch\u00e9mas. Consultez <a href=\"https:\/\/www.seopress.org\/fr\/support\/guides\/gerez-vos-balises-titres-et-metas\/\">la liste des variables dynamiques<\/a>.<\/li>\n<li><strong>Fil d\u2019Ariane (SEOPress PRO)<\/strong>\u00a0: quand une taxonomie est s\u00e9lectionn\u00e9e pour un type de publication dans <strong>SEO &gt; PRO &gt; Fil d\u2019Ariane &gt; Taxonomie \u00e0 afficher dans le fil d\u2019Ariane<\/strong>, le fil passe par le terme principal de cette taxonomie et par ses parents.<\/li>\n<\/ul>\n<p>Sans terme principal, SEOPress utilise le premier terme associ\u00e9 \u00e0 la publication, comme WordPress. Si vous retirez le terme principal de la publication (en le d\u00e9cochant par exemple), SEOPress l\u2019ignore et revient au premier terme.<\/p>\n<h2>D\u00e9finir le terme principal d\u2019une publication<\/h2>\n<p>Le s\u00e9lecteur ne liste que les termes associ\u00e9s \u00e0 la publication. Associez d\u2019abord au moins un terme, puis choisissez le terme principal. S\u00e9lectionnez <strong>Aucune (d\u00e9sactivera cette fonctionnalit\u00e9)<\/strong> pour retirer le terme principal.<\/p>\n<h3>Dans l\u2019\u00e9diteur de blocs<\/h3>\n<ol>\n<li>Modifiez votre publication et ouvrez la barre lat\u00e9rale <strong>R\u00e9glages<\/strong>.<\/li>\n<li>Dans le panneau de la taxonomie (<strong>Cat\u00e9gories<\/strong>, <strong>Cat\u00e9gories de produits<\/strong> ou votre propre taxonomie), cochez les termes de la publication.<\/li>\n<li>Sous la liste des termes, choisissez le terme principal dans <strong>S\u00e9lectionnez une cat\u00e9gorie principale<\/strong> (ou dans le s\u00e9lecteur \u00e9quivalent qui porte le nom de votre taxonomie).<\/li>\n<li>Enregistrez la publication.<\/li>\n<\/ol>\n<div class=\"alert alert-info\" role=\"alert\">Dans l\u2019\u00e9diteur de blocs, ce s\u00e9lecteur ne s\u2019affiche que pour les types de publication qui prennent en charge les champs personnalis\u00e9s (<code>custom-fields<\/code>), et uniquement pour les utilisateurs qui ont acc\u00e8s \u00e0 la m\u00e9tabox SEO. Sinon, utilisez l\u2019onglet <strong>Avanc\u00e9<\/strong> de la m\u00e9tabox SEO d\u00e9crit ci-dessous.<\/div>\n<h3>Dans l\u2019\u00e9diteur classique<\/h3>\n<p>Le m\u00eame s\u00e9lecteur est ajout\u00e9 en bas de la bo\u00eete de la taxonomie (<strong>Cat\u00e9gories<\/strong>, <strong>Cat\u00e9gories de produits<\/strong> ou votre propre taxonomie). Sa liste suit les cases que vous cochez ou d\u00e9cochez. Choisissez le terme principal, puis cliquez sur <strong>Mettre \u00e0 jour<\/strong> ou <strong>Publier<\/strong>.<\/p>\n<h3>Dans la m\u00e9tabox SEO<\/h3>\n<p>Dans l\u2019onglet <strong>Avanc\u00e9<\/strong> de la m\u00e9tabox SEO, vous trouverez un s\u00e9lecteur par taxonomie, avec le m\u00eame libell\u00e9. Cet onglet propose toujours le s\u00e9lecteur, m\u00eame quand il est masqu\u00e9 dans la bo\u00eete de la taxonomie (voir le filtre <code>seopress_primary_term_inline_selector<\/code> ci-dessous).<\/p>\n<h2>Comment le terme principal est enregistr\u00e9<\/h2>\n<p>Le terme principal est enregistr\u00e9 dans une m\u00e9tadonn\u00e9e de publication qui contient l\u2019ID du terme\u00a0:<\/p>\n<table class=\"table table-responsive\">\n<thead>\n<tr>\n<th>Taxonomie<\/th>\n<th>Cl\u00e9 de la m\u00e9ta<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Cat\u00e9gories (<code>category<\/code>), et cat\u00e9gories de produits (<code>product_cat<\/code>) sur les produits WooCommerce<\/td>\n<td><code>_seopress_robots_primary_cat<\/code> (inchang\u00e9e)<\/td>\n<\/tr>\n<tr>\n<td>Toute autre taxonomie, depuis SEOPress 10.4<\/td>\n<td><code>_seopress_robots_primary_term_{taxonomy}<\/code>, par exemple <code>_seopress_robots_primary_term_genre<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Ces cl\u00e9s sont disponibles dans l\u2019API REST de WordPress (champ <code>meta<\/code> de la publication). Avec WPML, le terme principal est copi\u00e9 dans les traductions et converti vers le terme traduit. Quand vous <a href=\"https:\/\/www.seopress.org\/fr\/support\/guides\/importer-les-metadonnees-des-posts-et-terms-depuis-yoast-seo-vers-seopress\/\">importez vos donn\u00e9es depuis Yoast SEO<\/a>, le terme principal de chaque taxonomie est \u00e9galement import\u00e9.<\/p>\n<p>Pour lire le terme principal dans votre propre code\u00a0:<\/p>\n<pre><code>\/\/ Primary term of the \"genre\" taxonomy, as a term ID (empty string if none).\r\n$term_id = get_post_meta( get_the_ID(), '_seopress_robots_primary_term_genre', true );\r\nif ( $term_id &amp;&amp; has_term( (int) $term_id, 'genre' ) ) {\r\n\t$term = get_term( (int) $term_id, 'genre' );\r\n}<\/code><\/pre>\n<p>Avant SEOPress 10.4, certains sites enregistraient le terme d\u2019une autre taxonomie dans <code>_seopress_robots_primary_cat<\/code> (import CSV, API REST ou filtre <code>seopress_primary_category_list<\/code>). SEOPress continue de lire cette valeur pour la taxonomie concern\u00e9e tant que vous n\u2019avez pas enregistr\u00e9 de terme principal pour elle.<\/p>\n<h2>Pour les d\u00e9veloppeurs\u00a0: les filtres<\/h2>\n<p>Ajoutez ces extraits au fichier <code>functions.php<\/code> de votre th\u00e8me enfant ou dans un <a href=\"https:\/\/www.seopress.org\/fr\/support\/guides\/comment-creer-un-mu-plugin-must-use-plugin\/\">must-use plugin<\/a>.<\/p>\n<h3>Choisir les taxonomies qui proposent un terme principal<\/h3>\n<p>Le filtre <code>seopress_primary_term_taxonomies<\/code> re\u00e7oit les taxonomies qui proposent un s\u00e9lecteur (un tableau d\u2019objets <code>WP_Taxonomy<\/code> index\u00e9 par nom) et le type de publication. Pour retirer une taxonomie\u00a0:<\/p>\n<pre><code>add_filter( 'seopress_primary_term_taxonomies', function( $taxonomies, $post_type ) {\r\n\tunset( $taxonomies['genre'] );\r\n\treturn $taxonomies;\r\n}, 10, 2 );<\/code><\/pre>\n<p>Ou pour ajouter une taxonomie non hi\u00e9rarchique, comme les \u00e9tiquettes des articles. Son s\u00e9lecteur est propos\u00e9 dans l\u2019onglet <strong>Avanc\u00e9<\/strong> de la m\u00e9tabox SEO\u00a0:<\/p>\n<pre><code>add_filter( 'seopress_primary_term_taxonomies', function( $taxonomies, $post_type ) {\r\n\tif ( 'post' === $post_type ) {\r\n\t\t$taxonomies['post_tag'] = get_taxonomy( 'post_tag' );\r\n\t}\r\n\treturn $taxonomies;\r\n}, 10, 2 );<\/code><\/pre>\n<h3>Filtrer les termes propos\u00e9s<\/h3>\n<p>Le filtre <code>seopress_primary_term_list<\/code> re\u00e7oit les termes propos\u00e9s, le nom de la taxonomie et la publication. Par exemple, pour ne jamais proposer \u00ab\u00a0Non class\u00e9\u00a0\u00bb\u00a0:<\/p>\n<pre><code>add_filter( 'seopress_primary_term_list', function( $terms, $taxonomy, $post ) {\r\n\tif ( 'category' !== $taxonomy || ! is_array( $terms ) ) {\r\n\t\treturn $terms;\r\n\t}\r\n\treturn array_values(\r\n\t\tarray_filter( $terms, function( $term ) {\r\n\t\t\treturn 'uncategorized' !== $term-&gt;slug;\r\n\t\t} )\r\n\t);\r\n}, 10, 3 );<\/code><\/pre>\n<p>L\u2019ancien filtre <code>seopress_primary_category_list<\/code> fonctionne toujours, pour les cat\u00e9gories et les cat\u00e9gories de produits uniquement. Il ne re\u00e7oit que les termes.<\/p>\n<h3>Masquer le s\u00e9lecteur dans la bo\u00eete de la taxonomie<\/h3>\n<p>Renvoyez <code>false<\/code> dans le filtre <code>seopress_primary_term_inline_selector<\/code> pour retirer le s\u00e9lecteur de la bo\u00eete de la taxonomie, dans l\u2019\u00e9diteur de blocs et dans l\u2019\u00e9diteur classique. Il re\u00e7oit la valeur actuelle, le nom de la taxonomie et le type de publication. Un terme principal d\u00e9j\u00e0 enregistr\u00e9 continue de fonctionner, et l\u2019onglet <strong>Avanc\u00e9<\/strong> de la m\u00e9tabox SEO propose toujours le s\u00e9lecteur.<\/p>\n<pre><code>add_filter( 'seopress_primary_term_inline_selector', function( $enabled, $taxonomy, $post_type ) {\r\n\tif ( 'product_cat' === $taxonomy ) {\r\n\t\treturn false;\r\n\t}\r\n\treturn $enabled;\r\n}, 10, 3 );<\/code><\/pre>\n<p>En savoir plus sur notre page d\u00e9di\u00e9e \u00e0 ce hook\u00a0: <a href=\"https:\/\/www.seopress.org\/support\/hooks\/hide-the-primary-category-dropdown-on-the-post-edit-screen\/\">masquer le menu d\u00e9roulant de la cat\u00e9gorie principale sur l\u2019\u00e9cran de modification<\/a>.<\/p>\n","protected":false},"featured_media":0,"parent":0,"template":"","meta":{"_seopress_titles_title":"","_seopress_titles_desc":"","_seopress_robots_index":"","_seopress_robots_follow":"","_seopress_robots_imageindex":"","_seopress_robots_snippet":"","_seopress_robots_primary_cat":"","_seopress_robots_breadcrumbs":"","_seopress_robots_freeze_modified_date":"","_seopress_robots_custom_modified_date":"","_seopress_robots_canonical":"","_seopress_social_fb_title":"","_seopress_social_fb_desc":"","_seopress_social_fb_img":"","_seopress_social_fb_img_attachment_id":0,"_seopress_social_fb_img_width":0,"_seopress_social_fb_img_height":0,"_seopress_social_twitter_title":"","_seopress_social_twitter_desc":"","_seopress_social_twitter_img":"","_seopress_social_twitter_img_attachment_id":0,"_seopress_social_twitter_img_width":0,"_seopress_social_twitter_img_height":0,"_seopress_redirections_value":"","_seopress_redirections_enabled":"","_seopress_redirections_enabled_regex":"","_seopress_redirections_logged_status":"","_seopress_redirections_param":"","_seopress_redirections_type":0,"_seopress_analysis_target_kw":"","_seopress_news_disabled":"","_seopress_video_disabled":"","_seopress_video":[],"_seopress_pro_schemas_manual":[],"_seopress_pro_rich_snippets_disable_all":"","_seopress_pro_rich_snippets_disable":[],"_seopress_pro_schemas":[],"_relevanssi_hide_post":"","_relevanssi_hide_content":"","_relevanssi_pin_for_all":"","_relevanssi_pin_keywords":"","_relevanssi_unpin_keywords":"","_relevanssi_related_keywords":"","_relevanssi_related_include_ids":"","_relevanssi_related_exclude_ids":"","_relevanssi_related_no_append":"","_relevanssi_related_not_related":"","_relevanssi_related_posts":"","_relevanssi_noindex_reason":"","editor_notices":[],"footnotes":""},"class_list":["post-147246","documentation","type-documentation","status-publish","documentation_type-guides","product-seopress-free"],"acf":[],"permalink_manager":null,"_links":{"self":[{"href":"https:\/\/www.seopress.org\/fr\/wp-json\/wp\/v2\/documentation\/147246","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.seopress.org\/fr\/wp-json\/wp\/v2\/documentation"}],"about":[{"href":"https:\/\/www.seopress.org\/fr\/wp-json\/wp\/v2\/types\/documentation"}],"version-history":[{"count":1,"href":"https:\/\/www.seopress.org\/fr\/wp-json\/wp\/v2\/documentation\/147246\/revisions"}],"predecessor-version":[{"id":147247,"href":"https:\/\/www.seopress.org\/fr\/wp-json\/wp\/v2\/documentation\/147246\/revisions\/147247"}],"wp:attachment":[{"href":"https:\/\/www.seopress.org\/fr\/wp-json\/wp\/v2\/media?parent=147246"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}