如何完全替换WooCommerce存档/分类/标签产品循环？适配疑问

1. 彻底替换WooCommerce原生产品循环 #

你当前代码的问题在于仅移除了部分循环钩子，但原生产品循环的核心逻辑（如archive-product.php内的while (have_posts())）仍在执行。要彻底替换，需移除核心循环钩子、阻止原生循环运行，同时确保自定义循环继承WooCommerce的查询规则（分页、排序、筛选等）。

修改后的完整代码如下：

<?php
// 主题启用WooCommerce支持
add_action('after_setup_theme', 'custom_theme_add_woocommerce_support');
function custom_theme_add_woocommerce_support()
{
    add_theme_support('woocommerce', array(
        'thumbnail_image_width' => 200,
        'single_image_width'    => 500,
    ));
    add_theme_support('wc-product-gallery-zoom');
    add_theme_support('wc-product-gallery-lightbox');
    add_theme_support('wc-product-gallery-slider');
}

// 移除原生循环的核心钩子
remove_action( 'woocommerce_before_shop_loop', 'woocommerce_product_loop_start', 40 );
remove_action( 'woocommerce_after_shop_loop', 'woocommerce_product_loop_end', 40 );
remove_action( 'woocommerce_shop_loop', 'woocommerce_template_loop_product', 10 );

// 阻止原生循环的内容输出
add_filter( 'woocommerce_product_loop', '__return_empty_string' );

// 添加自定义产品循环
add_action( 'woocommerce_before_shop_loop', 'my_custom_product_loop', 40 );
function my_custom_product_loop() {
    // 继承WooCommerce默认循环参数（包含分页、排序、当前分类/标签筛选等）
    $loop_args = array_merge(
        wc_get_loop_args(),
        array(
            // 可自定义覆盖参数，比如修改每页显示数量
            // 'posts_per_page' => 12,
        )
    );

    $loop = new WP_Query( $loop_args );

    if ( $loop->have_posts() ) {
        // 自定义循环容器
        echo '<div class="my-custom-loop">';
        
        while ( $loop->have_posts() ) : $loop->the_post();
            // 自定义产品项结构
            echo '<div class="my-custom-product-loop-item">';
            echo '<div class="product-image">' . get_the_post_thumbnail() . '</div>';
            echo '<h3 class="product-title">' . get_the_title() . '</h3>';
            echo '<div class="product-price">' . wc_get_product_price_html( get_the_ID() ) . '</div>';
            echo '<a href="' . get_permalink() . '" class="product-link">查看详情</a>';
            echo '</div>';
        endwhile;
        
        echo '</div>';

        // 输出WooCommerce默认分页
        woocommerce_pagination();
    } else {
        // 复用WooCommerce无产品提示模板
        wc_get_template( 'loop/no-products-found.php' );
    }

    wp_reset_postdata();
}

关键改动说明：

• 用wc_get_loop_args()继承原生查询参数，确保自定义循环兼容分页、排序、筛选功能
• 通过woocommerce_product_loop过滤器直接阻止原生循环内容输出
• 移除原生循环的启动/结束钩子，完全用自定义容器替代

2. 自定义循环在分类和标签模板的生效问题 #

只要自定义循环使用wc_get_loop_args()构建查询参数，就会自动继承当前页面的分类、标签筛选条件，因此在产品分类、标签页面会自动生效，显示对应分类/标签下的产品。

如果之前硬写WP_Query参数（仅指定post_type => product），会忽略当前分类/标签的筛选逻辑，导致显示所有产品。使用wc_get_loop_args()可以完美解决这个问题，它会自动获取当前页面的查询上下文（如分类ID、标签ID、排序规则等）。

内容的提问来源于stack exchange，提问作者Alipvd