Productos relacionados sólo de la subcategoría actual en WooCommerce

Por defecto, los productos relacionados que aparecen en las fichas de producto con WooCommerce, se muestran de forma automática y aleatoria en función de la categoría y etiquetas del producto en el que estemos.

En otro artículo, veíamos como cambiar algunas de las características de estos productos relacionados, como modificar el número de productos, las columnas, o desactivar que se relacionaran por etiqueta y/o categoría.

Hoy vamos a ver otra duda muy común y es que se muestren sólo como relacionados los productos de la misma subcategoría del actual.

Aunque se pueden encontrar muchos códigos y snippets por la red, a mi sólo me han funcionado dos formas de hacerlo, una modificando el hook woocommerce_product_related_posts y otra, modificando el template related.php y subiéndolo a nuestro theme hijo.

Opción 1: modificando woocommerce_product_related_posts

En principio sería la forma más correcta de hacerlo, y de todos los snippets que he probado sólo hay uno que me funciona correctamente que os pongo a continuación:

// Obtener productos relacionados de la misma subcategoria
add_filter( 'woocommerce_product_related_posts', 'esl_productos_relacionados' );
function esl_productos_relacionados($product){
    global $woocommerce;
    // Related products are found from category and tag
    $tags_array = array(0);
    $cats_array = array(0);
    // Get tags
    $terms = wp_get_post_terms($product->id, 'product_tag');
    foreach ( $terms as $term ) $tags_array[] = $term->term_id;
    // Get categories
    $terms = wp_get_post_terms($product->id, 'product_cat');
    foreach ( $terms as $key => $term ){
        $check_for_children = get_categories(array('parent' => $term->term_id, 'taxonomy' => 'product_cat'));
        if(empty($check_for_children)){
            $cats_array[] = $term->term_id;
        }
    }
    // Don't bother if none are set
    if ( sizeof($cats_array)==1 && sizeof($tags_array)==1 ) return array();
    // Meta query
    $meta_query = array();
    $meta_query[] = $woocommerce->query->visibility_meta_query();
    $meta_query[] = $woocommerce->query->stock_status_meta_query();
    $meta_query   = array_filter( $meta_query );
    // Get the posts
    $related_posts = get_posts( array(
            'orderby'        => 'rand',
            'posts_per_page' => $limit,
            'post_type'      => 'product',
            'fields'         => 'ids',
            'meta_query'     => $meta_query,
            'tax_query'      => array(
                'relation'      => 'OR',
                array(
                    'taxonomy'     => 'product_cat',
                    'field'        => 'id',
                    'terms'        => $cats_array
                ),
                array(
                    'taxonomy'     => 'product_tag',
                    'field'        => 'id',
                    'terms'        => $tags_array
                )
            )
        ) );
    $related_posts = array_diff( $related_posts, array( $product->id ), $product->get_upsells() );
    return $related_posts;
}

Este snippet de código deberás añadirlo al archivo functions.php de tu tema hijo, en un plugin para snippets de código o en un plugin personalizado.

Opción 2: modificar la plantilla related.php

Si por alguna razón el código anterior no te funcionara bien, otra opción es modificar el archivo de plantilla related.php para cambiar la query o la consulta a la base de datos que  muestra estos productos relacionados.

Este archivo se encuentra en la carpeta wp-content/plugins/woocommerce/templates/single-product/related.php y deberemos descargarlo, modificarlo y subirlo a wp-content/themes/nuestro-child-theme/woocommerce/single-product/related.php

(Fíjate que hemos de reproducir la misma estructura de carpetas/subcarpetas pero omitiendo /templates)

En este archivo, sustituiremos el contenido por el siguiente:

if (!defined('ABSPATH')) {
    exit;
}
global $post, $product;
if (empty($product) || !$product->exists()) {
    return;
}
$subcategories_array = array(0);
$all_categories = wp_get_post_terms($product->id, 'product_cat');
foreach ($all_categories as $category) {
    $children = get_term_children($category->term_id, 'product_cat');
    if (!sizeof($children)) {
    $subcategories_array[] = $category->term_id;
    }
}
if (sizeof($subcategories_array) == 1) {
    return array();
}
$args = array(
    'orderby' => 'rand',
    'posts_per_page' => 3,
    'post_type' => 'product',
    'fields' => 'ids',
    'meta_query' => $meta_query,
    'tax_query' => array(
    array(
        'taxonomy' => 'product_cat',
        'field' => 'id',
        'terms' => $subcategories_array
    )
    )
);
 
$wp_query = new WP_Query($args);
 
 
 if ($wp_query->have_posts()):
    ?>
    <section class="related products">
    <h2><?php esc_html_e('Related products', 'woocommerce'); ?></h2>
    <?php woocommerce_product_loop_start(); ?>
    <?php while ($wp_query->have_posts()) : $wp_query->the_post(); ?>
        <?php
        global $post, $product;
        $post_object = get_post($product->get_id());
        setup_postdata($GLOBALS['post'] = & $post_object);
        wc_get_template_part('content', 'product');
        ?>
    <?php endwhile; ?>
    <?php woocommerce_product_loop_end(); ?>
    </section>
    <?php
endif;

wp_reset_postdata();

En este ejemplo, el post_per_page está en 3, son el número de productos relacionados que aparecerán, y podemos modificarlo por el que queramos.

Como indicaba antes, ambas formas son válidas, pero yo recomiendo utilizar la primera a menos que no nos funcione y no logremos detectar el porqué.

Recuerda que en este artículo: Modificar los productos relacionados en WooCommerce, tienes otros cambios más sencillos si sólo quieres que no se relacionen por etiquetas o categorías o cambiar el número de productos que aparecen.