Cómo mostrar solo la categoría principal en el bucle de entradas de WordPress

En WPBeginner entendemos que crear una jerarquía bien estructurada de categorías y subcategorías puede mejorar la experiencia del usuario y el SEO.

Por defecto, la mayoría de los temas de WordPress listarán todas las categorías asociadas a una entrada.

Sin embargo, uno de nuestros lectores nos ha preguntado si es posible mostrar solo la categoría principal dentro del bucle de entradas y excluir las categorías secundarias. Quieren centrar la atención de sus visitantes en el debate más amplio de cada entrada en lugar de una jerarquía compleja.

En este artículo, le mostraremos cómo utilizar un fragmento de código para modificar el bucle de entradas de WordPress y mostrar solo la categoría principal en una sola entrada.

Cuándo mostrar solo la categoría principal en WordPress

Muchos propietarios de sitios web utilizan categorías principales y secundarias para estructurar sus sitios web.

Por ejemplo, un blog de viajes puede tener destinos organizados por categorías en las que cada región es una categoría principal y las ciudades son categorías secundarias.

Del mismo modo, un blog de comida puede publicar recetas organizadas en categorías padre e hijo. Por ejemplo, una categoría padre podría ser el tipo de cocina, y una categoría hija podría ser el tipo de plato.

Ahora, la mayoría de los temas de WordPress utilizan la etiqueta de plantilla_category () para listar todas las categorías asociadas a una entrada.

Esta función es eficiente, pero mostrará todas las categorías alfabéticamente e ignorará por completo la relación padre/hijo.

Dicho esto, echemos un vistazo a cómo cambiar este comportamiento y mostrar solo la categoría padre en el bucle de WordPress.

Mostrar solo la categoría principal en el bucle de entradas de WordPress

Para este tutorial, necesitará editar los archivos de su tema de WordPress. Si no has hecho esto antes, entonces marca / comprueba nuestro artículo sobre cómo copiar y pegar fragmentos de código en WordPress.

En primer lugar, debes añadir un código al archivo functions. php de tu tema o utilizar un plugin de fragmentos de código. Recomendamos usar WPCode porque te permite añadir código sin romper tu sitio, y su validación inteligente de fragmentos de código te ayuda a prevenir errores comunes de código.

Obtenga más información en nuestra guía sobre cómo añadir código personalizado en WordPress sin romper su sitio.

Para este tutorial, utilizaremos la versión gratuita de WPCode. Aunque no tiene todas las características avanzadas de la versión completa, viene con todo lo necesario para los primeros pasos.

Lo primero que tienes que hacer es instalar y activar el plugin WPCode. Si necesitas ayuda, puedes seguir nuestra guía paso a paso sobre cómo instalar un plugin de WordPress.

Una vez activado, puedes ir a la página WPCode ” Nuevo fragmento de código

Se abrirá una página en la que podrá crear un fragmento de código personalizado.

En primer lugar, debe añadir un título al fragmento de código. Después, puede copiar y pegar el siguiente fragmento de código en el panel Vista previa del código.

function wpb_get_parent_terms($taxonomy = 'category')
{
    $currentPost = get_post();
    $terms       = get_the_terms($currentPost->ID, $taxonomy);

    if (is_wp_error($terms)) {
        /** @var \WP_Error $terms */
        throw new \Exception($terms->get_error_message());
    }

    $map = array_map(
        function ($term) use ($taxonomy) {
            return '<a href="' . esc_url(get_term_link($term->term_id,
                    $taxonomy)) . '" title="' . esc_attr($term->name) . '">
                ' . $term->name . '
                </a>';
        },
        array_filter($terms, function ($term) {
            return $term->parent == 0;
        })
    );

    return implode(', ', $map);
}

A continuación, debe seleccionar la opción “Fragmento de código PHP” en el menú desplegable Tipo de código y activar el conmutador Inactivo.

Por último, asegúrate de hacer clic en el botón “Guardar fragmento de código” para establecer los ajustes.

Este código simplemente crea una nueva función wpb_get_parent_terms(). Por defecto, esta función solo mostrará las categorías padre.

A continuación, debe colocar esta función en los archivos de su tema de WordPress donde desee mostrar sólo la categoría principal.

Para averiguar en qué archivo de plantilla debe fijarse, consulte nuestra hoja de trucos para principiantes sobre la jerarquía de plantillas de WordPress.

Básicamente, estará buscando la etiqueta de plantilla the_category(); dentro del bucle de WordPress. Una vez que la haya encontrado, deberá sustituirla por el siguiente código:

<?php wpb_get_parent_terms(); ?> 

Este código mostrará sólo su categoría principal.

Si tiene varias categorías que son categorías principales o independientes, también se mostrarán todas esas categorías.

El fragmento de código funcionará también para el resto de taxonomías. Por ejemplo, las categorías de productos de WooCommerce o cualquier taxonomía personalizada que pueda tener.

Basta con modificar el código de la siguiente manera:

<?php wpb_get_parent_terms( 'product_cat '); ?>

Este código mostrará las categorías de productos para una tienda WooCommerce.

También mostrará solo las categorías principales o independientes de un producto.

Si desea mostrar una taxonomía personalizada, sustituya product_cat por el nombre de su taxonomía personalizada.

Guías de expertos para mostrar categorías en WordPress

Ahora que ya sabe cómo mostrar solo la categoría principal de sus entradas en WordPress, puede que le interese ver otras guías relacionadas con la visualización de categorías en WordPress:

• Cómo mostrar solo la categoría hija en el bucle de entradas de WordPress
• Cómo mostrar subcategorías en páginas de categorías en WordPress
• Cómo mostrar descripciones de categorías en WordPress
• Cómo cambiar el orden de las categorías en WordPress
• Cómo mostrar entradas recientes de una categoría específica en WordPress
• Cómo mostrar / ocultar categorías en WordPress (Guía definitiva)
• Cómo mostrar categorías vacías en los widgets de WordPress
• Cómo cambiar el estilo de las categorías individuales en WordPress
• Cómo ocultar o estilizar sus subcategorías en WordPress
• Cómo añadir imágenes de taxonomía (iconos de categoría) en WordPress

Esperamos que este artículo te haya ayudado a aprender cómo mostrar solo la categoría principal de tus entradas en WordPress. Puede que también quieras ver nuestra guía sobre cómo mostrar campos personalizados fuera del bucle o nuestra selección experta del mejor software de chatbot de IA para tu sitio web.

If you liked this article, then please subscribe to our YouTube Channel for WordPress video tutorials. You can also find us on Twitter and Facebook.