修复WooCommerce分类描述移至产品下方后分页消失问题

我用以下代码将WooCommerce产品分类描述移至页面底部，优先展示产品：

add_action('woocommerce_archive_description', 'custom_archive_description', 2 );
function custom_archive_description(){
    if( is_product_category() ) :
        remove_action('woocommerce_archive_description', 'woocommerce_taxonomy_archive_description', 10 );
        add_action( 'woocommerce_after_main_content', 'woocommerce_taxonomy_archive_description', 5 );
    endif;
}

这段代码在分类首页可正常生效，但切换至同一分类的下一页时，描述区域会消失。需要修复此问题，确保所有分类页面（含分页）的产品分类描述均能正常显示。

解决方案 #

问题根源在于原代码依赖的woocommerce_archive_description钩子在分页页面的执行逻辑存在局限，改用template_redirect钩子即可解决，该钩子会在所有页面（包括分页）加载时触发。

替换后的代码：

add_action('template_redirect', 'custom_move_category_description');
function custom_move_category_description() {
    // 匹配所有产品分类页面（含分页）
    if ( is_product_category() ) {
        // 移除默认的描述展示钩子
        remove_action('woocommerce_archive_description', 'woocommerce_taxonomy_archive_description', 10);
        // 将描述添加到主内容区域之后
        add_action('woocommerce_after_main_content', 'woocommerce_taxonomy_archive_description', 5);
    }
}

说明 #

• template_redirect钩子确保代码在每个页面加载时都能执行，覆盖分页场景；
• is_product_category()在分页页面仍会返回true，能准确匹配所有产品分类相关页面；
• 保留原优先级设置，保证描述显示在预期位置。

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