{"id":25997,"date":"2026-10-29T15:19:52","date_gmt":"2026-10-29T14:19:52","guid":{"rendered":"https:\/\/www.seopress.org\/es\/?post_type=documentation&#038;p=25997"},"modified":"2026-10-29T15:19:52","modified_gmt":"2026-10-29T14:19:52","slug":"definir-una-categoria-o-un-termino-principal-para-cualquier-taxonomia","status":"publish","type":"documentation","link":"https:\/\/www.seopress.org\/es\/soporte\/guias\/definir-una-categoria-o-un-termino-principal-para-cualquier-taxonomia\/","title":{"rendered":"Definir una categor\u00eda o un t\u00e9rmino principal para cualquier taxonom\u00eda"},"content":{"rendered":"<p>Cuando una entrada pertenece a varias categor\u00edas, o a varios t\u00e9rminos de una misma taxonom\u00eda, el <strong>t\u00e9rmino principal<\/strong> le indica a SEOPress cu\u00e1l debe usar en tus enlaces permanentes, variables din\u00e1micas y migas de pan.<\/p>\n<p>Desde SEOPress 10.4, puedes definir un t\u00e9rmino principal en todas las taxonom\u00edas p\u00fablicas y jer\u00e1rquicas que se muestran en la administraci\u00f3n de WordPress: las categor\u00edas, las categor\u00edas de productos de WooCommerce y tus propias taxonom\u00edas jer\u00e1rquicas (por ejemplo, una taxonom\u00eda \u00abG\u00e9nero\u00bb para libros o una taxonom\u00eda \u00abUbicaci\u00f3n\u00bb para servicios). Antes de la 10.4, solo las categor\u00edas y las categor\u00edas de productos ofrec\u00edan esta opci\u00f3n.<\/p>\n<h2>Para qu\u00e9 sirve el t\u00e9rmino principal<\/h2>\n<ul>\n<li><strong>Enlaces permanentes<\/strong>: la categor\u00eda principal sustituye a la primera categor\u00eda en la etiqueta de enlace permanente <code>%category%<\/code> de tus entradas, y la categor\u00eda de producto principal se usa en los enlaces permanentes de productos de WooCommerce que incluyen la categor\u00eda del producto. El t\u00e9rmino principal de las dem\u00e1s taxonom\u00edas no modifica tus enlaces permanentes.<\/li>\n<li><strong>Variables din\u00e1micas<\/strong>: <code>%%post_category%%<\/code> devuelve la categor\u00eda principal, y <code>%%_ct_&lt;taxonomy&gt;%%<\/code> (por ejemplo, <code>%%_ct_genre%%<\/code>) el t\u00e9rmino principal de esa taxonom\u00eda, en tus t\u00edtulos, meta descripciones, etiquetas sociales y esquemas. Consulta <a href=\"https:\/\/www.seopress.org\/es\/soporte\/guias\/administrar-titulos-y-metas\/\">la lista de variables din\u00e1micas<\/a>.<\/li>\n<li><strong>Migas de pan (SEOPress PRO)<\/strong>: cuando se selecciona una taxonom\u00eda para un tipo de contenido en <strong>SEO &gt; PRO &gt; Migas de pan &gt; Taxonom\u00eda para mostrar en migas de pan<\/strong>, la ruta pasa por el t\u00e9rmino principal de esa taxonom\u00eda y por sus t\u00e9rminos padre.<\/li>\n<\/ul>\n<p>Sin t\u00e9rmino principal, SEOPress usa el primer t\u00e9rmino asignado a la entrada, como hace WordPress. Si quitas el t\u00e9rmino principal de la entrada (por ejemplo, desmarc\u00e1ndolo), SEOPress lo ignora y vuelve a usar el primer t\u00e9rmino.<\/p>\n<h2>Definir el t\u00e9rmino principal de una entrada<\/h2>\n<p>El selector solo muestra los t\u00e9rminos asignados a la entrada. Primero asigna al menos un t\u00e9rmino y luego elige el principal. Selecciona <strong>Ninguno (se desactivar\u00e1 esta caracter\u00edstica)<\/strong> para quitar el t\u00e9rmino principal.<\/p>\n<h3>En el editor de bloques<\/h3>\n<ol>\n<li>Edita tu entrada y abre la barra lateral de <strong>Ajustes<\/strong>.<\/li>\n<li>En el panel de la taxonom\u00eda (<strong>Categor\u00edas<\/strong>, <strong>Categor\u00edas de productos<\/strong> o tu propia taxonom\u00eda), marca los t\u00e9rminos de la entrada.<\/li>\n<li>Debajo de la lista de t\u00e9rminos, elige el principal en <strong>Elige una categor\u00eda principal<\/strong> (o en el selector equivalente que lleva el nombre de tu taxonom\u00eda, por ejemplo <strong>Elige un G\u00e9nero principal<\/strong>).<\/li>\n<li>Guarda la entrada.<\/li>\n<\/ol>\n<div class=\"alert alert-info\" role=\"alert\">En el editor de bloques, este selector solo se muestra para los tipos de contenido que admiten campos personalizados (<code>custom-fields<\/code>), y solo a los usuarios que pueden acceder a la metabox SEO. En caso contrario, usa la pesta\u00f1a <strong>Avanzado<\/strong> de la metabox SEO que se describe m\u00e1s abajo.<\/div>\n<h3>En el editor cl\u00e1sico<\/h3>\n<p>El mismo selector se a\u00f1ade en la parte inferior de la caja de la taxonom\u00eda (<strong>Categor\u00edas<\/strong>, <strong>Categor\u00edas de productos<\/strong> o tu propia taxonom\u00eda). Su lista se actualiza seg\u00fan las casillas que marques o desmarques. Elige el t\u00e9rmino principal y haz clic en <strong>Actualizar<\/strong> o <strong>Publicar<\/strong>.<\/p>\n<h3>En la metabox SEO<\/h3>\n<p>En la pesta\u00f1a <strong>Avanzado<\/strong> de la metabox SEO encontrar\u00e1s un selector por taxonom\u00eda, con la misma etiqueta. Esta pesta\u00f1a siempre ofrece el selector, aunque est\u00e9 oculto en la caja de la taxonom\u00eda (consulta el filtro <code>seopress_primary_term_inline_selector<\/code> m\u00e1s abajo).<\/p>\n<h2>C\u00f3mo se guarda el t\u00e9rmino principal<\/h2>\n<p>El t\u00e9rmino principal se guarda como un metadato de la entrada que contiene el ID del t\u00e9rmino:<\/p>\n<table class=\"table table-responsive\">\n<thead>\n<tr>\n<th>Taxonom\u00eda<\/th>\n<th>Clave del metadato<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Categor\u00edas (<code>category<\/code>) y categor\u00edas de productos (<code>product_cat<\/code>) en los productos de WooCommerce<\/td>\n<td><code>_seopress_robots_primary_cat<\/code> (sin cambios)<\/td>\n<\/tr>\n<tr>\n<td>Cualquier otra taxonom\u00eda, desde SEOPress 10.4<\/td>\n<td><code>_seopress_robots_primary_term_{taxonomy}<\/code>, por ejemplo <code>_seopress_robots_primary_term_genre<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Estas claves est\u00e1n disponibles en la API REST de WordPress (campo <code>meta<\/code> de la entrada). Con WPML, el t\u00e9rmino principal se copia en las traducciones y se convierte al t\u00e9rmino traducido. Cuando <a href=\"https:\/\/www.seopress.org\/es\/soporte\/guias\/importar-metadatos-de-publicaciones-y-terminos-de-yoast-seo-a-seopress\/\">importas tus datos desde Yoast SEO<\/a>, tambi\u00e9n se importa el t\u00e9rmino principal de cada taxonom\u00eda.<\/p>\n<p>Para leer el t\u00e9rmino principal en tu propio c\u00f3digo:<\/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\n\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>Antes de SEOPress 10.4, algunos sitios guardaban el t\u00e9rmino de otra taxonom\u00eda en <code>_seopress_robots_primary_cat<\/code> (importaci\u00f3n CSV, API REST o filtro <code>seopress_primary_category_list<\/code>). SEOPress sigue leyendo ese valor para esa taxonom\u00eda hasta que guardes un t\u00e9rmino principal para ella.<\/p>\n<h2>Para desarrolladores: filtros<\/h2>\n<p>A\u00f1ade estos fragmentos al archivo <code>functions.php<\/code> de tu tema hijo o a un <a href=\"https:\/\/www.seopress.org\/es\/soporte\/guias\/como-crear-un-complemento-mu-debe-usar-complemento\/\">plugin must-use<\/a>.<\/p>\n<h3>Elegir las taxonom\u00edas que ofrecen un t\u00e9rmino principal<\/h3>\n<p>El filtro <code>seopress_primary_term_taxonomies<\/code> recibe las taxonom\u00edas que ofrecen un selector (un array de objetos <code>WP_Taxonomy<\/code> indexado por nombre) y el tipo de contenido. Para quitar una taxonom\u00eda:<\/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>O para a\u00f1adir una taxonom\u00eda no jer\u00e1rquica, como las etiquetas de las entradas. Su selector se ofrece en la pesta\u00f1a <strong>Avanzado<\/strong> de la metabox SEO:<\/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>Filtrar los t\u00e9rminos ofrecidos<\/h3>\n<p>El filtro <code>seopress_primary_term_list<\/code> recibe los t\u00e9rminos ofrecidos, el nombre de la taxonom\u00eda y la entrada. Por ejemplo, para no ofrecer nunca \u00abSin categor\u00eda\u00bb:<\/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>El antiguo filtro <code>seopress_primary_category_list<\/code> sigue funcionando, solo para las categor\u00edas y las categor\u00edas de productos. Solo recibe los t\u00e9rminos.<\/p>\n<h3>Ocultar el selector en la caja de la taxonom\u00eda<\/h3>\n<p>Devuelve <code>false<\/code> en el filtro <code>seopress_primary_term_inline_selector<\/code> para quitar el selector de la caja de la taxonom\u00eda, en el editor de bloques y en el editor cl\u00e1sico. Recibe el valor actual, el nombre de la taxonom\u00eda y el tipo de contenido. Un t\u00e9rmino principal ya guardado sigue funcionando, y la pesta\u00f1a <strong>Avanzado<\/strong> de la metabox SEO sigue ofreciendo el selector.<\/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>M\u00e1s informaci\u00f3n en nuestra p\u00e1gina dedicada a este hook: <a href=\"https:\/\/www.seopress.org\/es\/soporte\/hooks\/ocultar-el-desplegable-de-categoria-principal-en-la-pantalla-de-edicion-de-entradas\/\">ocultar el desplegable de categor\u00eda principal en la pantalla de edici\u00f3n de entradas<\/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-25997","documentation","type-documentation","status-publish","documentation_type-guias","product-seopress-pro"],"acf":[],"permalink_manager":null,"_links":{"self":[{"href":"https:\/\/www.seopress.org\/es\/wp-json\/wp\/v2\/documentation\/25997","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.seopress.org\/es\/wp-json\/wp\/v2\/documentation"}],"about":[{"href":"https:\/\/www.seopress.org\/es\/wp-json\/wp\/v2\/types\/documentation"}],"version-history":[{"count":2,"href":"https:\/\/www.seopress.org\/es\/wp-json\/wp\/v2\/documentation\/25997\/revisions"}],"predecessor-version":[{"id":25999,"href":"https:\/\/www.seopress.org\/es\/wp-json\/wp\/v2\/documentation\/25997\/revisions\/25999"}],"wp:attachment":[{"href":"https:\/\/www.seopress.org\/es\/wp-json\/wp\/v2\/media?parent=25997"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}