求助：实现WooCommerce商品分类名称与缩略图循环展示（仿文章循环）

原代码存在的问题 #

• 误用WP_Query查询商品分类：WP_Query用于查询文章/产品，查询分类应使用get_terms
• 循环条件错误：$loop->has_category()是判断文章所属分类的方法，不能用来遍历分类列表
• 无效调用产品方法：遍历分类时无需$product对象，$product->get_categories()只会输出当前产品的分类，不符合需求
• 链接未输出：get_category_link()需要配合echo才能生成有效链接

修正后的代码 #

<?php
// 获取所有商品分类，可按需调整参数
$product_categories = get_terms(array(
    'taxonomy' => 'product_cat',
    'orderby' => 'name',
    'hide_empty' => false, // true则隐藏无产品的分类，false显示所有
    'number' => 0, // 0表示获取全部
));

// 检查是否有分类
if (!empty($product_categories) && !is_wp_error($product_categories)):
    foreach ($product_categories as $term): ?>
        <!-- 分类项 -->
        <li class="p-item">
            <a href="<?php echo esc_url(get_term_link($term)); ?>">
                <?php
                // 获取分类缩略图ID
                $thumbnail_id = get_term_meta($term->term_id, 'thumbnail_id', true);
                if ($thumbnail_id):
                    // 输出缩略图，'ihossain'为自定义图片尺寸
                    echo wp_get_attachment_image($thumbnail_id, 'ihossain', false, array('alt' => $term->name));
                else:
                    // 无缩略图时显示默认图片
                    ?>
                    <img src="<?php echo esc_url(get_template_directory_uri() . '/img/icon_category_image_1.svg'); ?>" 
                         alt="<?php echo esc_attr($term->name); ?>" />
                <?php endif; ?>
                <h6 class="icon-title"><?php echo esc_html($term->name); ?></h6>
            </a>
        </li>
        <!-- 分类项结束 -->
    <?php endforeach;
endif;
?>

代码说明 #

• get_terms：专门用于获取分类/标签等分类法的项，参数可根据需求调整（比如hide_empty控制是否显示空分类）
• get_term_link：生成分类的归档页面链接，配合esc_url确保链接安全
• get_term_meta：获取分类的自定义元数据，WooCommerce分类缩略图存储在thumbnail_id元字段中
• wp_get_attachment_image：输出图片标签，自动处理图片属性，比直接拼接img标签更安全规范
• esc_html/esc_attr：对输出的文本进行转义，避免XSS安全问题

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