WooCommerce商品分类描述显示问题：需置于分页与商品列表之间

问题 #

需在商品分类页面的分页下方、商品列表上方显示商品分类描述，按常规教程修改模板后未生效。

已尝试操作 #

• 编辑子主题Active7的archive-product.php文件，添加以下代码：

if ( is_product_category() ) : ?>
    <div class="category-description">
        <?php 
        echo term_description(); // Display the product category description 
        ?>
    </div>
<?php endif; 

• 添加调试信息确认archive-product.php是否加载，无输出；确认处于正确商品分类页面，描述仍未显示。

环境 #

The7主题的子主题Active7

排查与解决方案 #

1. 确认The7的商品分类模板文件 #

The7主题通常会用自定义模板处理商品分类页面，而非默认的archive-product.php：

• 检查子主题路径Active7/woocommerce/taxonomy-product_cat.php是否存在该文件
• 若存在，直接修改此文件；若不存在，从父主题The7/woocommerce/taxonomy-product_cat.php复制到子主题对应路径后再修改

2. 精准放置代码 #

在模板中找到分页输出代码（通常是woocommerce_pagination()或类似函数），在其下方、商品循环代码（如if ( have_posts() ) :）上方插入你的分类描述代码：

<?php if ( is_product_category() ) : ?>
    <div class="category-description">
        <?php echo term_description(); ?>
    </div>
<?php endif; ?>

3. 清除缓存 #

• 清空WordPress后台的缓存插件（若有）
• 强制刷新浏览器页面（Ctrl+F5），避免缓存导致修改未生效

4. 验证分类描述内容 #

进入WordPress后台 → 商品 → 商品分类，确认目标分类的描述栏已填写内容，且未被隐藏。

5. 替代方案：用钩子函数（无需修改模板） #

若不想改动模板，可在子主题的functions.php中添加以下代码，通过WooCommerce钩子控制输出位置：

add_action( 'woocommerce_after_main_content', 'display_category_description_between_pagination_and_products', 15 );
function display_category_description_between_pagination_and_products() {
    if ( is_product_category() ) {
        $description = term_description();
        if ( $description ) {
            echo '<div class="category-description">' . $description . '</div>';
        }
    }
}

可根据实际页面结构调整钩子优先级数值（当前设为15，确保在分页之后、商品列表之前输出）。

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